claudeers.
// Claude Skills

prove-it

Open-source adversarial verification Agent Skill for Claude Code, OpenAI Codex, and Cursor. Make AI coding agents prove bug fixes, CI, logs, and deployments.

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up prove-it (release-binary project) into my current project.
Found on https://claudeers.com/prove-it
Repo: https://github.com/Pablo-aps/prove-it
Homepage/docs: https://skills.sh/pablo-aps/prove-it/prove-it
Detected install method: release-binary → inspect the README
Category: skills. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/Pablo-aps/prove-it/releases
// or clone
git clone https://github.com/Pablo-aps/prove-it

// compatibility

Platformscli, api
Operating systems
AI compatibilityclaude
LicenseApache-2.0
Pricingopen-source
LanguageJavaScript

Prove It

Your AI says it's fixed. Prove it.

Prove It is an open-source adversarial verification Agent Skill for Claude Code, OpenAI Codex, Cursor, and other AI coding agents.

English · 简体中文 · Português do Brasil · 日本語 · Español · Русский

A passing test produces premature confidence without Prove It; Prove It finds that the assertion was weakened and returns FAILED.

Coding agents are excellent at finding evidence that their work succeeded.

Tests passed.  Build exited 0.  Healthcheck returned 200.  No ERROR lines found.

Then they say done.

But a passing signal is not automatically a passing outcome. Prove It makes your coding agent actively search for evidence that its conclusion is wrong before it is allowed to trust it.

Use it to challenge bug fixes, tests, pull requests, CI results, logs, deployments, and any confident “done” claim before you trust it.

Don't try to prove it works. Try to prove it doesn't.

Who needs Prove It?

You need it if you let an AI coding agent:

Your agent…Prove It asks…
fixes bugsCan the original bug still happen?
writes or updates testsCould these tests pass while the requirement is broken?
reviews pull requestsWere assertions, types, or acceptance criteria weakened?
reads CI or logsIs this evidence complete, current, and from the right place?
checks deploymentsIs the intended version actually running everywhere?
tells you the task is doneWhat observable fact would make that conclusion false?

This is for the moment between “the AI finished” and “you believe it.” You do not need to be a testing expert. Invoke one skill and give it the claim you want challenged.

Install in 30 seconds

Prove It is listed on skills.sh. The installer detects Claude Code, Codex, Cursor, and other supported agents:

npx skills add Pablo-aps/prove-it

Then ask it directly:

# Claude Code / Cursor
/prove-it review your last implementation and try to find a case where it still fails

# OpenAI Codex
$prove-it does this CI output actually prove the issue is resolved?

The skill can also activate automatically when you ask an agent to prove, verify, validate, confirm, or double-check a claim.

Manual install

Copy SKILL.md into a prove-it skill directory for your agent:

AgentProject locationInvoke
Claude Code.claude/skills/prove-it/SKILL.md/prove-it
OpenAI Codex.agents/skills/prove-it/SKILL.md$prove-it
Cursor.cursor/skills/prove-it/SKILL.md or .agents/skills/prove-it/SKILL.md/prove-it

Four rules. One verdict.

01 — DEFINE02 — BREAK
Convert “looks fixed” into a claim that can be false. Freeze the scope and acceptance criteria.Ask what would contradict the claim. Execute the most decisive safe checks first.
03 — VERIFY04 — VERDICT
Verify the real outcome, not a proxy such as an exit code, HTTP 200, or green healthcheck.Return PROVEN, FAILED, NOT PROVEN, or BLOCKED with the evidence.
CLAIM
All production replicas run abc123 and the migration is applied.

VERDICT
NOT PROVEN

WHY
The deploy job passed, but only four of six replicas are represented.

FALSIFICATION ATTEMPTS
- checked rollback events -> none found
- compared runtime image SHAs -> evidence exists for 4/6 replicas
- checked migration version -> no production schema evidence supplied

NEXT PROOF
1. read the image SHA from every replica
2. read the production migration version through an approved read-only path

The verdicts mean something

VerdictUse it when
PROVENDirect evidence covers the defined scope and meaningful attacks found no contradiction.
FAILEDDirect evidence contradicts the claim.
NOT PROVENAvailable checks ran, but the evidence is indirect, incomplete, stale, or too narrow.
BLOCKEDA required check cannot run because access, data, credentials, tools, or testability is unavailable.

PROVEN is deliberately scoped. Prove It does not claim mathematical proof, universal correctness, or future safety.

It catches the expensive kind of “done”

tests green             ≠ original bug fixed
build green             ≠ deployment works
deploy succeeded        ≠ every replica runs the new version
healthcheck 200         ≠ workers and dependencies are healthy
HTTP 200                ≠ asynchronous operation completed
no errors in these logs ≠ no relevant error occurred
one successful request  ≠ race condition fixed
agent confidence        ≠ evidence

It also watches for counterfeit proof: skipped tests, weakened assertions, ignored exit codes, empty catches, hardcoded results, behavior mocked away, and timeouts increased without reproducing the timing failure.

These patterns are not automatically wrong. They become evidence against a claim when they hide, bypass, or redefine the behavior being verified.

See EXAMPLES.md for deployment, logs, async work, payment races, positive proof, and blocked verification.

Vibe verification

Vibe verification is when an agent sees enough positive signals to feel confident and stops searching for ways the conclusion could be false.

Vibe verification:  “Tests pass. Looks good.”
Prove It:            “What would let these tests pass while the bug still exists?”

That shift is small, memorable, and useful across stacks because it changes the verification objective—not the test framework.

Evidence, not prompt theater

The repository includes a reproducible 12-case benchmark with:

  • misleading success signals that should end in FAILED;
  • incomplete evidence that should end in NOT PROVEN;
  • inaccessible evidence that should end in BLOCKED;
  • positive controls that should end in PROVEN.

One directional run with Codex CLI 0.147.0 · gpt-5.6-luna · low reasoning · 2026-08-18:

BaselineWith Prove It
Correct verdict9/12 (75%)12/12 (100%)
Positive controls2/3 (67%)3/3 (100%)
False assurance0/120/12
Attempted falsification12/1212/12

Prove It changed three decisions in this run: two explicitly unavailable proof paths were correctly labeled BLOCKED, and one fully covered, scoped deployment claim was accepted as PROVEN instead of remaining indefinitely unproven.

Every case uses the same model, prompt artifact, output schema, and reasoning setting. The treatment changes one thing: it installs and explicitly invokes Prove It. Read the 24 raw outputs and full benchmark/ methodology.

This is one run per cell on cases authored while developing the skill. It is evidence that the skill changed this model's behavior on this fixture set—not an independent study, a model ranking, or a universal performance claim.

The design is also grounded in a broader finding: language models can favor confirming evidence, and counterexample-oriented prompting can reduce that bias. See Failing to Falsify, Large Language Models Cannot Self-Correct Reasoning Yet, and Anthropic's work on sycophancy in language models. These sources motivate the mechanism; they do not prove this skill works for every model or task.

Frequently asked questions

What is Prove It?

Prove It is a small open-source Agent Skill that makes an AI coding agent define a falsifiable claim, search for counterevidence, verify the real outcome, and return an evidence-backed verdict.

Which AI coding agents does it support?

The skill follows the open Agent Skills specification and works with Claude Code, OpenAI Codex, Cursor, and other compatible coding agents. The repository keeps the behavior in one portable SKILL.md.

How is it different from testing or code review?

Tests and review produce evidence. Prove It changes how the agent challenges and interprets that evidence. It does not replace either one.

Can Prove It prove that software is correct?

No. It returns a scoped verdict from the checks and evidence that are actually available. It never claims formal correctness, universal safety, or certainty about unobserved behavior.

What this is not

Prove It is intentionally one readable SKILL.md. It has no runtime dependencies, hooks, background process, telemetry, MCP server, or orchestration layer.

It is not:

  • a testing framework or security scanner;
  • a replacement for domain-specific tests, observability, or human review;
  • permission to run destructive experiments against production;
  • a claim that an AI can prove arbitrary software correct.

It is a behavioral guardrail: define the claim, attack it, verify the outcome, and earn the verdict.

Small on purpose

prove-it/
├── README.md          # understand it in two minutes
├── README.*.md        # five localized guides
├── EXAMPLES.md        # six concrete uses
├── skills/prove-it    # the entire behavior
├── benchmark/         # reproducible evidence
└── LICENSE

The skill follows the open Agent Skills specification. Contributions are welcome when they make the core behavior sharper without turning the project into a framework.

AI writes the fix. Prove It tries to break it.

Created and maintained by PABLO.

Report a problem · Read the skill · Run the benchmark

// faq

What is prove-it?

Open-source adversarial verification Agent Skill for Claude Code, OpenAI Codex, and Cursor. Make AI coding agents prove bug fixes, CI, logs, and deployments.. It is open-source on GitHub.

Is prove-it free to use?

prove-it is open-source under the Apache-2.0 license, so it is free to use.

What category does prove-it belong to?

prove-it is listed under skills in the Claudeers registry of Claude-compatible tools.

2 views
15 stars
unclaimed
updated 3 days ago

// embed badge

prove-it on Claudeers
[![Claudeers](https://claudeers.com/api/badge/prove-it.svg)](https://claudeers.com/prove-it)

// retro hit counter

prove-it hit counter
[![Hits](https://claudeers.com/api/counter/prove-it.svg)](https://claudeers.com/prove-it)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/Shell272,506MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/Python169,406[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/Python129,208MIT[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/Python106,387MIT[ claude ]
→ see how prove-it connects across the ecosystem