principle-prove-it-works
About principle-prove-it-works
Prove It Works is a verification skill for checking task results against the actual application or output rather than proxies or self-reports. It encourages deterministic, rerunnable scripts and visible evidence that reviewers can inspect.
Key features
- 01Direct checks of real outputs
- 02Deterministic scripted verification
- 03Rerunnable evidence artifacts
- 04Checks for processes and actual values
Use cases
- 01Verifying an application feature after a change
- 02Checking process liveness directly
- 03Confirming values rather than cached representations
- 04Providing reproducible proof for review
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/principle-prove-it-worksin Claude Code to confirm it loaded.
Details
From the project READMEProve It Works
Verify every task output by checking the real thing directly. Do not infer from proxies, self-reports, or "it compiles."
Why: Unverified work has unknown correctness. Indirect verification (file mtimes, output freshness, agent self-reports, cached screenshots) feels cheaper than direct observation. Acting on a wrong inference costs far more than checking the source.
Check the real thing, not a proxy:
- Check process liveness directly, not indirectly through derived state
- Read the actual value, not a cached or derived representation
- When verification fails, suspect the observation method before suspecting the system
Script the check when you can
The strongest proof is a deterministic script that re-runs the same comparison, not a one-time eyeball. Write the script, run it, and keep its output as an artifact a reviewer can re-run instead of trusting your word.
Keep the artifact visible for the human. Commit it only for large or complex work where the trail has to be auditable later, like a big port or migration (the show-me-your-work skill).