reviewing-documentation
Use when reviewing documentation quality, auditing README or CLAUDE.md files, or standardizing AI instruction files.
Best use case
reviewing-documentation is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Use when reviewing documentation quality, auditing README or CLAUDE.md files, or standardizing AI instruction files.
Teams using reviewing-documentation should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/reviewing-documentation/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How reviewing-documentation Compares
| Feature / Agent | reviewing-documentation | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Use when reviewing documentation quality, auditing README or CLAUDE.md files, or standardizing AI instruction files.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
# Documentation Review Skill ## Documentation Categories 6 categories: Accuracy (Critical), Clarity (Major), Completeness (Major), Consistency (Minor), Examples (Critical), Structure (Major). See docs agent files for checklists. ## AI Instruction File Standardization Checks placement and cross-references for `.ai/AI-AGENT-INSTRUCTIONS.md`, `CLAUDE.md`, `.github/copilot-instructions.md`. See `references/ai-instruction-templates.md`. ## Scope Prioritization - README.md (project entry point) - CLAUDE.md (AI assistant instructions) - docs/getting-started.md or similar - API documentation - AI instruction files ## False Positives **Documentation-specific** - do NOT flag: - Intentionally simplified examples (marked as such) - Placeholder values (`your-api-key`, `example.com`) - Version-specific docs with version clearly noted - Pseudocode marked as illustrative ## Pattern References - `references/ai-instruction-templates.md` - AI instruction templates ### README.md Required Sections 1. **Title/Description** - name, one-paragraph description, key features 2. **Installation** - prerequisites with versions, step-by-step, verification 3. **Quick Start** - minimal working example, expected output 4. **Configuration** - required env vars, config format, defaults 5. **API/CLI Reference** - commands/methods, parameters, return values 6. **Contributing** - bug reports, PR process, code style 7. **License** **Anti-patterns**: assuming global deps, non-working examples, missing prerequisites, outdated screenshots ### Severity Calibration Missing Install section: Critical (blocks users). Missing error responses in API docs: Major. Missing Contributing: Suggestion (not blocking). ### API Documentation Required per endpoint: all params with types, all response codes, at least one example, error responses. ### Consistency Patterns One term per concept (not "config/conf/settings"). Consistent heading case, list punctuation, code language tags, link style throughout.
Related Skills
writing-documentation
Creates technical documentation including READMEs, API references, user guides, architecture docs, ADRs, and runbooks. Use for requests to create, write, generate, or draft documentation. Trigger phrases include "document this", "write docs", "create readme", "API reference", "user guide", "architecture docs", "ADR", "runbook". For updating existing READMEs, use updating-readme instead.
speckit-documentation-engineer.agent
Expert documentation engineer specializing in technical documentation, API docs, developer guides, and documentation-as-code. Creates maintainable, searchable documentation that developers actually use.
research-documentation
Searches across your Notion workspace, synthesizes findings from multiple pages, and creates comprehensive research documentation saved as new Notion pages. Trigger on "노션 검색", "조사해줘", "리서치 정리". For meeting prep use meeting-intelligence; for saving knowledge use knowledge-capture; for spec breakdown use spec-to-implementation.
quality-documentation-manager
Document control system management for medical device QMS. Covers document numbering, version control, change management, and 21 CFR Part 11 compliance. Use for document control procedures, change control workflow, document numbering, version management, electronic signature compliance, or regulatory documentation review.
documentation-templates
Documentation templates and structure guidelines. README, API docs, code comments, and AI-friendly documentation.
documentation-structure-validator
Validate documentation structure, check for missing sections, verify markdown syntax, ensure consistency with templates. Use when user mentions docs validation, structure check, README review, documentation quality, or wants to verify documentation completeness.
documentation-standards
Clear technical documentation with JSDoc, READMEs, Mermaid diagrams, ISMS policy references, and comprehensive code examples
documentation-specialist
文档专家。专注于技术文档编写、API 文档生成、README 优化和文档维护。提供清晰的文档结构、规范的格式和用户友好的内容。
documentation-research
Enforces documentation research before implementation. Auto-loads when implementing features to ensure current best practices are followed. Researches official docs first.
documentation
Technical writing, API docs, and documentation best practices
Documentation Hygiene
This skill should be used when the user asks to perform "documentation hygiene", "update docs for change", "mark historical docs", "add deprecation headers", "documentation migration", or when making significant changes that affect multiple documentation files (like license migrations, tier changes, or API changes).
documentation-guidelines
Write or update backend feature documentation that follows a repo's DOCUMENTATION_GUIDELINES.md (or equivalent) across any project. Use when asked to create/update module docs, API contracts, or backend documentation that must include architecture, endpoints, payloads, Mermaid diagrams, and seeding instructions.