docs-synclisted
Install: claude install-skill yusufkaracaburun/ai-kit
# /ai:docs-sync
Standalone content-drift surface for ai-kit. Stays focused on *content correctness* — install + catalog health live in `/ai:hygiene`.
## How it runs
```bash
bash "${CLAUDE_PLUGIN_ROOT}/bin/ai-kit-docs-sync.sh" [path] [--skip-dead-links] [--no-prompt]
```
The driver runs each section in order, prints a per-section header, and exits with the max section exit code (`0 clean` / `1 findings`).
`--no-prompt` is automatic when stdin is not a TTY (CI, eval framework, pipes).
## Sections
### finished-work — local merged branches / closable issues
Two sub-checks, both read-only by default:
1. **Local merged branches.** `git branch --merged <default>`. Default branch detected via `git remote show origin` HEAD, falling back to `master` then `main`. The default branch itself, `HEAD`, and the currently-checked-out branch are always excluded.
2. **Closable issues.** For each recently merged PR (`gh pr list --state merged --limit 50`), extract `closes #N` / `fixes #N` / `resolves #N` from the body via strict regex (case-insensitive verb, NO fuzzy match for `addresses #N` / `see #N` / `for #N`). If the referenced issue is still `OPEN`, it counts as closable.
Fix flow (strictest guardrails per #88 — destructive + visible to others):
- **Local branch delete** → group-confirmable: `git branch -d <name>` per branch. `-d` refuses to delete unmerged branches as a safety net.
- **Remote branch delete** → **always individual y/N per branch**: `git push origin --delete <name