Create, review, and refactor project documentation (README, AGENTS.md, architecture docs, runbooks, API docs) with deep codebase analysis, clear markdown structure, and diagrams/user flows. Use when asked to write or improve docs, audit existing documentation for accuracy or quality, generate diagrams/flows, or assess agent-first docs like AGENTS.md/PLANS.md for freshness and completeness.
4.3
Rating
0
Installs
Documentation
Category
The skill provides a well-structured overview with clear decision gates and workflow steps for documentation tasks. The description is comprehensive enough for a CLI agent to understand when to invoke it. However, the skill suffers from significant novelty concerns—most documentation tasks (writing markdown, reviewing docs, creating simple diagrams) can be handled efficiently by a base CLI agent without specialized tooling. The referenced files (doc-audit-and-workflow.md, markdown-templates.md, diagram-templates.md) would provide task knowledge, but the core value proposition is unclear: templates and checklists don't justify a dedicated skill when agents can generate these on-demand. The skill would be more valuable if it integrated specialized tools (doc linters, automated drift detection, codebase-to-doc sync tools) or handled genuinely complex documentation architectures that require many tokens or specialized domain knowledge. As described, it appears to be primarily a collection of templates and best practices rather than a capability that meaningfully reduces agent cost or complexity.
majiayu000
Skill Author
Loading SKILL.md…
