write-docs
Write AI-scannable technical documentation.
$ 安裝
git clone https://github.com/michalvavra/agents /tmp/agents && cp -r /tmp/agents/skills/write-docs ~/.claude/skills/agents// tip: Run this command in your terminal to install the skill
SKILL.md
name: write-docs description: Write AI-scannable technical documentation.
Write Documentation
Documentation that is scannable, consistent, and actionable for AI agents.
Structure
- Max 150 lines per file, one concept per file
- Start with
description:in YAML frontmatter - Add TL;DR section at top with most-needed info
Content
- No duplicates (define once, link elsewhere)
- Use tables for structured data (parameters, config)
- Concrete examples for everything (copy-pasteable)
- Link to real code as templates
Naming
| Pattern | Use For | Example |
|---|---|---|
README.md | Directory overview | docs/README.md |
{noun}.md | Reference | entities.md |
{verb}-{noun}.md | How-to | add-entity.md |
Tips
- Use consistent terms (one term per concept)
- Group by task ("How to add X") not system ("X overview")
- Include troubleshooting for common errors
