About skill-eval-designer
skill-eval-designer helps skill authors test whether a skill changes agent behavior on realistic tasks. It defines positive and negative prompts, behavioral assertions, artifact checks, and a forward-test plan.
Key features
- 01Defines behavior boundaries
- 02Creates positive and negative prompts
- 03Adds behavior assertions and artifact checks
- 04Covers edge cases and failure modes
- 05Produces fixtures and forward-test plans
Use cases
- 01Testing whether a skill triggers in the right situations
- 02Checking outputs for unsafe or generic behavior
- 03Evaluating skill behavior beyond static examples
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ sylphxai/ skills --skill skill-eval-designerAfter installing, type/skill-eval-designerin Claude Code to confirm it loaded.
Bundled filesagents/openai.yamlreferences/skill-eval-systems.md
Details
From the project READMESkill Eval Designer
Use this skill to prove a skill changes agent behavior on realistic tasks.
Workflow
- Identify skill purpose, trigger boundary, expected artifact, failure modes, and target agent behavior.
- Read
references/skill-eval-systems.md. - Create positive prompts, negative prompts, expected behavior assertions, and artifact checks.
- Add edge cases for over-triggering, under-triggering, unsafe advice, missing references, and generic output.
- Produce eval fixture, behavior example, and forward-test plan.
When not to use
- Do not use to author the skill procedure itself, design a whole marketplace, or claim quality from static examples alone.
- Do not create an eval when the behavior is fully deterministic and a unit, contract, property, or snapshot test is the stronger oracle.
Guardrails
- Do not evaluate only whether the skill name appears.
- Do not leak the expected answer into the prompt.
- Include negative prompts so the skill does not trigger everywhere.
Output format
Skill under eval:
Behavior boundary:
Positive prompts:
- <prompt> -> expected behavior
Negative prompts:
- <prompt> -> why skill should not trigger
Assertions:
- <observable behavior>
Forward-test plan:
- task, artifact, pass/fail evidence
Comments
Markdown supported