verification-before-completion

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

92|12|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/ARounder-183/HiFiShifter --skill verification-before-completion-arounder-183
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/ARounder-183/HiFiShifter/tree/main/.github/skills/verification-before-completion
Command: npx skills add https://github.com/ARounder-183/HiFiShifter --skill verification-before-completion-arounder-183

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 code, lost trust, and wasted rework. This Skill enforces an evidence-first discipline so no completion claim is made without fresh command output. ## Core Features & Use Cases - Verification Gate: A mandatory five-step gate (identify, run, read, verify, claim) that must be completed before any success statement, commit, or PR. - Failure Pattern Catalog: Tables mapping common claims (tests pass, build succeeds, bug fixed) to the exact evidence required, plus red-flag phrases like "should work" that trigger a stop. - Rationalization Prevention: Counters common excuses such as trusting agent success reports, relying on linter output, or skipping checks "just this once". - Use Case: Before committing a bug fix, the agent runs the full test suite, confirms zero failures in the output, and only then reports the fix as verified with the evidence attached. ## Quick Start Ask the agent to verify the fix by running the full test suite and showing the output before claiming the work is complete.

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 code changes before claiming a task is complete?

Identify the command that proves the claim, run it fresh and in full, read the complete output including exit codes and failure counts, then state the claim only with that evidence attached. Skipping any step counts as an unverified claim.

What counts as sufficient evidence that tests pass?

Only the actual test command output showing zero failures counts as evidence. Previous runs, partial checks, linter results, or statements like "should pass" are explicitly not sufficient under this verification gate.

Can I trust a sub-agent's report that it completed successfully?

No. Agent success reports must be independently verified by checking the version control diff and confirming the actual changes exist before reporting completion. Trusting the report alone is listed as a common failure.

Does a passing linter mean the build succeeds?

No. A linter does not check compilation, so a clean lint result is not evidence of a successful build. You must run the build command and confirm exit code 0 before claiming the build passes.

How do I 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 only passes once is not verified.

When should the verification gate be applied?

Apply it before any success or completion claim, expression of satisfaction, commit, pull request, task handoff, or delegation to agents. The rule covers exact phrases, paraphrases, and any implication that work is correct or done.