verification-before-completion

Execute proving commands anew and inspect outputs before asserting completion with evidence.

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/mikeyobrien/ghclip --skill verification-before-completion-mikeyobrien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/mikeyobrien/ghclip/tree/main/.claude/skills/verification-before-completion
Command: npx skills add https://github.com/mikeyobrien/ghclip --skill verification-before-completion-mikeyobrien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces a non-negotiable principle: no claims of completion, fixes, or success without fresh, verifiable evidence. It eliminates premature declarations, prevents incomplete or faulty work from being passed on, and ensures actual task completion, saving time and rework.

Core Features & Use Cases

  • Evidence-Based Claims: Requires you to identify, execute, and review the complete output of a command to prove any claim of success.
  • Red Flag Avoidance: Warns against common rationalizations like using tentative language ("should," "probably") or expressing satisfaction before running verification.
  • Universal Application: Applies universally to any form of success communication, whether exact phrases or paraphrases, with no exceptions.
  • Use Case: You've implemented a new feature and believe it's working. Before reporting it as complete, use this skill to run all relevant tests, review the complete output, and present the passing results as concrete, undeniable evidence.

Quick Start

Use the verification-before-completion skill to confirm that all unit tests for the 'payment-gateway' module are passing.

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 actually work before claiming completion?

Verification-before-completion requires you to identify and execute the proving command—such as running your test suite or build step—inspect the complete output and exit status, and confirm the results substantiate your claim before asserting success. This prevents incomplete work from advancing and eliminates premature declarations.

What's the best way to ensure quality assurance in CI/CD pipelines and task workflows?

Enforce verification-before-completion across your workflow: run fresh verification commands for every success claim, review full output rather than assuming results, and back all completion reports with concrete evidence. This practice applies universally to feature implementations, bug fixes, and test runs.

Why should I avoid tentative language like 'should be working' or 'probably fixed' in task reporting?

Tentative language signals unverified assumptions. Verification-before-completion flags these red flags and requires actual proof—run the test, review the output, and present passing results as concrete evidence instead of speculation about what might work.

How do I prevent rework and incomplete fixes from moving downstream in development?

Stop premature declarations by requiring fresh, verifiable evidence before any completion claim. Execute the relevant test command, inspect the full output and exit status, and confirm it substantiates your work. This eliminates incomplete or faulty work passed on to downstream teams.

Can I apply verification-before-completion across different types of tasks and workflows?

Yes. Verification-before-completion applies universally to software development, CI/CD pipelines, QA testing, data analysis, and general task execution. The core principle—prove claims with fresh evidence—has no exceptions and works across any success communication or completion report.

What counts as acceptable proof when verifying a task is complete?

Acceptable proof is the complete output and exit status of the proving command you identified for the task—such as passing unit tests, successful build logs, or validation script results. The output itself must substantiate your specific completion claim; tentative satisfaction or partial inspection does not qualify.