verification-before-completion

Enforce fresh verification evidence before claiming task completion.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/HTRamsey/claude-config --skill verification-before-completion-htramsey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/HTRamsey/claude-config/tree/main/skills/verification-before-completion
Command: npx skills add https://github.com/HTRamsey/claude-config --skill verification-before-completion-htramsey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claiming work is complete without verification is dishonest. This Skill enforces evidence-first completion and requires fresh verification before any success claim.

Core Features & Use Cases

  • The Iron Law: NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE.
  • Verification gate: Run full verification commands and only claim success if outputs meet expected criteria.
  • Evidence-based reporting: Provide exact command results as proof of completion.

Quick Start

Before declaring completion, run the full verification suite (tests/build/lint) and report the exact results. Do not claim success without fresh 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 my code changes before marking work complete?

Verification before completion means running the full test, build, and lint suite on your changes and confirming all outputs pass expected success criteria. Execute the complete verification command, read the output carefully, and only claim success when evidence—such as exit codes and validation summaries—confirms the work is done.

What verification evidence should I attach when submitting a PR or commit?

Attach exact command results as proof: test exit codes, build logs showing successful compilation, linter reports with zero errors, and any regression test output. Fresh verification output—not cached or assumed results—demonstrates the work actually passes and is ready for review.

Do I need to re-run verification before every commit or just once?

Run verification fresh before each commit or PR submission. Code changes between verification runs can introduce new failures. The Iron Law requires evidence from the exact state you're claiming is complete, not from an earlier check.

Can I claim work is done if tests pass locally but CI hasn't run yet?

No. Local test passage alone is not sufficient verification for completion claims. Wait for the full CI pipeline—tests, builds, linters, and any regression suites—to complete and pass. Only the complete pipeline output constitutes valid completion evidence.

What happens when verification fails after I've already started the next task?

Stop work on the next task immediately. Return to debug the failure, fix the root cause, and re-run the full verification suite until all outputs meet success criteria. Only then resume forward progress and claim the prior work complete with attached evidence.

Why is fresh verification required instead of relying on previous test results?

Code evolves between verification checks. Dependencies update, environment state changes, and new failures emerge. Fresh verification ensures the exact code state you're claiming as complete has been tested and proven to work right now, not in the past.