Help us improve
Share bugs, ideas, or general feedback.
From documentation-plugin
Scans .claude/ directories for skills, commands, and agents, extracts metadata, compares to existing CLAUDE.md files, and updates documentation by adding missing entries, removing stale ones, and fixing counts.
npx claudepluginhub laurigates/claude-plugins --plugin documentation-pluginHow this skill is triggered — by the user, by Claude, or both
Slash command
/documentation-plugin:docs-syncsonnetThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Scan the codebase for skills, commands, and agents, then update all documentation to reflect the current state. Fixes count mismatches, adds missing entries, and removes stale references.
Indexes and syncs Claude skills, agents, rules, and markdown docs via status reports, init tagging, and scans of global/project/file/folder scopes.
Synchronizes project docs (CLAUDE.md, README.md, architecture.md) with code state via quality scoring (0-100), gap analysis, skill/ADR audits using git log, and change reports. Use for doc-code alignment.
Enforces README.md consistency with actual skills, agents, and commands counts using bash verification and pytest tests. Activates on doc updates, commits, or skill work.
Share bugs, ideas, or general feedback.
Scan the codebase for skills, commands, and agents, then update all documentation to reflect the current state. Fixes count mismatches, adds missing entries, and removes stale references.
/docs:sync # Sync all documentation
/docs:sync --scope skills # Only sync skill documentation
/docs:sync --scope commands # Only sync command documentation
/docs:sync --scope agents # Only sync agent documentation
/docs:sync --dry-run # Show what would change without modifying
/docs:sync --verbose # Show detailed scanning output
--scope <type> - Limit sync to specific type: skills, commands, agents, or all (default)--dry-run - Preview changes without modifying files--verbose - Show detailed progress during scanningExecute this documentation sync workflow:
Scan source directories:
# Skills
find .claude/skills -name "SKILL.md" -type f
# Commands
find .claude/commands -name "*.md" -type f ! -name "CLAUDE.md"
# Agents
find .claude/agents -name "*.md" -type f
Extract metadata from each item:
name and descriptiondescription from frontmatter, infer namespace from pathname, description, toolsParse existing documentation:
.claude/skills/CLAUDE.md - Current skill catalog with categories.claude/skills/CLAUDE.md - Command reference with namespacesCLAUDE.md - Summary counts and highlightsCompare actual vs documented:
Categorize new items:
For skills, determine category by:
ux-*, git-*, python-* → matching categoryFor user-invocable skills, determine namespace from directory name:
skills/git-commit/SKILL.md → git: namespaceskills/handoffs/SKILL.md → Root levelFor agents, determine domain from description keywords
Identify documentation sections to update:
**N skills**, N total, (N skills)Update counts throughout documentation:
**63 skills** or 63 specialized skills### Core Development (9 skills)Add new items to appropriate sections:
Skills catalog format:
### Category Name (N skills)
- **skill-name** - Description from SKILL.md frontmatter
Command table format:
| Namespace | Commands | Purpose |
| `/command` | Description | Usage context |
Agent inventory format:
| Agent | Purpose | Key Tools |
| **agent-name** | Description | Tool1, Tool2 |
Remove stale entries that no longer exist in codebase
Update cross-references:
Generate summary of changes:
## Documentation Sync Report
### Skills
- ✅ Added N new skills to catalog
- skill-name → Category Name
- ✅ Removed N stale skills
- ✅ Updated skill count: OLD → NEW
### Commands
- ✅ Added N new commands
- /namespace:command → Description
- ✅ Updated command counts
### Agents
- ✅ Added N new agents
- agent-name → Domain
- ✅ Updated agent inventory
### Files Modified
- path/to/file.md (N changes)
### Manual Review Needed
- item-name: Could not determine category
.claude/skills/CLAUDE.md - Skills catalog.claude/skills/CLAUDE.md - Commands referenceCLAUDE.md (root) - Repository overviewREADME.md - Project READMEdocs/ directory content| Pattern | Category |
|---|---|
ux-*, accessibility-*, design-* | UX & Accessibility |
git-*, github-* | Version Control & GitHub |
python-*, uv-*, ruff-* | Python Development |
typescript-*, nodejs-*, vitest-* | TypeScript/JavaScript |
rust-*, cpp-*, embedded-* | Systems Languages |
container-*, kubernetes-*, helm-*, terraform-* | Infrastructure & DevOps |
test-*, playwright-*, mutation-* | Testing & Quality |
agent-*, multi-agent-* | Meta & Coordination |
Determined by skill directory name prefix:
skills/git-*/SKILL.md → git: namespaceskills/docs-*/SKILL.md → docs: namespaceskills/*/SKILL.md (no prefix) → Root level skillsdocs: conventional commit prefix# After adding new skills
/docs:sync --dry-run
# Review output, then apply
/docs:sync
# Commit the documentation updates
git add .claude/
git commit -m "docs: sync documentation with new UX implementation features"
/docs:generate for generating new documentationrelease-please-protection for automated versioning/project:new or major feature additions