| name | skills-sync |
| description | Sync first-party projections and manifest-managed third-party skills; check monthly for gog CLI and upstream skill updates. |
Skills Sync
Keep first-party skills live-linked and third-party skills reproducible. The
repository-local ./setup CLI owns first-party projection.
skills-sources.yml owns reviewed providers, commits, and allowlists;
src/third-party-skills-cli.ts owns lock generation, restore, and integrity.
The pinned skills CLI remains the copy installer behind that owner.
Read references/third-party-skills.md for
registry operations. For official gog skills and the monthly CLI check, read
references/gog-skills.md.
For Matt Pocock skills, read
references/mattpocock-skills.md.
Rules
- Before any Setup action,
cd "$HOME/code/claude-code-config" and invoke
./setup; never resolve setup through PATH.
- Edit canonical source under
skills/<id>/ only; never generated projections
in ~/.claude/skills/ or ~/.agents/skills/.
- Machine reads pass
--json.
- Never invoke third-party package mutation directly. Use
bun run skills/skills-sync/src/third-party-skills-cli.ts.
- Removed selections use previewed
prune before lock regeneration; its hash
gates protect locally changed copies. Execution requires an explicit scope.
Workflow
- After any first-party skill change:
./setup sync --check --json.
- Clean check after content-only edits: done — live projections carry content.
- After add, rename, or remove, or when asked to sync: .
