sync-docs

Scan project documentation for inconsistencies with the codebase and output a prioritized task list.

1|Updated Feb 28, 2026

Search Tags:#automation #documentation #codebase #adr #tasks #docs #quality-assurance

Ready to run

npx skills add https://github.com/im9/inboil --skill sync-docs-im9

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sync-docs
Source: https://github.com/im9/inboil/tree/main/.claude/skills/sync-docs
Command: npx skills add https://github.com/im9/inboil --skill sync-docs-im9

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Check documentation in the codebase for inconsistencies with the actual implementation and ADRs, then fix discrepancies to align docs with code.

Core Features & Use Cases

Scan docs/ai/ specifications, ADRs, and site documentation for mismatches against the codebase.
Generate a TodoWrite-style task list with concrete fixes and owners to close gaps.
Apply fixes to documentation and ADR statuses to maintain alignment, preserving existing styles.

Quick Start

Use the sync-docs skill to scan all relevant docs, compare them to code, and produce a list of required edits.

Frequently Asked Questions about sync-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I check documentation for inconsistencies with my codebase?▼

To check documentation inconsistencies with your codebase, scan project docs, ADRs, and site documentation against the actual implementation. This process identifies mismatches and outputs a prioritized task list with concrete fixes and designated owners.

What is the best way to keep documentation aligned with code changes automatically?▼

Keeping documentation aligned with code changes involves scanning docs/ai specs and ADRs against the codebase, then applying fixes to match the implementation while preserving existing stylistic conformance. This enforces continuous documentation quality assurance.

How do I track and update ADR statuses to match current implementation?▼

Tracking ADR statuses requires scanning Architecture Decision Records against the codebase to detect outdated decisions. The scan guides updates to ADR statuses, aligning them with the current implementation and enforcing stylistic conformance.

Can I generate a task list for fixing documentation mismatches in my project?▼

Yes, you can generate a task list for fixing documentation mismatches by scanning project documentation against the codebase. It produces a TodoWrite-style prioritized list with concrete fixes and assigned owners to close gaps.

Does automated documentation scanning preserve existing documentation styles?▼

Automated documentation scanning preserves existing styles when applying fixes to documentation and ADR statuses. It aligns docs with the implementation while enforcing stylistic conformance to maintain formatting consistency.