review-contract

review-contract is a skill for Claude Code from Rishi4792/compass. It costs 76 tokens per session (3,238 once invoked), scanned A, original, MIT.

A lightweight guide for finding weaknesses in a contract before it is finalized. Here, a contract is a precise agreement about what a feature or system must do.

In plain words
What is it for?
Use it to pressure-test a specification for completeness, clarity, testability, consistency, boundary cases, and feasibility.
Why use it?
It helps reveal missing requirements, ambiguous wording, hard-to-test behavior, inconsistent edge cases, and impractical constraints while changes are still inexpensive.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter. Also seen: names the AskUserQuestion tool.

Part of the compass plugin — 11 skills, 3 commands, 3 hooks shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/rishi4792/compass/review-contract
Any agent
npx skills add Rishi4792/compass --skill review-contract
Clone the repo
git clone --depth 1 https://github.com/Rishi4792/compass

Made for: Claude Code.

Or install compass, the plugin that ships this one along with the rest of its 11 skills, 3 commands, 3 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for review-contract

README.md
[![agentmods](https://agentmods.dev/badge/skills/rishi4792/compass/review-contract.svg)](https://agentmods.dev/skills/rishi4792/compass/review-contract)
Your own site
<a href="https://agentmods.dev/skills/rishi4792/compass/review-contract"><img src="https://agentmods.dev/badge/skills/rishi4792/compass/review-contract.svg" alt="Measured on agentmods" height="20"></a>
Per session 76 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,238 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00076 $0.03238
Opus 5 $0.00038 $0.01619
Sonnet 5 $0.00015 $0.00648
Haiku 4.5 $0.00008 $0.00324

Measured 6d ago against content hash 0f00869a1414, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

review-contract scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/compass/skills/review-contract/SKILL.md · 153 lines

How it starts

The opening of the file, as written. The whole thing — 153 lines — stays where its author put it; the contents beside it link to each section on GitHub.

compass:review-contract (Review-1 · LIGHT)

Lens: is the WHAT airtight? One focused pass; loop only if gaps.

Read these before you start. They are the standards this stage is held to, and they live in plugins/compass/shared/ so they are the same for every stage that uses them:

  • shared/review-core.md — the severity bug-bar, self-refutation and dedupe rules every review shares.

(A standard nobody loads is not a standard. shared/MANIFEST declares who reads each file and doctrine-wired-check.sh proves it — feynman.md sat unread for three releases while its own first line claimed three stages loaded it.)

Step 0a — the cheap checks run FIRST, before any reviewer is spawned

Run bash plugins/compass/scripts/mechanical-suite.sh . and read its output before doing anything else in this stage.

Why it comes first. The last release ran six independent adversarial reviews and they found 59 recorded defects. 32 of them — just over half — needed no judgment at all: a duplicate constant, a test whose population could be empty, a check nobody called, a shell mistake. A reasoning model was paid to find the fourth copy of a literal. The suite finds that whole class in seconds, for no tokens, and it runs before a reviewer is asked to look at anything.

What to do with it:

  • A MEASURED failure blocks this stage. Fix it and re-run. No reviewer should ever be handed a defect a script had already decided.
  • Its REPORTED lines are handed to the reviewers as context, not as findings — they are the things the suite could not decide, which is exactly where judgment is worth paying for.
  • If a reviewer finds a defect of a class the suite could have caught, ADD THE CLASS to plugins/compass/scripts/mechanical-suite-classes.md rather than re-reviewing it forever. That file is the registry; a class in it is a class no future review pays for twice.

Honest limit, stated so nobody over-trusts this. Only some defect classes are soundly mechanical — building this suite found that of five shell-trap classes exactly one could be decided by a line scan without failing on correct code. Every check therefore says whether it MEASURES or REPORTS. A green suite means the cheap classes are clear; it does not mean the work is right.

Read the full file on GitHub · 153 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 153 lines · 76 tokens per session scan A 0f00869a1414

Subscribe to this mod's changes

review-contract is a skill published in the GitHub repository Rishi4792/compass (2 stars, last pushed 4d ago), licensed MIT. It adds 76 tokens to every session and 3,238 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

simplify

Parallel code review and cleanup of recent changes. Three reviewers (reuse, quality, efficiency) propose behavior-preserving edits and the main agent applies them without asking. Use when asked to simplify, clean up, or tidy recent changes, or when /commit requests its cleanup pass.

gtapps/claude-code-hermit · 59 tokens

github-pr-review

Handles PR review comments and feedback resolution. Use when user wants to resolve PR comments, handle review feedback, fix review comments, address PR review, check review status, respond to reviewer, verify PR readiness, review PR comments, analyze review feedback, evaluate PR comments, assess review suggestions, or…

fvadicamo/dev-agent-skills · 95 tokens

github-pr-creation

Creates GitHub Pull Requests with automated validation and task tracking. Use when user wants to create PR, open pull request, submit for review, or check if ready for PR. Analyzes commits, validates task completion, generates Conventional Commits title and description, suggests labels. NOTE - for merging existing…

fvadicamo/dev-agent-skills · 75 tokens

spec-drift-check

Audits a WP brief for drift against current code — extracts claims, verifies each, emits PROCEED/STOP verdict. Use when starting a new WP, before consuming a spec as binding, or when a doc references paths/lines/functions.

QBall-Inc/the-bulwark · 54 tokens

tech-lead

Channel operator (IRC handle @techlead) for the mARC agent team. Compiles chat demands into ready-to-execute work, records them on the GitHub Project board/Issues, and dispatches to specialists (@dev, @sre, @design, @sec, @rev, @research). Invoke with /tech-lead to turn discussion into tracked, delegated tasks.

NexaDuo/mARC · 81 tokens

init

Opt-in onboarding for the mARC agent team. Scaffolds a per-repo team binding so the team graduates from ephemeral session-memory to persistent, versioned config — without ever writing a file silently. Discovers the repo's org/repo/ project at runtime via gh, prefills {{ agentsdir }}/team.toml, and (optionally) a lean…

NexaDuo/mARC · 122 tokens