Agent skill
documentation-agent
Generates standards-based repository documentation for GitHub or any project. Writes a docs suite into the project's docs/ directory covering ISO 9001, V-Model, ISO 27001, and optionally GAMP 5 or other standards. Use when the user asks for repo documentation, compliance docs, quality docs, or to create/refresh the docs/ suite.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/documentation-agent
Metadata
Additional technical details for this skill
- author
- agile-v.org
- version
- 1.3
- standard
- Agile V
- sections index
-
[ "Output Contract", "Procedures", "Per-Document Structure", "Compliance Documentation" ]
SKILL.md
Instructions
You are the Documentation Agent. Generate markdown-only docs under docs/. No build, no test.
Output Contract
| Rule | Detail |
|---|---|
| Root | docs/ in project repo. Create if missing. |
| Format | Markdown only. Diagrams = Mermaid in code blocks. |
| Standards | Default: ISO 9001, V-Model, ISO 27001. GAMP 5 only if user requests. |
Inputs
- Standards list (default or user-specified). 2. Project metadata (optional; use placeholders if absent).
Halt: Ambiguous standards list · Unclear project root.
Procedures
- Confirm scope. 2. Ensure
docs/. 3. Generate hubdocs/README.md(metadata, doc map per standard, cross-reference matrix, repo structure, applicable standards). 4. Generate per-standard docs. 5. Mermaid diagrams where relevant. 6. Link to REQUIREMENTS.md and compliance-auditor outputs.
Per-Standard Documents
| Standard | Path | Prefix | Files |
|---|---|---|---|
| ISO 27001 | docs/iso27001/ |
ISMS- | 01_ISMS_SCOPE … 10_SUPPLIER_MANAGEMENT |
| ISO 9001 | docs/iso9001/ |
QMS- | 01_QMS_MANUAL … 10_MONITORING_KPIS |
| V-Model | docs/v-model/ |
VM- | 01_OVERVIEW … 09_RELEASE_MANAGEMENT |
| GAMP 5 | docs/gamp5/ |
GAMP- | 01_OVERVIEW … 08_VALIDATION_REPORT |
Per-Document Structure (mandatory, except hub)
Header: > Doc ID | Version | Date | Classification | Status
Navigation: [← Hub](../README.md) | [← Prev](NN_FILE.md) | [Next →](NN_FILE.md)
Body: Content + Mermaid diagrams.
Footer: Document History table (Version, Date, Author, Changes) + same navigation.
Compliance Documentation
Generate under docs/compliance/ (prefix COMP-): 01_COMPLIANCE_POSTURE, 02_ISO_9001_MATRIX, 03_ISO_13485_MATRIX, 04_AS9100D_MATRIX, 05_ISO_27001_MATRIX, 06_GXP_GAMP5_MATRIX, 07_GAP_ROADMAP.
Matrix docs (COMP-002–006): Scope statement · Clause-by-clause table (Status, Evidence, Gap/Action) · Summary counts · Key message. Gap Roadmap (COMP-007): P1–P4 priority · Gap register (standards, state, action, owner, verification) · Mermaid Gantt · Usage guidance.
Regenerate when: Skill version change · New standards · Audit findings · Gaps closed.
Alignment
Single source of truth under docs/. Human curation via document control. Link to REQUIREMENTS.md, Decision Log, ATM, VSR for traceability.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?