QA
Pressure-Test an Agent Skill Definition
A reproducible challenge to an agent skill definition that tests trigger clarity, instruction completeness, tool assumptions, and safe fallback behavior before publication.
The process
Work it in this order.
- Capture the exact skill file, version, source, license, frontmatter, intended trigger, non-trigger cases, and the behavior the skill promises to produce.
- Build a test set covering ordinary requests, ambiguous requests, out-of-scope requests, missing inputs, unavailable tools, and adversarial instructions.
- Inspect the definition for hidden assumptions about paths, accounts, permissions, sequencing, external actions, evidence, and output format.
- Run the cases in an isolated environment with a declared tool and account matrix, using Latch/target-workspace when private files or non-public evidence are required.
- Score each result against selection accuracy, instruction adherence, safe refusal, evidence handling, uncertainty disclosure, and usefulness of the fallback.
- Revise one material weakness at a time, rerun the full regression set, and inspect the diff for removed constraints or newly implied capabilities.
- Publish a pass, conditional pass, or fail verdict with failing cases, reproduction steps, evidence, unresolved risks, and an owner for each follow-up.
Bring this
Inputs the cat will ask for.
- skill definition and source version
- intended triggers and non-triggers
- test environment and tool matrix
- acceptance rubric and reviewer
Router + one playbook
Route first. Choose one.
Cat Paw loads one playbook per task rather than merging several. Start with this router; the remaining paths are workflow-specific candidates it can inspect.
- Router:
software-delivery-pack skills/software-delivery-pack/skill-definition-pressure-test/SKILL.md
Guardrails
The boundaries travel with the prompt.
- Verify the actual tools, accounts, permissions, and workspace before starting; never claim an unavailable tool, account, source, or capability.
- Use Latch/target-workspace for private code, artifacts, live probes, or non-public data; if that access is unavailable, stop at the boundary and report the blocker rather than substituting a guess.
- Pause for explicit approval before consequential external actions; return evidence and unresolved risks, assumptions, and any action still awaiting approval.
Done means
A checkable finish.
A documented pressure-test report exercises the skill against representative and adversarial cases, records reproducible failures, and gives a defensible publication verdict with evidence and unresolved risks.
Sources
Where this process came from.
- github.com/obra/superpowers/tree/5bf4e78011075bcfc0dc295f0724994cd123ee71/
- agentskills.io/specification
- platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
Sources establish the workflow pattern. Reddit and community posts, where present, are treated as practitioner anecdotes rather than universal facts.