docs-synclisted
Install: claude install-skill erclx/toolkit
# Docs sync
Read these files from the project root in parallel:
- `standards/prose.md`: prose conventions for all generated text
- `standards/readme.md`: README structure, required sections, and content rules
## Context
Run these commands in parallel:
- `git diff --cached main -- . ':(exclude)*.lock' ':(exclude)*-lock.json' 2>/dev/null || echo "NO_DIFF"`
- `git diff --cached --name-only main 2>/dev/null || echo "NO_FILES"`
- `git status --short 2>/dev/null || echo "NO_STATUS"`
## Guards
- If `git diff --cached main` output is empty and `git status --short` output is empty, stop: `❌ No changes since main. Nothing to sync.`
## Discovery
Discover docs dynamically. Do not hardcode paths:
- Glob `README.md` at project root
- Glob `docs/**/*.md`
Read each discovered file in parallel.
## Analysis
For each discovered doc, classify as one of:
- `stale`: the diff touches something the doc describes
- `unrelated`: no overlap between diff and doc content
Classify at the section level, not the file level. A doc edited earlier in the session can still be partially stale. For each diff surface, verify the corresponding section is synced.
## Action
Rewrite only the stale sections. Do not touch sections unrelated to the diff. Write the updated file immediately after the preview. Claude Code's tool permission dialog is the confirmation gate. Do not wait for user input.
## Response format
### Preview
**Changes since main:** `<n>` files
**Docs discovered:** `<list>`
| Doc