skills-engineering
Installation
SKILL.md
Skills Engineering
This skill teaches an agent how to author, evaluate, and iteratively improve Agent Skills. It follows a rigorous TDD lifecycle with nine phases. Each phase has one job. Each phase's output feeds the next phase's red state.
Do not reference this file for phase instructions. Call scripts/generate.sh — the script output is the guidance.
Phase routing
| # | Phase | TDD state | Job |
|---|---|---|---|
| 1 | spec | — | Declare intent, boundaries, and script contracts in spec.md |
| 2 | behavioral | Red | Write BDD contracts: Given X, When skill activates, Then agent does Y |
| 3 | script-test | Red | Write acceptance tests for every script before the scripts exist |
| 4 | script | Green | Write scripts AC-by-AC until tests pass |
| 5 | skill | Green | Write SKILL.md + references to pass behavioral tests |
| 6 | adversary | Red | Write boundary attacks now that the skill's surface is known |
| 7 | eval | Assert | Full run: script tests → behavioral → adversarial. Grade and aggregate. |
| 8 | improve | — | Fix failures from eval, loop back to eval |
| 9 | refactor | — | Clean up internal structure without changing behavior (optional) |