verification-before-completion

Enforces running verification commands before claiming work is complete or passing.

Updated Jul 15, 2026
One-click install
npx skills add https://github.com/em411/supercodex --skill verification-before-completion-em411
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/em411/supercodex/tree/main/skills/verification-before-completion
Command: npx skills add https://github.com/em411/supercodex --skill verification-before-completion-em411

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents and developers often claim work is done, tests pass, or bugs are fixed without actually running the verification commands, leading to broken builds, shipped defects, and lost trust. This Skill enforces an evidence-first discipline so no success claim is made without fresh command output. ## Core Features & Use Cases - Verification Gate: A five-step gate (identify, run, read, verify, claim) that must be completed before any completion statement. - Claim-to-Evidence Mapping: A table mapping common claims (tests pass, linter clean, build succeeds, bug fixed) to the exact command output required to support them. - Rationalization Blocking: Explicit counterarguments for common excuses like "should work", "just this once", or "the agent reported success". - Use Case: Before committing a bug fix, run the test suite, confirm zero failures in the output, verify the regression test fails without the fix, and only then report completion with the evidence attached. ## Quick Start Ask the agent to verify the fix by running the full test suite and only claim completion after confirming the output shows zero failures.

Frequently Asked Questions about verification-before-completion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify work is complete before committing code?

Identify the command that proves your claim, run it fresh and in full, read the complete output including exit code, and confirm it matches the claim. Only then state the result, citing the evidence such as "34/34 tests pass".

How to verify a regression test actually works?

Use the red-green cycle: write the test, run it to confirm it passes with the fix, revert the fix and confirm the test fails, then restore the fix and confirm it passes again. A test that never fails proves nothing.

Can I trust a subagent's success report without checking?

No. Agent success reports are not evidence. After an agent reports completion, inspect the version control diff to confirm the changes actually exist and verify the result independently before reporting the state.

Is a passing linter enough to claim the build works?

No. A linter does not check compilation or runtime behavior. Claiming a build succeeds requires running the actual build command and confirming it exits with code 0.

When should verification be skipped to save time?

Never. The rule has no exceptions: partial checks, prior runs, confidence, and time pressure are all explicitly rejected as substitutes for fresh verification evidence.