verification-before-completion

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

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/pd-phuc/laravel-template --skill verification-before-completion-pd-phuc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/pd-phuc/laravel-template/tree/main/.claude/skills/verification-before-completion
Command: npx skills add https://github.com/pd-phuc/laravel-template --skill verification-before-completion-pd-phuc

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 shipped, lost trust, and wasted rework cycles. ## Core Features & Use Cases - Evidence-First Gate: Requires identifying, running, and reading the full output of a verification command before any success claim is made. - Claim-to-Command Mapping: Provides a table mapping common claims (tests pass, linter clean, build succeeds, bug fixed) to the exact evidence required. - Rationalization Blocking: Lists common excuses ("should work", "just this once", "agent said success") and counters each with the required verification action. - Use Case: Before committing a bug fix, the agent runs the test suite, confirms zero failures in the output, and only then reports the fix as verified. ## Quick Start Ask the AI to verify the fix with fresh test output before claiming the task 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 committing?▼

Run the full verification command for your claim, such as the test suite or build command, and read the complete output including exit code. Only state the change works after the output confirms it with zero failures.

What counts as evidence that tests pass?▼

Evidence is the fresh output of the test command showing zero failures from the current session. Previous runs, partial checks, or assumptions that code should pass do not qualify as verification.

Why is linter output not enough to claim a build succeeds?▼

Linters check code style and syntax patterns but do not compile or bundle the project. A build claim requires running the actual build command and confirming it exits with code 0.

How do I verify a regression test actually works?▼

Use the red-green cycle: write the test, 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 sub-agent's report that a task succeeded?▼

No, agent success reports must be independently verified by checking the version control diff and confirming the actual changes exist. Trusting reports without inspection is listed as a common failure mode.

When should verification before completion be applied?▼

Apply it before any success claim, expression of satisfaction, commit, pull request, task completion, or handoff to another agent. The rule covers exact phrases, paraphrases, and any implication of completion.