ai-docs

Solid

Manages the documentation lifecycle: CHANGELOG, README, solution-intent architecture docs, external docs portals, and documentation quality gates. Auto-invoked by /ai-pr. Trigger for 'update the changelog', 'the README is stale', 'document this feature', 'docs portal needs updating', 'did we document all changes'. Not for blog or pitch content; use /ai-prose instead. Not for marketing collateral; use /ai-marketing instead.

AI & Automation 52 stars 3 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
57
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Documentation ## Purpose Unified documentation skill covering the full project documentation lifecycle. Seven handlers manage changelogs, READMEs, solution intent documents, external documentation portals, and documentation quality verification. ## When to Use - Changelog needs updating after code changes -> `changelog` - README files need updating to reflect project state -> `readme` - New project needs a solution intent document -> `solution-intent-init` - Architectural changes require solution intent sync -> `solution-intent-sync` - Pre-release or periodic health check on solution intent -> `solution-intent-validate` - External documentation portal needs updating -> `docs-portal` - Verify all documentation outputs cover semantic changes -> `docs-quality-gate` - Automatically invoked by `/ai-pr` via parallel subagent dispatch ## Process 1. **Detect handler** from arguments: one of the 7 handlers listed below 2. **Check gate** -- read `documentation.auto_update` flags from `.ai-engineering/manifest.yml` 3. **Execute handler** -- follow the matching handler in `handlers/` 4. **Report** -- present summary of actions taken ## Routing Table | Argument | Handler | Gate Flag | | -------------------------- | -------------------------------------- | ------------------------------------------- | | `changelog` | `handlers/changelog.md` | `documentation.auto_update...

Details

Author
arcasilesgroup
Repository
arcasilesgroup/ai-engineering
Created
4 months ago
Last Updated
4 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category