| name | skill-authoring |
| description | Create or update project-specific skills in this repo. Use when asked to make new skills, modularize workflows, or build skill packs for this codebase. |
Skill Authoring
Overview
Create concise, modular skills stored under skills/ in this repo.
Workflow
- Define triggers and scope with concrete user examples.
- Choose a short skill name (lowercase, hyphen).
- Initialize with
init_skill.pyfrom the system skill-creator. - Write SKILL.md in imperative form and keep it lean.
- Add scripts or references only when they save repeated work.
- Package with
package_skill.pyonly when requested. - Run the QA harness to generate matrices and results templates.
References
- Skill template:
references/skill_template.md - QA checklist:
references/qa_checklist.md - QA matrix template:
references/qa_matrix_template.md
QA Harness
- Generate QA artifacts:
python3 scripts/skill_qa_harness.py - Overwrite existing outputs:
python3 scripts/skill_qa_harness.py --force
Local Conventions
- Prefer small, single-purpose skills plus an orchestrator.
- Put reusable commands in scripts; keep references one hop from SKILL.md.
- Avoid extra docs (README, changelog, etc.).
- Add honesty guardrails when a skill can produce overconfident outputs.
- Add acceptance criteria sections so QA can be objective.
- Use repo-relative paths in skill lists (AGENTS.md) for portability.