skillshare-update-docs

1Sync website documentation with recent code changes. $ARGUMENTS specifies scope: a command name (e.g., `install`), commit range, or omit to auto-detect from `git diff HEAD~1`.
2 
3**Scope**: This skill updates `website/docs/`, the built-in skill (`skills/skillshare/`), and `README.md`. It does NOT write Go code (use `implement-feature`) or CHANGELOG (use `changelog`).
4 
5Before acting, run `python3 scripts/ai-context.py documentation`. That topic is the source of truth for documentation ownership, code cross-validation and verification; this skill retains the update workflow.
6 
7## Workflow
8 
9### Step 1: Detect Changes
10 
11```bash
12# Auto-detect recently changed code
13git diff HEAD~1 --stat -- cmd/skillshare/ internal/
14 
15# Also check for structural changes that affect concept/reference docs
16git diff HEAD~1 --stat -- internal/config/targets.yaml internal/audit/rules.yaml
17```
18 
19Map changed files to affected documentation using this guide:
20 
21**Command docs** (`website/docs/reference/commands/`):
22- `cmd/skillshare/<cmd>.go` → `website/docs/reference/commands/<cmd>.md`
23- Flag changes, new subcommands, output format changes
24 
25**Concept docs** (`website/docs/understand/`):
26- `internal/audit/` → `understand/audit-engine.md`
27- `internal/sync/` → `understand/sync-modes.md`, `understand/source-and-targets.md`
28- `internal/install/tracked.go` → `understand/tracked-repositories.md`
29- `internal/config/` → `understand/declarative-manifest.md`
30…