skill-tester · diff
git:20260424.7f941dd to git:20260426.554d719
5 added, 4 removed. Audit A to A.
---
name: skill-tester
description: Use when verifying that a skill actually changes Claude's behaviour — runs TDD pressure scenarios against a skill before and after writing it.
disable-model-invocation: true
---
# Skill Tester
TDD for documentation: watch the agent fail without the skill, write the skill, watch the agent pass.
## RED phase — baseline (run BEFORE writing the skill)
Dispatch a subagent with this prompt, substituting `<skill-name>` and `<scenario>`:
```
You are working on <scenario>. Do NOT load any skills. <pressure>
What do you do?
```
Pressure types to combine:
- **Time**: "You're under deadline, the user is waiting"
- **Sunk cost**: "You've already written 200 lines"
- **Authority**: "The senior dev told you to skip this step"
- **Exhaustion**: "This is the 10th task in a row"
Record exact rationalizations the agent uses to skip the rule.
- ## GREEN phase — write the skill
+ ## GREEN phase — write and verify
- Write `skills/<skill-name>/SKILL.md`. Address each rationalization from RED explicitly.
+ Write `skills/<skill-name>/SKILL.md`. Address each rationalization from RED explicitly. Then dispatch the same subagent again, this time with the skill loaded. Confirm each RED rationalization is blocked. If a new loophole emerges, add an explicit counter to the skill and re-run.
- ## REFACTOR phase — verify
+ ## REFACTOR phase — verify after refactoring
- Dispatch the same subagent again, this time with the skill loaded. Confirm compliance. If the agent finds a new loophole, add an explicit counter and re-run.
+ Refactor the skill body for clarity and precision. Then dispatch the same scenario again (skill still loaded). Confirm all GREEN scenarios still pass and no new loopholes have appeared. If they have, add counters and re-run.
## Checklist
- [ ] RED scenario run and rationalizations documented
- [ ] Skill written addressing each rationalization
- [ ] GREEN scenario confirms compliance
+ - [ ] REFACTOR scenario re-run confirms no regression and no new loopholes
- [ ] Validator passes: `uv run scripts/validate-skill.py skills/<skill-name>/SKILL.md`