Skip to content

Technical Writer

Caution

Technical documentation agent that reads codebases, API schemas, and architecture docs to produce clear developer-facing documentation.

By Anthropic 7,800 v1.4.0 Updated 2026-03-10

Install

Claude Code

Copy the SKILL.md file to your project's .claude/skills/ directory

About This Skill

Technical Writer is a documentation skill that reads your codebase and produces clear, well-structured technical documentation. It understands code patterns, API contracts, and system architecture to generate docs that actually match your implementation rather than generic templates.

How It Works

  1. Codebase analysis — Scans project structure, reads key source files, and identifies public APIs, configuration options, and extension points
  2. Pattern recognition — Detects framework conventions (Express routes, React components, CLI flags) to apply appropriate documentation patterns
  3. Content generation — Writes documentation with accurate code examples, parameter descriptions, and return value specifications
  4. Cross-referencing — Links related sections, adds see-also references, and builds a coherent navigation structure
  5. Style consistency — Follows established documentation style guides (Google, Microsoft, or project-specific) for consistent voice and formatting

Best For

  • Open source projects needing contributor documentation
  • Internal APIs that lack formal documentation
  • Teams migrating from tribal knowledge to written docs
  • Projects preparing for public release

Use Cases

  • API reference documentation from OpenAPI specs
  • Architecture decision records (ADRs)
  • Developer onboarding guides
  • Library and SDK usage documentation
  • Runbook and troubleshooting guides

Pros & Cons

Pros

  • + Reads actual code to produce accurate documentation
  • + Follows industry documentation style guides
  • + Generates working code examples from real source
  • + Supports multiple output formats (Markdown, RST, HTML)

Cons

  • - Code examples should be tested before publishing
  • - May miss undocumented business logic nuances
  • - Complex architectural concepts may need human editorial review

Related AI Tools

Related Skills

Stay Updated on Agent Skills

Get weekly curated skills + safety alerts

每周精选 Skills + 安全预警