documentation-writer
A documentation specialist that categorizes writing into tutorials, how-to guides, references, and explanations.
Install
mkdir -p .claude/skills/documentation-writer && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/16842" && unzip -o skill.zip -d .claude/skills/documentation-writer && rm skill.zipInstalls to .claude/skills/documentation-writer
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.Key capabilities
- →Create tutorials for new users
- →Develop how-to guides for specific problems
- →Write reference documentation for technical descriptions
- →Generate explanations for complex topics
- →Ensure documentation clarity and accuracy
- →Maintain consistent terminology and style
How it works
This skill acknowledges and clarifies documentation requests, proposes a detailed outline based on the Diátaxis framework, and then generates content in Markdown.
Inputs & outputs
When to use documentation-writer
- →Writing API reference documentation
- →Creating a technical tutorial
- →Structuring how-to guides for users
- →Drafting system explanations
About documentation-writer
Guides documentation production using the Diátaxis framework to ensure clarity and user-centric results. It mandates that every document serves a specific purpose, prioritizing accuracy and consistent terminology for technical software projects.
Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.
When not to use it
- →When the request is for content to be copied from existing markdown files without explicit instruction
- →When external websites or sources need to be consulted without a provided link and instruction
- →When the user does not want to follow the Diátaxis Framework principles
Limitations
- →Requires explicit clarification of document type, target audience, user's goal, and scope
- →Does not copy content from provided markdown files unless explicitly instructed
- →Does not consult external websites or sources without a provided link and instruction
How it compares
This workflow strictly adheres to the Diátaxis Framework, ensuring each document serves a distinct purpose and follows specific guiding principles, unlike general content creation.
Compared to similar skills
documentation-writer side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| documentation-writer (this skill) | 0 | 7mo | No flags | Intermediate |
| docs-write | 22 | 9mo | No flags | Beginner |
| content-research-writer | 15 | 1y | No flags | Beginner |
| doc-coauthoring | 16 | 11mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
docs-write
metabase
Write documentation following Metabase's conversational, clear, and user-focused style. Use when creating or editing documentation files (markdown, MDX, etc.).
content-research-writer
ComposioHQ
Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.
doc-coauthoring
anthropics
Guide 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.
research-grants
davila7
Write competitive research proposals for NSF, NIH, DOE, and DARPA. Agency-specific formatting, review criteria, budget preparation, broader impacts, significance statements, innovation narratives, and compliance with submission requirements.
teams-channel-post-writer
daymade
Creates educational Teams channel posts for internal knowledge sharing about Claude Code features, tools, and best practices. Applies when writing posts, announcements, or documentation to teach colleagues effective Claude Code usage, announce new features, share productivity tips, or document lessons learned. Provides templates, writing guidelines, and structured approaches emphasizing concrete examples, underlying principles, and connections to best practices like context engineering. Activates for content involving Teams posts, channel announcements, feature documentation, or tip sharing.
write-docs
tldraw
Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.