What problem does it solve?
After code changes in the swiss-ai-hub monorepo, documentation spread across READMEs, CLAUDE.md files, skills, agents, and VitePress docs often falls out of sync, leading to broken references, outdated instructions, and wasted developer time.
Core Features & Use Cases
- Multi-scope documentation scanning: Automatically identifies all 5 core documentation locations affected by code changes, including project READMEs, scope-level READMEs, CLAUDE.md files, Claude skill definitions, agent configs, and VitePress docs.
- Staleness detection and correction: Catches outdated file paths, renamed APIs, removed features, and missing documentation, updating files to match current code while preserving each file's existing style and detail level.
- Post-update validation: Runs spot-checks to ensure no stale path references remain in updated documentation.
- Use case: After modifying an API controller in the packages/api scope, this skill automatically updates the corresponding README, CLAUDE.md, related scaffold skills, and platform VitePress docs to reflect the new endpoint structure.
Quick Start
Use the update-doc skill to sync all documentation across the swiss-ai-hub monorepo after you complete any code change that affects documented behavior.