DO

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.zip

Installs 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.
219 charsno explicit “when” trigger
Intermediate

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

You give it
Documentation request with document type, target audience, user's goal, and scope
You get back
Well-formatted Markdown documentation following a detailed outline

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.

SkillInstallsUpdatedSafetyDifficulty
documentation-writer (this skill)07moNo flagsIntermediate
docs-write229moNo flagsBeginner
content-research-writer151yNo flagsBeginner
doc-coauthoring1611moNo flagsBeginner

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.).

22139

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.

15111

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.

1686

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.

694

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.

591

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/.

665

Search skills

Search the agent skills registry