grill-skill
Installation
SKILL.md
Grill Skill
Interview the user to design a skill's eval, then loop run → diagnose → improve until it ships. Requires caliper (pipx install caliper-eval if missing). Commands, spec skeleton, and task-writing rules: REFERENCE.md.
An eval answers four questions, and the interview covers each:
- Fires: does the agent reach for the skill when it should, and only then? Tested with
activates:and trigger probes. Fixed in thedescription. - Works: once it fires, does it do the job? Tested with
expect:/assert:. Fixed in the body. - Earns: does it beat the agent without it? Tested against the control: the declared neighbourhood with this skill removed. A task the control passes too is fixed in the task.
- Holds: does it stay good across edits? Tested by comparing each new full run against the previous one.
Entry point
/grill-skill [path]: optional path to a SKILL.md.
- Path given: use it.
- No path: look for
SKILL.mdin the cwd; if found, confirm before proceeding, else ask where it is.