Verification Before Completion

Run verification commands and inspect outputs before declaring completion.

Updated Sep 16, 2023
One-click install
npx skills add https://github.com/paopp2/dotfiles --skill verification-before-completion-paopp2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Verification Before Completion
Source: https://github.com/paopp2/dotfiles/tree/main/.claude/skills/debugging/verification-before-completion
Command: npx skills add https://github.com/paopp2/dotfiles --skill verification-before-completion-paopp2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? This skill eliminates the risk of false positives and incomplete work by enforcing rigorous, evidence-based verification before any claim of completion.

Core Features & Use Cases:

  • Iron Law of Verification: Enforces that no completion claims can be made without running and confirming output from a specific verification command.
  • Gate Function Process: Provides a strict, step-by-step process to identify, run, read, and verify evidence before making any claims of success.
  • Red Flag & Rationalization Prevention: Highlights common shortcuts and excuses, ensuring adherence to the principle of evidence-based claims.

Quick Start: I'm about to claim a bug is fixed. Use the Verification Before Completion skill to guide me through the verification process.

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 a bug fix is actually complete before marking it done?

Verification before completion requires running the specific test, build, or quality command that confirms the fix works, inspecting the full output and exit code, and only then declaring success. This eliminates false positives by anchoring completion claims to concrete evidence rather than assumptions.

What's the best way to ensure code changes pass all quality checks before submitting a PR?

Execute the complete verification command—linting, tests, or builds—in full, read the output carefully to confirm all checks pass, and verify the exit code indicates success. Only after confirming evidence should you claim readiness or create the PR.

Why do development tasks fail even when they seem complete?

Incomplete verification allows premature completion claims. Without running and inspecting verification commands end-to-end, you miss failures that only surface during actual testing, builds, or code reviews, creating rework and trust issues downstream.

Can I claim a feature is ready without running the full test suite?

No. Verification before completion enforces that all completion claims—whether for bug fixes, features, or code reviews—must be gated on evidence from the actual verification command. Partial or skipped verification defeats the process.

How do I prevent shortcuts that skip verification steps?

The verification process identifies common rationalizations and red flags that lead to skipped steps. By following the strict gate-function process—identify command, run it fully, read output, confirm exit code—you enforce evidence-based claims and eliminate excuses.

What should I do if the verification command shows errors or warnings?

Inspect the full output and exit code to understand what failed. Do not claim completion until the verification command succeeds completely. Address the failures, re-run verification, and confirm success before proceeding.