Skill Creator

Use this skill when creating or updating repo-local skills under .agents/skills/. Generated .claude/skills content is managed by agent-skills-nix and must not be edited or committed.

Workflow

1. Decide whether a skill is needed. Add one only when repeated repo work needs specialized workflow, local references, command sequences, or policy that should trigger on demand.
2. Create or update .agents/skills/<skill-name>/SKILL.md with YAML frontmatter and concise Markdown instructions.
3. Keep SKILL.md focused on core workflow and navigation. Move detailed examples, APIs, or long checklists into references/ files linked directly from SKILL.md.
4. Add scripts under scripts/ only for deterministic or repeated operations that are better executed than rewritten.
5. Update the root AGENTS.md Skill Routing list when adding a repo-local skill that agents should discover before work.
6. Keep skill and reference files below the line budgets in this guide.
7. Let the Nix dev shell refresh generated local agent skill targets through its shell hook.
8. Run just fmt after edits and use the normal repo validation level for the change.

Local Skill Management

Repo-local skills are the source of truth under .agents/skills. The .claude/skills directory is generated by agent-skills-nix through the Nix dev-shell hook, ignored by Git, and should not be used as an edit target.