verification-before-completion

Require full verification command output before reporting completion.

Updated Oct 22, 2025
One-click install
npx skills add https://github.com/franroa/chezmoi --skill verification-before-completion-franroa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/franroa/chezmoi/tree/main/dot_opencode/superpowers/skills/verification-before-completion
Command: npx skills add https://github.com/franroa/chezmoi --skill verification-before-completion-franroa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents false claims of completion, ensuring that every assertion about work status is backed by fresh, explicit verification evidence. It builds trust and eliminates rework by mandating a rigorous check before any success claim is made.

Core Features & Use Cases

  • Mandatory Gate Function: Requires you to identify, run, read, and verify the output of a command that proves your claim before stating any status.
  • Anti-Rationalization: Explicitly counters common excuses for skipping verification (e.g., "should work now," "I'm confident"), ensuring strict adherence.
  • Evidence-Based Reporting: Guides you to always state claims with the supporting evidence (e.g., "All tests pass [See: 34/34 pass]").
  • Use Case: Before claiming any task is complete, a bug is fixed, or tests are passing, use this Skill. For example, if you've just fixed a bug, this Skill will require you to run the specific test that reproduces the bug and show its passing output before you can report it as fixed.

Quick Start

Announce skill usage

I'm using the verification-before-completion skill to confirm this task is done.

Example: Verifying tests pass

Run test command

npm test

Expected output: 34/34 pass

Then state: "All tests pass [See: 34/34 pass]"

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 code changes are actually working before claiming they're complete?

Verification-before-completion requires running the full test, build, or reproduction command, reading its output and exit status, confirming the evidence matches your claim, then reporting success only with that evidence. For example, run the failing test, confirm it passes, then state the fix is complete with the output proof.

Why should I run verification commands instead of assuming my bug fix works?

Running verification commands eliminates false completion claims and rework. This practice catches logic errors, edge cases, and integration issues that code review alone misses, ensuring every assertion about task status, passing tests, or fixed bugs is backed by fresh, explicit evidence.

What's the best way to report test results or build success to my team?

State your claim with supporting evidence: 'All tests pass [See: 34/34 pass]' or 'Build succeeds [See: exit status 0]'. This evidence-based reporting builds trust, eliminates ambiguity about work status, and provides a clear record before commits or pull requests.

Can I claim a task is done without running verification first?

No. Verification-before-completion acts as a mandatory gate: you must identify, run, and read the output of a command that proves your claim before stating any status. This prevents rationalization excuses like 'should work now' and ensures rigorous completion checks.

How does verification reduce bugs and rework in development workflows?

By mandating explicit verification before completion claims, this practice catches issues early, prevents false positives, and ensures code quality gates are actually met. Fresh command output and exit-status checks replace assumptions, reducing downstream debugging and failed deployments.