Technical Writing Agent Skills for Docs
Technical writing skills help an agent produce documentation a specific reader can actually use. The work starts with the need, not the prose: a tutorial walks a newcomer through one successful path, a how-to guide gives the shortest reliable procedure to someone who already knows the goal, reference material stays complete and consistent for lookup, and explanation covers context and tradeoffs so a reader can reason about the subject. Editing and review tighten accuracy, terminology, and readability before anything ships, while information design decides what belongs where so the whole doc set stays navigable. Use the ranked list by matching your task to one of these needs first, then pick the skill whose description names that need and the deliverable you want. If two look close, prefer the one that matches your reader's starting knowledge.
8 to start with36 top options
Start with these.
Technical writing is the craft of turning specialist knowledge into text a specific reader can use: first choose the need, then structure, draft, and review for accuracy.
These are the closest matches for this work. Start with the first one and open it to install.
- Rank 01View Agent SkillDirect
technical-writing
House style for technical documents covering structure, truth and sourcing rules, and banned constructions, routing to document-type skills.
12,920 · popularity - Rank 02View Agent SkillDirect
documentation-writer
Diátaxis-based technical writing expert that creates tutorials, how-to guides, reference, and explanation docs with a clarify-outline-generate workflow.
27,149 · popularity - Rank 03View Agent SkillDirect
reviewing-technical-prose
Reviews, rewrites, and edits technical prose with severity mapping, findings format, and a delivery checklist.
12,600 · popularity - Rank 04View Agent SkillDirect
documentation
Writes and maintains technical documentation across READMEs, API docs, runbooks, architecture docs, and onboarding guides.
9,914 · popularity - Rank 05View Agent SkillDirect
wiki-page-writer
OfficialGenerates rich technical documentation pages with dark-mode Mermaid diagrams, source code citations, and first-principles depth. Use when writing documentation, generating wiki pages, creating technical deep-dives, or documenting specific components or systems.
- Rank 06View Agent SkillDirect
docs-guard
Reviews generated or changed documentation, verifying every referenced symbol and code sample against the source and catching docs-vs-code drift.
3,683 · popularity - Rank 07View Agent SkillDirect
writing-guidelines
OfficialReview docs/prose for Writing Guidelines compliance. Use when asked to "review my docs", "check writing style", "audit prose", "review docs voice and tone", or "check this page against the writing handbook".
- Rank 08View Agent SkillDirect
write-feature-docs
Drafts a complete documentation page for a new feature from its spec, verifying claims against the codebase and opening a docs PR.
18,197 · popularity
Explore 28 more Agent Skills
- Rank 09View Agent SkillDirect
documenting-contracts
Documents HTTP APIs, message payloads, DTOs, file formats, and webhooks with a DTO-first catalog and wire-type detail levels.
12,091 · popularity - Rank 10View Agent SkillDirect
writing-runbooks
Writes operational documentation such as runbooks, setup guides, and migration guides with risk legends and symptom-first troubleshooting.
12,422 · popularity - Rank 11View Agent SkillDirect
documenting-legacy-codebases
Documents existing under-documented codebases by surveying surfaces, grounding claims in code, and building a trusted docs tree.
12,292 · popularity - Rank 12View Agent SkillDirect
code-documenter
Generates and validates technical documentation including docstrings, OpenAPI specs, JSDoc, doc portals, and user guides.
5,284 · popularity - Rank 13View Agent SkillDirect
hads
Defines the Human-AI Document Standard for writing and validating Markdown technical documentation readable by both humans and AI.
6,170 · popularity - Rank 14View Agent SkillDirect
typescript-docs
Generates TypeScript documentation using JSDoc, TypeDoc, and ADRs with framework-specific patterns.
4,049 · popularity - Rank 15View Agent SkillPossible
diagramming-processes
Diagrams business processes, lifecycles, and interactions using ArchiMate and PlantUML with source-in-version-control rules.
12,136 · popularity - Rank 16View Agent SkillPossible
writing-design-docs
Writes proposals, RFCs, design docs, and specs with a proposal skeleton and Why & What decision boxes.
12,513 · popularity - Rank 17View Agent SkillPossible
readme-blueprint-generator
Generates a comprehensive README.md by analyzing repository documentation and copilot-instructions files.
9,607 · popularity - Rank 18View Agent SkillPossible
comment-code-generate-a-tutorial
Refactors a Python script, adds instructional comments, and generates a beginner-friendly markdown tutorial.
8,852 · popularity - Rank 19View Agent SkillPossible
spring-boot-openapi-documentation
Generates REST API documentation using SpringDoc OpenAPI 3.0 and Swagger UI in Spring Boot applications.
3,858 · popularity - Rank 20View Agent SkillPossible
writing-changelogs
Writes changelog entries, release notes, and handover summaries with honesty conventions.
12,419 · popularity - Rank 21View Agent SkillPossible
architecture-decision-records
Patterns for writing and maintaining Architecture Decision Records capturing context, decision, and consequences.
19,354 · popularity - Rank 22View Agent SkillPossible
article-writing
Writes long-form articles, guides, tutorials, and newsletters in a distinctive voice with structure and evidence rules.
11,090 · popularity - Rank 23View Agent SkillPossible
changelog-generator
Creates user-facing changelogs from git commits, categorizing changes and translating them into customer-friendly release notes.
7,008 · popularity - Rank 24View Agent SkillPossible
writing-plans
NotableUse when you have a spec or requirements for a multi-step task, before touching code
- Rank 25View Agent SkillPossible
writing-beats
NotableWriting, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
351,944 · popularity - Rank 26View Agent SkillPossible
writing-shape
NotableWriting, exploit: shape raw material into an article, paragraph by paragraph.
351,444 · popularity - Rank 27View Agent SkillPossible
ux-writing
NotableWrite or review UI copy (buttons, errors, empty states, microcopy) with a voice and tone system.
- Rank 28View Agent SkillPossible
spec-driven-implementation
Drives a spec-first workflow by writing PRODUCT.md and TECH.md before implementation and keeping them current.
27,755 · popularity - Rank 29View Agent SkillPossible
jupyter-notebook
OfficialUse when the user asks to create, scaffold, or edit Jupyter notebooks (`.ipynb`) for experiments, explorations, or tutorials; prefer the bundled templates and run the helper script `new_notebook.py` to generate a clean starting notebook.
- Rank 30View Agent SkillPossible
writing-skills
NotableUse when creating new skills, editing existing skills, or verifying skills work before deployment
- Rank 31View Agent SkillPossible
writing-for-agents
NotableWriting documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
272,220 · popularity - Rank 32View Agent SkillPossible
human-writing
Notable通用中文创作与改稿 Skill。用于知乎回答、论坛长帖、公众号文章、博客、评论、人物故事、历史叙事、新闻与行业解读、科普、教程、评测、个人叙事、小说、故事、对白、口播和演讲稿。默认写成一个见过事、查过材料、愿意把来龙去脉讲清楚的人在说话，重点保留中文互联网长回答与长帖的活人感和自然中文韵律，避免空泛的机构腔、喊口号式演说腔、营销腔和模型腔。非虚构长文先检查材料够不够，材料不足时研究、追问或缩短，绝不用重复解释灌字数。现实内容额外核验事实、引语、数据与用户亲历，虚构内容可以创造人物、场景、对白、心理与情节。成稿正文严禁冒号、破折号、“不是……而是……”及同类翻案句，并清除商业黑话和模型惯用黑话。不创建作者画像、个人规则库或个人写作 Skill。
- Rank 33View Agent SkillPossible
domain-modeling
Builds and sharpens a project's domain model, writing CONTEXT.md glossaries and ADRs.
777,796 · popularity - Rank 34View Agent SkillPossible
microsoft-docs
OfficialUnderstand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention "docs." If the question is about understanding a concept rather than writing code, this is the right skill.
- Rank 35View Agent SkillPossible
platform-docs-get
Retrieves official Salesforce documentation from Salesforce-owned domains for grounding answers.
6,231 · popularity - Rank 36View Agent SkillDirect
doc-coauthoring
OfficialGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
What this topic covers
Each sub-topic groups Agent Skills for a specific situation.
- Tutorials
- Write a lesson that walks a newcomer through one successful path.
- How-to guides
- Write the shortest reliable procedure for a reader who already knows the goal.
- Reference
- Write complete, consistent lookup material rather than a narrative.
- Explanation
- Write the context and tradeoffs so a reader can reason about the subject.
- Editing & review
- Tighten accuracy, terminology, and readability before anything ships.
- Information design
- Decide what belongs where so the set of docs is navigable as a whole.
Frequently asked questions
- How is this list ordered?
- It is ranked by observed search demand. Direct matches to the topic come first, and any single publisher is capped so one source cannot fill the page.
- Which sub-topic should I start with?
- Start from the reader's need. A newcomer needs a tutorial, someone who knows the goal needs a how-to guide, lookup work needs reference, and reasoning about tradeoffs needs explanation.
- Can one skill cover drafting and review?
- Editing and review is treated as its own sub-topic alongside drafting-oriented work. If you need accuracy, terminology, and readability checked before shipping, look for a skill that names that step.
- Where does information design fit?
- Information design decides what belongs where so the set of docs is navigable as a whole. Reach for it when the problem is structure across documents rather than the wording inside one.
How to install an Agent Skill
Start with the first skill on this page. Claude Code reads a SKILL.md once it is in the skills directory:
- Claude Code — copy the SKILL.md for technical-writing into ~/.claude/skills/technical-writing/ for yourself, or .claude/skills/technical-writing/ to share it with a project.
- From the registry — run npx skills add riekelt/technical-writer@technical-writing.
- Or download technical-writing from its source and place that SKILL.md in the directory above.
How to choose Check the source and the skill’s own instructions before you install. Official and Notable describe where a skill comes from.