TESTING AND RELIABILITY / Jesse Vincent / Superpowers
Superpowers Verification Before Completion
Requires a fresh command result or direct check for each completion claim and distinguishes passing tests from fulfilling requirements.
“Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before”
01 / THE REASONING
Why this made the selection.
- Maps common claims to appropriate evidence, including compiler/build status, original bug reproduction and requirements checks.
- Explicitly asks reviewers to inspect delegated changes instead of treating another agent's success message as proof.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/verification-before-completion/SKILL.md
- LICENSE
Our findings
- The gate requires identifying a proving command, reading complete output and its exit status, then qualifying the claim.
- The examples distinguish a test that merely passes from a demonstrated regression test.
- The source has no bundled executables; the consuming agent chooses and runs project-specific checks.
Not established by this review
- No agent-adherence evaluation was run.
- No project tests, builds or deployments were performed by this review.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add https://github.com/obra/superpowers/tree/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/verification-before-completionCopying does not execute this command. It may retrieve a newer version than the reviewed source.
- Install the complete skill directory with its references and helpers; a copied SKILL.md alone may be incomplete.
- Choose the intended agent and project scope in the installer, then review its permissions before using the skill.
Before you start
- Node.js/npm for this installer
- An agent that supports the Agent Skills format
- Access to relevant test/build commands and their complete output
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/obra/superpowers/blob/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/verification-before-completion/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, compatibility, access
https://github.com/obra/superpowers/blob/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE
Supports: license
https://github.com/obra/superpowers/blob/5bf4e78011075bcfc0dc295f0724994cd123ee71/README.md
Supports: install, compatibility, access
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: install
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts
Supports: install