verification-before-completion

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

3|Updated Sep 18, 2025
One-click install
npx skills add https://github.com/KingMichaelPark/dotfiles --skill verification-before-completion-kingmichaelpark
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/KingMichaelPark/dotfiles/tree/main/ai/.agents/skills/verification-before-completion
Command: npx skills add https://github.com/KingMichaelPark/dotfiles --skill verification-before-completion-kingmichaelpark

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents and developers often claim work is complete, tests pass, or bugs are fixed without actually running the verification commands, leading to broken code, 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. - Failure Pattern Catalog: Maps common claims (tests pass, build succeeds, bug fixed) to the exact evidence required and what does not count as proof. - Rationalization Blocking: Counters excuses like "should work", "linter passed", or "agent said success" with mandatory re-verification rules. - 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 evidence. ## Quick Start Before claiming any task is done, ask the agent to run the relevant test or build command and show the actual output as evidence.

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 completely, read the full output including exit codes, and only then state the result with that evidence. Never commit based on assumptions or previous runs.

How to 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.

Does a passing linter mean the build succeeds?

No, a linter passing does not prove compilation or build success. Linters check style and static issues but do not verify the code compiles or runs, so you must run the actual build command and check its exit code.

Can I trust an agent's success report without checking?

No, agent success reports must be independently verified. Check the version control diff to confirm actual changes were made and run the relevant verification commands yourself before reporting completion.

When should verification be skipped for small changes?

Never. The rule has no exceptions for small changes, tiredness, or confidence. Partial checks and assumptions prove nothing, so run the full verification command every time before any completion claim.