docs-sync-checker
Documentation Sync Checker Skill
Deterministic 4-phase drift detector that compares the filesystem against README entries. Each phase (Scan, Cross-Reference, Detect, Report) has a gate that must pass before proceeding. The skill produces a sync score (percentage of tools properly documented) and actionable fix suggestions for every detected issue.
This skill checks presence, absence, and version alignment only -- it does not judge description quality, generate documentation content, resolve merge conflicts, validate cross-references, or track when drift occurred. Suggested fixes use YAML descriptions verbatim; content generation and quality assessment require different skills.
Optional flags: --auto-fix (experimental, requires explicit opt-in), --strict (exit code 1 on issues), --format json (machine-readable output for CI/CD).
Reference Loading Table
| Signal | Load These Files | Why |
|---|---|---|
| documentation work | documentation-structure.md |
Loads detailed guidance from documentation-structure.md. |
| example-driven tasks | examples.md |
Loads detailed guidance from examples.md. |
| tasks related to this reference | integration-guide.md |
Loads detailed guidance from integration-guide.md. |
| tasks related to this reference | markdown-formats.md |
Loads detailed guidance from markdown-formats.md. |
| tasks related to this reference | sync-rules.md |
Loads detailed guidance from sync-rules.md. |
More from notque/claude-code-toolkit
generate-claudemd
Generate project-specific CLAUDE.md from repo analysis.
12fish-shell-config
Fish shell configuration and PATH management.
12pptx-generator
PPTX presentation generation with visual QA: slides, pitch decks.
12codebase-overview
Systematic codebase exploration and architecture mapping.
10image-to-video
FFmpeg-based video creation from image and audio.
9data-analysis
Decision-first data analysis with statistical rigor gates.
9