Skip to content
cccskills
FreePublished on GitHubEnglish overview

verification-before-completion

Checks whether work is truly complete before reporting success, committing changes, or creating a pull request. It runs the relevant checks, reads their full output, and ties status reports to current evidence.

OriginalShow the original description

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

AI rating80/ 100See how to install

Good for

  • Checking results before reporting completion
  • Confirming that a bug fix resolves the original problem
  • Verifying work before a commit or pull request
  • Checking changes reported by another agent

Overview

What it does

Verifies the evidence before reporting that work is complete or a fix has succeeded. It selects a command that can establish the claim, runs it, and checks the full output, exit code, and number of failures before describing the status. Tests, builds, and code style checks are treated separately, with the appropriate evidence required for each. Requirements are checked individually. Changes made by another agent are also examined through their diff and verification results.

When it helps

Use it when submitting corrected code, preparing a commit, or creating a PR. It helps you understand what has actually been verified and what problems remain, without treating earlier test results or an assumption that something should work as proof of completion.

Example requests

  • “Run the tests and build before reporting completion, and summarize the status using the results.”
  • “Check whether the original bug can still be reproduced.”
  • “Verify the other agent's changes using the diff and execution results.”

Notes

Requires commands and an execution environment that can verify the work. Previous runs and partial checks do not count as evidence of current success. If the results do not support a claim, it reports the actual status and supporting evidence.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt explicitly requires fresh verification before completion reports or commits.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodFive steps and examples cover command selection, full output and exit-code checks, and evidence-based reporting.
SafetyAre sending data, deleting files, and running commands disclosed?
BPartly lackingIt requires verification commands and temporary reversal of fixes but does not define the scope of those operations.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt assumes tests, builds, and lint checks can run but provides no environment setup instructions.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 19, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (1)

  • SKILL.md3.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Verification Before Completion

Overview

Core principle: Evidence before claims, always.

Violating the letter of this rule is violating the spirit of this rule.

The Iron Law

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

If you haven't run the verification command in this message, you cannot claim it passes.

The Gate Function

BEFORE claiming any status or expressing satisfaction:

1. IDENTIFY: What command proves this claim?
2. RUN: Execute the FULL command (fresh, complete)
3. READ: Full output, check exit code, count failures
4. VERIFY: Does output confirm the claim?
   - If NO: State actual status with evidence
   - If YES: State claim WITH evidence
5. ONLY THEN: Make the claim

Skip any step = lying, not verifying

Common Failures

ClaimRequiresNot Sufficient
Tests passTest command output: 0 failuresPrevious run, "should pass"
Linter cleanLinter output: 0 errorsPartial check, extrapolation
Build succeedsBuild command: exit 0Linter passing, logs look good
Bug fixedTest original symptom: passesCode changed, assumed fixed
Regression test worksRed-green cycle verifiedTest passes once
Agent completedVCS diff shows changesAgent reports "success"
Requirements metLine-by-line checklistTests passing

Red Flags - STOP

  • Using "should", "probably", "seems to"
  • Expressing satisfaction before verification ("Great!", "Perfect!", "Done!", etc.)
  • About to commit/push/PR without verification
  • Trusting agent success reports
  • Relying on partial verification
  • Thinking "just this once"
  • Tired and wanting work over
  • ANY wording implying success without having run verification

Rationalization Prevention

ExcuseReality
"Should work now"RUN the verification
"I'm confident"Confidence ≠ evidence
"Just this once"No exceptions
"Linter passed"Linter ≠ compiler
"Agent said success"Verify independently
"I'm tired"Exhaustion ≠ excuse
"Partial check is enough"Partial proves nothing
"Different words so rule doesn't apply"Spirit over letter

Key Patterns

Tests:

✅ [Run test command] [See: 34/34 pass] "All tests pass"
❌ "Should pass now" / "Looks correct"

Regression tests (TDD Red-Green):

✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "I've written a regression test" (without red-green verification)

Build:

✅ [Run build] [See: exit 0] "Build passes"
❌ "Linter passed" (linter doesn't check compilation)

Requirements:

✅ Re-read plan → Create checklist → Verify each → Report gaps or completion
❌ "Tests pass, phase complete"

Agent delegation:

✅ Agent reports success → Check VCS diff → Verify changes → Report actual state
❌ Trust agent report

When To Apply

ALWAYS before:

  • ANY variation of success/completion claims
  • ANY expression of satisfaction
  • ANY positive statement about work state
  • Committing, PR creation, task completion
  • Moving to next task
  • Delegating to agents

Rule applies to:

  • Exact phrases
  • Paraphrases and synonyms
  • Implications of success
  • ANY communication suggesting completion/correctness

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

brainstorming

FreeSummaryAI rating 90

Clarifies the purpose, preferences, and constraints of a new feature or project through conversation. When useful, it offers mockups or temporary prototypes, then captures an agreed description or written design before implementation begins.

  • Clarifying the purpose of a new feature
  • Organizing ideas for a talk or business
  • Comparing screen or room layouts visually
obra/superpowers301.8KUpdated Oct 10, 2026

diagnosing-superpowers

FreeSummaryAI rating 90

Examine superpowers session records to document repeated work, departures from plans, delays, and token usage. Produce an evidence-based report with file and line references, and prepare bug-report material when requested.

  • Investigating repeated work or departures from a plan
  • Checking session duration and token usage
  • Tracing whether a skill was invoked
obra/superpowers301.8KUpdated Oct 10, 2026

dispatching-parallel-agents

FreeSummaryAI rating 90

Assign independent bugs or test failures to separate agents that work at the same time. Define each agent’s scope and expected report, then check for conflicting changes and run the full test suite before integrating fixes.

  • Investigating test failures with unrelated causes
  • Fixing independent problems in separate subsystems
  • Defining focused tasks for multiple agents
obra/superpowers301.8KUpdated Oct 10, 2026

executing-plans

FreeSummaryAI rating 90

Carry out an existing implementation plan in one session, task by task. Verify each step with tests, record progress and decisions in a file, and finish with a review of all changes on the branch.

  • Implementing a prepared development plan
  • Executing tasks without implementer subagents
  • Resuming work from a progress record
obra/superpowers301.8KUpdated Oct 10, 2026

finishing-a-development-branch

FreeSummaryAI rating 90

Finish completed development work by checking the full test suite and presenting integration choices: merge locally, create a Pull Request, or keep the branch. It carries out the selected path and handles workspace cleanup accordingly.

  • Merging a completed feature locally
  • Pushing a branch and creating a Pull Request
  • Keeping completed work for later integration
obra/superpowers301.8KUpdated Oct 10, 2026

receiving-code-review

FreeSummaryAI rating 80

Evaluate code review feedback against the actual code, supported environments, and existing behavior. Clarify uncertain requests, respond with technical evidence, and implement valid changes one at a time with tests for each fix.

  • Clarifying ambiguous code review comments
  • Checking whether suggested changes preserve compatibility
  • Assessing whether a requested feature is actually used
obra/superpowers301.8KUpdated Oct 10, 2026

See all skills by obra

Report a problem with this skill