verification-before-completion

Run verification commands and capture outputs before any completion claim.

4|1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/samjhecht/wrangler --skill verification-before-completion-samjhecht
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/samjhecht/wrangler/tree/main/skills/verification-before-completion
Command: npx skills add https://github.com/samjhecht/wrangler --skill verification-before-completion-samjhecht

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claiming work is complete or fixed without fresh, explicit verification leads to false positives, broken trust, and costly rework, undermining confidence in delivered solutions.

Core Features & Use Cases

  • Evidence Before Claims: Enforces the iron law: "NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE," mandating proof before any assertions.
  • Gate Function: Provides a strict, step-by-step process to identify, run, read, and verify the output of commands that prove a claim.
  • Rationalization Prevention: Explicitly lists common excuses and red flags, preventing agents from skipping verification due to confidence, tiredness, or perceived simplicity.
  • Use Case: Any time you are about to claim work is complete, a bug is fixed, tests are passing, or requirements are met, this skill ensures you provide undeniable evidence before making any assertions.

Quick Start

I've just implemented a new feature and I think all tests pass. Guide me through the verification process before I claim completion.

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 that my code changes are actually working before claiming completion?

Verification requires running fresh commands that prove your claim and capturing their full output and exit codes. Document what you ran, what the output shows, and confirm success explicitly—never skip this step based on confidence or perceived simplicity.

What counts as valid evidence that a bug fix is complete?

Valid evidence includes the exact command executed, complete output from that command, and exit code confirmation. Reproduce the original failure, apply your fix, then run the same verification command again to prove the issue is resolved.

Why do I need to run verification commands myself instead of relying on automated checks?

Fresh verification captures real behavior in your current state. Automated checks may be stale or miss edge cases. Running commands yourself produces undeniable proof of success and prevents false positives that lead to broken trust and costly rework.

Can I claim tests are passing without running them again?

No. Before any completion claim, execute your test suite in the current environment and capture the output. Report the exit code and specific test results—not assumptions about what should pass.

What are common mistakes people make when verifying work?

Skipping verification due to confidence, running old commands instead of fresh ones, relying on partial output, or claiming success without checking exit codes. Enforce the rule: no completion without fresh, explicit evidence.

How do I document verification evidence for a pull request or merge decision?

Include the exact verification command, full command output, exit code, and timestamp. This creates accountability and lets reviewers see proof independently, not just accept your assertion.