Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
jurgendn avatar

Theorem And Claim Audit

  • 41 installs
  • 1 repo stars
  • Updated July 31, 2026
  • jurgendn/agent-skills

Helps with security tasks.

About

theorem-and-claim-audit is a Claude Code skill for security. It helps solo builders move faster with AI-assisted development.

  • theorem-and-claim-audit
  • Security
  • AI-coding skill

Theorem And Claim Audit by the numbers

  • 41 all-time installs (skills.sh)
  • Ranked #1,410 of 2,203 Security skills by installs in the Skillselion catalog
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/jurgendn/agent-skills --skill theorem-and-claim-audit

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs41
repo stars1
Last updatedJuly 31, 2026
Repositoryjurgendn/agent-skills

What it does

Helps with security tasks.

Files

SKILL.mdMarkdownGitHub ↗

Theorem and Claim Audit

Audit the argument before polishing the writing.

The goal is not to make the claim sound stronger. The goal is to find the strongest version that is actually supported.

---

Procedure

1. Restate the Target Claim

Rewrite the claim precisely.

For mathematical claims, include:

  • objects;
  • assumptions;
  • quantifiers;
  • conclusion;
  • regime;
  • probability statement if applicable.

For empirical claims, include:

  • task;
  • dataset;
  • metric;
  • baseline;
  • claimed improvement;
  • causal wording if present.

Bad:

Our method is robust.

Better:

The proposed random-walk refinement improves ONMI over DF-Louvain
on dynamic LFR graphs under edge perturbation rates from 1e-5 to 1e-3.

---

2. List Explicit Assumptions

Extract all assumptions stated in the proof, theorem, experiment, or surrounding text.

Examples:

Mathematical assumptions:
- graph is connected;
- transition matrix is reversible;
- loss is convex;
- samples are IID.

Empirical assumptions:
- train/test split is fixed;
- baselines use the same input features;
- all methods use comparable tuning budgets.

---

3. Check Definitions and Notation

Verify that every object is defined before use.

Check:

  • overloaded symbols;
  • ambiguous graph direction or weights;
  • unclear probability space;
  • undefined convergence mode;
  • inconsistent metric definitions;
  • mismatched train/test notation.

Example failure:

The proof uses P as both a transition matrix and a probability measure.

---

4. Audit Each Logical Step

For each step, classify it as:

  • valid;
  • valid only under extra assumptions;
  • heuristic;
  • unsupported;
  • false.

Ask:

Does this follow formally?
Which theorem justifies it?
Are the theorem conditions satisfied?
Is there an unstated approximation?
Does the conclusion overreach the premises?

Example:

Step:
Use spectral decomposition of P.

Audit:
Valid only if P is reversible or otherwise diagonalizable
in a suitable basis.

---

5. Search for Hidden Assumptions

Look for unstated requirements such as:

  • smoothness;
  • boundedness;
  • compactness;
  • convexity;
  • independence;
  • stationarity;
  • reversibility;
  • identifiability;
  • concentration;
  • uniform convergence;
  • finite variance;
  • non-degeneracy;
  • fixed dimension;
  • large-sample asymptotics.

State where each hidden assumption enters.

---

6. Test Edge Cases and Counterexamples

Try to break the claim.

Useful stress cases:

  • disconnected graph;
  • bipartite graph;
  • complete graph;
  • star graph;
  • path graph;
  • sparse graph with isolated nodes;
  • degenerate distribution;
  • adversarial label imbalance;
  • small-sample regime;
  • non-IID samples;
  • equal baseline performance;
  • high variance across seeds.

Example:

If the graph is disconnected, global mixing claims fail
because no walk can cross components.

---

7. Audit Empirical Claims

For ML or experimental papers, check whether the evidence supports the wording.

Inspect:

  • metric-choice alignment;
  • baseline fairness;
  • hyperparameter tuning fairness;
  • data leakage;
  • seed variance;
  • ablation coverage;
  • compute budget;
  • dataset selection;
  • statistical significance;
  • causal language.

Example:

Claim:
The module improves reasoning.

Audit:
The reported metric only shows higher accuracy.
Without ablations, the result may be caused by extra parameters,
longer context, or stronger retrieval.

---

8. Downgrade Overclaims

If evidence is weak, replace strong language with a safer claim.

Examples:

Original:
The method solves dynamic community detection.

Safe:
The method improves ONMI on the tested dynamic LFR settings
relative to the selected baselines.
Original:
This proves robustness.

Safe:
This suggests robustness under the evaluated perturbation regime.

---

9. Report the Strongest Surviving Claim

End with the strongest claim that remains defensible.

It should be:

  • narrower if needed;
  • explicitly conditioned on assumptions;
  • separated from conjectures;
  • aligned with available evidence.

---

Rules

  • Prefer exactness over elegance.
  • If a proof is incomplete, state exactly where it breaks.
  • Downgrade claims when evidence is weaker than wording.
  • Distinguish theorem, lemma, heuristic, conjecture, and empirical observation.
  • Do not treat empirical improvement as mechanism validation.
  • Do not let clean notation hide missing assumptions.
  • Do not accept “obvious” steps without justification.
  • If multiple interpretations exist, choose the weakest interpretation that still supports the result.

---

Output Format

# Claim

State the audited claim in precise form.

# Assumptions

## Explicit Assumptions
List assumptions directly stated by the author.

## Hidden Assumptions
List assumptions required by the argument but not stated clearly.

# Valid Steps

List the parts of the proof or empirical argument that are justified.

# Gaps / Failure Points

For each gap, include:
- location;
- why it fails;
- what assumption or evidence is missing.

# Counterexamples or Stress Cases

List cases that could break or weaken the claim.

# Empirical Evidence Audit

Use this section only for experimental claims.

Check:
- metric alignment;
- baseline fairness;
- ablation sufficiency;
- seed/statistical stability;
- causal overclaiming.

# Revised Safe Claim

State the strongest defensible version of the claim.

# Verdict

Choose one:
- Accept as stated
- Accept with added assumptions
- Downgrade claim
- Treat as conjecture
- Reject current argument

Reason:
Give the shortest precise reason.

Related skills

Securityappsec

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.