Updated
Agent skills for technical writers
Agent skills for technical writers
Technical writers turn specs and code into documentation that someone can actually follow. Skills help with the three places where that work gets hard: structure, style, and review.
API and reference docs
A reference-doc skill produces consistent API or schema documentation from the source. It enforces the structure — parameters, types, examples, error cases — so every endpoint is documented the same way, regardless of who wrote it or when.
The win is completeness. A hand-written reference drifts as the code changes; a skill-based one makes the omissions visible because every entry follows the same template.
Style consistency
Technical docs live or die on consistency: one term for one concept, one format for commands, one voice for instructions. A style skill encodes those rules and applies them during drafting, so the writer reviews exceptions instead of enforcing the baseline by hand.
Reviewing against a checklist
A doc-review skill checks a draft the way a code reviewer checks a PR: every heading matches its content, every command is copy-pasteable, every step has a verifiable result, and nothing assumes knowledge the reader hasn't been given yet.
What a doc-review skill checks
A useful review skill walks a fixed list:
- Every heading matches the content beneath it.
- Every command is copy-pasteable and in the right order.
- Every step has a verifiable result the reader can confirm.
- Nothing assumes knowledge the reader hasn't been given yet.
Run that list against your next draft and the gaps become obvious before a reader finds them.
Why this fits skills so well
Documentation is procedural by nature — there's a correct shape for a reference, a procedure, and a concept page. A skill captures that shape once and applies it consistently, which is precisely the discipline that keeps a docs site from becoming a pile of one-off pages.
Where to go next
The catalog's technical writer skills cover reference docs, style, and review. Pair a reference-doc skill with a style skill for a complete authoring loop.