docsync
от suhteevah
PDF & DocumentsКратко
Auto-generate docs from code and detect documentation drift via git hooks.
Описание
Что делает этот навык
DocSync generates documentation from source code using tree-sitter for AST parsing across 11 languages. It detects documentation drift, finding where code changed but docs were not updated, and can install git hooks to enforce updates on every commit. Free tier covers one-shot doc generation; Pro and Team tiers add drift detection, auto-fix, onboarding guides, and architecture docs.
All parsing and license validation happen locally with no network calls, so it works in air-gapped environments and never sends source code to external servers.
Когда его использовать
- Generating a README after writing a new TypeScript library
- Checking if API docs are stale after a refactor
- Blocking commits when critical documentation is missing
- Creating an onboarding guide for engineers joining a large codebase
- Finding undocumented functions added over the past sprint
Пример сценария
User asks: Check if my docs are up to date in the src/ directory
- 1
Validates Pro license key from config
- 2
Parses all source files in src/ with tree-sitter to extract symbols, signatures, and exports
- 3
Compares extracted symbols against existing documentation files
- 4
Identifies new undocumented symbols, changed signatures with stale docs, and deleted symbols still referenced in docs
- 5
Outputs a drift report with severity levels: critical, warning, and info
Drift report listing every out-of-sync documentation item by file, symbol, and severity level
Требования
- DOCSYNC_LICENSE_KEY environment variable
- Paid license from docsync.pages.dev (Pro: $29/user/month, Team: $49/user/month) — required for drift detection, hooks, auto-fix, onboarding, and architecture commands
Установка
clawhub install suhteevah/docsyncВыполните команду CLI или вставьте промпт в Claude Code, Cursor, Codex — любой кодинг-агент, которым пользуетесь.