verification-before-completion

Require fresh verification evidence before declaring software tasks complete.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces a critical discipline: always verifying work with fresh, explicit evidence before claiming completion. It prevents false positives, broken trust, and wasted time from unverified assertions, ensuring every claim is backed by proof.

Core Features & Use Cases

  • Iron Law of Verification: Establishes a non-negotiable rule: no completion claims without fresh verification evidence, promoting honesty and rigor.
  • Gate Function Workflow: Provides a step-by-step process to identify, run, read, and confirm verification commands before making any success claims.
  • Rationalization Prevention: Counters common excuses for skipping verification, ensuring adherence even under pressure or fatigue.
  • Common Failures & Requirements: Clearly outlines what verification is required for common claims like "tests pass" or "bug fixed."
  • Use Case: You've just fixed a critical bug. This skill ensures you run the exact regression tests, confirm their output, and only then report the bug as fixed, preventing a re-occurrence or false sense of security.

Quick Start

Before claiming any work is complete, identify the exact command that proves your claim (e.g., npm test). Run the full command, read its output carefully, and confirm it verifies your claim. Only then can you state the claim, always providing the evidence. Skipping any step is considered a violation of this core principle.

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 work is actually complete before claiming it's done?

Verification requires running the exact command that proves your claim—like `npm test` for tests or a build command for compilation—reading its full output and exit status, and confirming the output substantiates your assertion. Only after this fresh evidence exists should you declare completion.

What verification steps are required before saying a bug fix is complete?

Run the regression tests or reproduction steps that exposed the original bug, review the full output to confirm they pass, and document the evidence. A bug is only fixed when the verification command succeeds, not when you believe the code is correct.

Can I skip verification if I'm confident the code is working?

No. Confidence without fresh verification evidence violates the core discipline. Running verification commands prevents false positives and broken trust. Every completion claim must be backed by proof, regardless of confidence level.

What happens if I claim work is complete without running verification?

Skipping verification causes false positives, wasted time debugging non-existent fixes, and erodes trust in your assertions. The five-step process—identify the command, run it, read the output, confirm it substantiates your claim, then declare completion—prevents this.

How do I apply verification to pull requests and builds?

Before marking a pull request or build as complete, run the full test suite, linting checks, and build commands locally. Validate that all outputs show success, then document this evidence. This gates premature merges and prevents broken builds from reaching production.

Why is reading the full verification output important, not just checking exit status?

Exit status alone can mask warnings, partial failures, or incomplete results. Reading the full output ensures you catch edge cases and confirms the evidence truly supports your claim, not just that a command terminated.