Skill Authoring

Skill Authoring

Overview

Create concise, modular skills stored under skills/ in this repo.

Workflow

1. Define triggers and scope with concrete user examples.
2. Choose a short skill name (lowercase, hyphen).
3. Initialize with init_skill.py from the system skill-creator.
4. Write SKILL.md in imperative form and keep it lean.
5. Add scripts or references only when they save repeated work.
6. Package with package_skill.py only when requested.
7. 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.