doc-sync
Verify IdeaVim docs match code changes
Documentation often drifts after code updates and creates broken examples for users. This skill provides a structured workflow to compare docs against working code and identify discrepancies.
Download the skill ZIP
Upload in Claude
Go to Settings → Capabilities → Skills → Upload skill
Toggle on and start using
Test it
Using "doc-sync". Check README.md for outdated mappings examples
Expected outcome:
- Found two examples with removed parameters in the mappings section
- README.md should reference the new MappingScope name instead of old name
- No other issues detected in the README file
Using "doc-sync". Verify doc/ideavim-api.md after the 2.0 release
Expected outcome:
- Identified 5 API signatures that changed in release 2.0
- 3 parameter names in examples need updating to match new signatures
- 1 code block uses a deprecated method that was removed
Using "doc-sync". Check if CONTRIBUTING.md matches current git workflow
Expected outcome:
- All git commands in CONTRIBUTING.md match current branch workflow
- No discrepancies found between documented steps and actual git behavior
Security Audit
SafeAll 35 static findings are FALSE POSITIVES. The static analyzer misidentified markdown documentation text as security threats. SKILL.md is pure documentation containing workflow instructions and example bash commands shown as documentation - no executable code exists. The skill-report.json already correctly assessed this as safe with no risk factors.
Risk Factors
🌐 Network access (1)
📁 Filesystem access (1)
⚙️ External commands (18)
Quality Score
What You Can Build
Post-release audit
Confirm documentation reflects recent API changes after a release cycle completes.
Doc review before PR
Validate examples and parameter names before submitting documentation update changes.
Regression triage
Check whether reported documentation issues correspond to real API changes in code.
Try These Prompts
Check doc/ideavim-mappings.md against current code and list any mismatches found.
I changed MappingScope.kt. Identify affected documentation and propose specific updates.
Audit all files in doc/ for outdated examples and summarize findings in a report.
Validate all examples using map(), nmap(), and vmap() against current API signatures in code.
Best Practices
- Start with a working implementation to establish ground truth before comparing docs
- Prioritize removed or renamed API elements when checking for documentation drift
- Keep updates minimal and aligned with existing documentation style and terminology
Avoid
- Updating wording when the underlying behavior is still accurate
- Skipping verification of named parameters in code examples
- Assuming documentation is correct without checking working implementation