dev-verification

Enforces evidence-based verification before claiming development work is complete or correct.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/mnazaal/dotfiles --skill dev-verification-mnazaal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-verification
Source: https://github.com/mnazaal/dotfiles/tree/main/.agents/skills/dev-verification
Command: npx skills add https://github.com/mnazaal/dotfiles --skill dev-verification-mnazaal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents premature or unsupported claims that code is fixed, passing, reviewed, or verified by requiring fresh command output, exit statuses, and artifact inspection before any completion claim is made. ## Core Features & Use Cases - Evidence Gate: A five-step gate that maps each claim (tests pass, lint clean, bug fixed, build works) to the exact command output or artifact required to prove it. - Measurement Discipline: Rules for designing probes that can distinguish outcomes, detecting stalled background jobs via CPU time, and avoiding wrapper exit-status traps in shell pipelines. - Correctness Certification: Guidance for validating numerical results against independent references, timing comparisons with interleaved best-of-N runs, and grading load-bearing facts from asserted to executed. - Use Case: Before telling a stakeholder that a bug fix is done, run the regression test fresh, read the full output including exit status, and report the actual result with evidence. ## Quick Start Before claiming any development task is complete, fixed, or verified, apply this skill to run the proving command fresh and report the actual evidence.

Frequently Asked Questions about dev-verification

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify a bug fix before claiming it is done?▼

Run the original symptom reproduction or regression test fresh and read the full output including the exit status. Code changed is not bug-fixed evidence; only a passing check that exercises the original failure proves the fix.

How to prove tests pass without false positives?▼

Run the focused or full test command and read the complete output showing zero failures, not a piped tail or a wrapper's exit code. A multi-case test stops at its first failure, so fix the first failure and re-run before counting coverage.

Why does a passing test not prove numerical correctness?▼

A test asserting the code's own output proves stability, not correctness. Certify correctness by checking against an independently derived reference that shares no code path, such as a textbook formula, autodiff comparison, or brute-force enumeration.

When should a code review finding be marked resolved?▼

Mark a finding repaired and pending review when the fix is written, but only clear it after a pass that did not write the fix re-reads the code. Re-review the code itself, not just the finding list, since repairs can introduce new defects.

How do I tell if a background job is stalled or working?▼

Compare accumulated CPU time from ps -o time against wall-clock elapsed time. Near-zero CPU growth over minutes indicates the job is blocked or hung rather than busy, and resource-shaped parallel-test failures should be rerun with lower parallelism first.