Skills

Verify

AI DevKit · Enforce evidence-based completion claims, require fresh command output...

Install

npx skills add codeaholicguy/ai-devkit --skill verify -g -a claude-code -y
Category
Testing
Updated
4d ago
License
Apache-2.0
Context cost
Lightabout 1,084 tokens
Runs scripts
No, instructions only

What it does

AI DevKit · Enforce evidence-based completion claims, require fresh command output before reporting success. Use when completing any task, fixing a bug, finishing a phase, running tests, building, deploying, or making any "it works" claim.

Verify

Prove it works before saying it works.

Hard Rules

  • Do not claim completion without fresh terminal evidence from this session.
  • Forbidden words in completion claims: "should", "probably", "seems to", "likely", "I believe", "I think it works". These signal unverified assertions.
  • Cached, remembered, or previous-session output is not evidence. Run it again.
  • A change that alters anything a user or caller sees requires a dev-smoke run, whatever the claim is called.

Gate Function

Every completion claim must pass all steps in order:

  1. Classify, Does the change alter anything a user or caller sees (CLI output, API response, UI, displayed status or state, file formats)? If yes, dev-smoke is required evidence alongside tests.
  2. Identify, What command proves this claim? If multiple commands are needed, run the gate once per command.
  3. Run, Execute the full command now. No partial runs, no skipping.
  4. Read, Read complete output. Check exit code. Count pass/fail.
  5. Confirm, Does the output prove the exact claim?
  6. Report, State the result in the Report Format below.

If any step fails, stop. Fix the issue and restart from step 0.

If no verification command exists (e.g., no test suite), tell the user and ask them how to verify before claiming done.

Verification Patterns

ClaimRequired EvidenceNot Sufficient
Tests passTest output: 0 failures, exit 0Previous run, "should pass now"
Build succeedsBuild output: exit 0Linter passing, partial build
Bug is fixedSymptom reproduced at the level the user saw it (CLI/API/UI) → now gone, plus a regression test"Changed code, should be fixed"; unit test alone for a user-visible bug
Linter cleanLinter output: 0 errorsSingle file check
Phase completeEach criterion verified individually"Tests pass, so done"
Feature worksdev-smoke run or E2E testUnit tests alone

Report Format

Read the whole SKILL.md on GitHub

More in Testing