skills/CLAUDE.md

Skills are organized into bucket folders under skills/:

• engineering/ — daily code work
• productivity/ — daily non-code workflow tools
• misc/ — kept around but rarely used
• personal/ — tied to my own setup, not promoted
• in-progress/ — drafts not yet ready to ship
• deprecated/ — no longer used

Every skill in engineering/, productivity/, or misc/ must have a reference in the top-level README.md and an entry in .claude-plugin/plugin.json. Skills in personal/, in-progress/, and deprecated/ must not appear in either.

Each skill entry in the top-level README.md must link the skill name to its SKILL.md.

Each bucket folder has a README.md that lists every skill in the bucket with a one-line description, with the skill name linked to its SKILL.md. Bucket README.mds and the top-level README.md group entries into User-invoked and Model-invoked.

Every promoted skill also has a human-facing docs page at docs/<skill-name>.md. When you add, rename, or change the behaviour of a skill in engineering/, productivity/, or misc/, create or re-sync its docs page following .agents/writing-docs.md.

Every SKILL.md is either user-invoked (disable-model-invocation: true, reachable only by the human) or model-invoked (model- or user-reachable). See .agents/invocation.md.

To (re)link every skill into the local harness skill directories (~/.claude/skills, ~/.agents/skills), run scripts/link-skills.sh. Each entry is a symlink into this repo, so a git pull keeps installed skills current; re-run the script after adding, removing, or renaming a skill.