One-click install
npx skills add https://github.com/AndreaGriffiths11/proof-agent --skill proof-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proof-agent
Source: https://github.com/AndreaGriffiths11/proof-agent/tree/main
Command: npx skills add https://github.com/AndreaGriffiths11/proof-agent --skill proof-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proof Agent prevents AI-generated code changes from slipping through review by requiring an independent verifier to check security, correctness, and factual claims using concrete evidence rather than self-approval.

Core Features & Use Cases

  • Adversarial, separate-agent verification: Spawns an independent verifier so the worker cannot validate its own output.
  • Static diff-based security review: Reviews the git diff without executing code or running tests, and requires specific file/line/snippet evidence for verdicts.
  • Auto-verify triggers for high-risk edits: Verifies automatically when enough files change or when sensitive patterns appear (auth/secret/permission, Dockerfile, .env).

Quick Start

Tell your agent: “Verify that this change is safe for production and report PASS, FAIL, or PARTIAL with file/line evidence.”

Frequently Asked Questions about proof-agent

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

FAQPage Schema
How do I verify AI-generated code changes in a pull request are safe?

Verify AI-generated code changes by applying adversarial separation between a worker and an independent verifier. The verifier performs static analysis on the git diff to check security, correctness, and factual claims, producing a PASS, FAIL, or PARTIAL verdict with concrete file and line evidence.

What is adversarial verification for static code analysis?

Adversarial verification is a static code analysis method that prevents a worker agent from validating its own output. It spawns an independent verifier to check the git diff for security and correctness issues, ensuring code changes are backed by evidence rather than self-approval.

How do I review a git diff for secrets and sensitive environment edits without executing code?

Review a git diff for secrets and sensitive edits by running static analysis without executing code or tests. The verifier automatically triggers when sensitive patterns like auth, permissions, Dockerfiles, or .env files appear, requiring specific file and line evidence for its verdicts.

Can I use this static analysis tool with GitHub Actions agent workflows?

Yes, this static analysis tool applies to pull-request and agent workflows within GitHub Actions. It enforces adversarial verification of git diffs to block unsafe AI changes, automatically triggering when enough files change or sensitive patterns appear.

Does the verifier require test execution to check pull request correctness?

No, the verifier does not require test execution to check pull request correctness. It relies entirely on static analysis of the provided git diff, reviewing security, correctness, and factual claims without executing any code or sharing the worker's self-assessment.

What is Proof Agent and how does it block unsafe AI changes?

Proof Agent blocks unsafe AI changes by enforcing an independent verifier to review git diffs. It checks security, correctness, and factual claims using concrete evidence, requiring exactly one verdict heading to ensure changes are safe for production.