verify-contract

verify-contract is a skill for Claude Code, Codex from tmusser/ai-engineering-skills. It costs 32 tokens per session (2,327 once invoked), scanned A, original, MIT.

A verification process that records evidence about whether a software task works and stayed within its agreed scope. It documents commands, results, acceptance checks, risks, and any required scope review.

In plain words
What is it for?
Use it after implementations, fixes, data runs, or smoke tests to update VERIFY.md, run available verification and scope checks, and record remaining uncertainty.
Why use it?
It replaces a vague claim that something works with an auditable record. It also catches changes that exceed the task's specification or approved write boundary.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is python scripts/scope_gate.py --base <frozen-base>.

Good fit Use it after implementations, fixes, data runs, or smoke tests to update VERIFY.md, run available verification and scope checks, and record remaining uncertainty.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/tmusser/ai-engineering-skills
agentmods
npx agentmods add skills/tmusser/ai-engineering-skills/verify-contract

Made for: Claude Code, Codex.

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 verify-contract

README.md
[![agentmods](https://agentmods.dev/badge/skills/tmusser/ai-engineering-skills/verify-contract/github.svg)](https://agentmods.dev/skills/tmusser/ai-engineering-skills/verify-contract)
Your own site
<a href="https://agentmods.dev/skills/tmusser/ai-engineering-skills/verify-contract"><img src="https://agentmods.dev/badge/skills/tmusser/ai-engineering-skills/verify-contract/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for verify-contract

Your own site · 80×15
<a href="https://agentmods.dev/skills/tmusser/ai-engineering-skills/verify-contract"><img src="https://agentmods.dev/badge/skills/tmusser/ai-engineering-skills/verify-contract.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 32 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,327 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.00032 $0.02327
Opus 5.5 $0.00013 $0.00931
Sonnet 5.5 $0.00006 $0.00465
Haiku 4.5 $0.00003 $0.00233

Measured 17d ago against content hash 381c613feea6, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

verify-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 17d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/verification_freshness.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

skills/verify-contract/SKILL.md · 262 lines

How it starts

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

Verify Contract

Purpose

Prove the task actually works and leave durable evidence.

Verification also checks that the implementation did not exceed the behavioral contract or frozen write boundary merely because the extra work looked reasonable.

When to use

After implementation, tests, bug fixes, data runs, or smoke checks.

Inputs

  • Task name
  • SPEC.md acceptance criteria, non-goals, constraints, invalid-if rules, and optional implementation diff budget
  • Optional persisted SCOPE.md plus its frozen Git base
  • Commands run or to run
  • Changed files
  • Evidence to record
  • Known risks or untested areas
  • Optional operator profile Verification depth

Workflow

  1. Update VERIFY.md with date + task name.

  2. Record commands run as short evidence entries with command, exit code, relevant output, interpretation, acceptance criterion covered, and remaining uncertainty. Keep each entry concise and auditable.

  3. For new verification records, maintain a machine-readable Structured verification evidence JSON block alongside the human-readable evidence. Use schema version 1 and one record per meaningful check with: check, command, exit_code, evidence_source, status, evidence, plus at least one of recorded_at or commit. Use null for command fields when evidence is manual or artifact-backed. Keep evidence short; do not copy raw logs or secrets into the JSON block.

  4. When SCOPE.md and scripts/scope_gate.py are available, run:

    python scripts/scope_gate.py --base <frozen-base>
    

    Record its status and relevant violations or review triggers. A scope-gate FAIL prevents PASS. REVIEW_REQUIRED also prevents PASS until the named review is resolved.

  5. If SPEC.md marks the compatibility probe gate REQUIRED, rerun every named probe after implementation and record matching post-change evidence under the same Probe ID. Missing or mismatched probe evidence requires review; an explicit failed post-change probe prevents PASS.

  6. If scripts/verify_gate.py is available, run it before marking verification complete. When SPEC.md declares an ENFORCED implementation diff budget, inspect the deterministic diff-budget result before PASS. Budget overruns are REVIEW_REQUIRED, not automatic functional failures. If repeated iterations were used, check for a loop contract, budget, ledger, revert rule, and stop condition before calling the work done.

  7. Before recording PASS, add or refresh the verification freshness anchors and stamp the repository snapshot:

Read the full file on GitHub · 262 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 17d ago Changed · +12 lines 381c613feea6
  2. 20d ago Changed · +32 lines 3d4642694180
  3. 21d ago Changed · +21 lines 9acd69edbfda
  4. 22d ago Changed · +28 lines 64d68a5bfd34
  5. 1mo ago First seen · 169 lines · 32 tokens per session scan A 9b2a0e9d60ff

Subscribe to this mod's changes

verify-contract is a skill published in the GitHub repository tmusser/ai-engineering-skills (6 stars, last pushed 5d ago), licensed MIT. It adds 32 tokens to every session and 2,327 once invoked, about $0.0001 per session on Opus 5.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

code-review

Use this skill to systematically review code changes for correctness, security, performance, maintainability, and test coverage. Activates after implementation, before merging, or when asked to review a pull request or code change. Produces a structured review report with findings categorized by severity.

karthikrshet/aiskills · 56 tokens

tdd

Use this skill to practice test-driven development — writing tests before implementation, using tests to drive design, and validating implementation against pre-written tests. Activates when implementing new functionality, refactoring code, or fixing bugs where regression coverage is needed.

karthikrshet/aiskills · 53 tokens

bug-diagnosis

Use this skill to systematically diagnose the root cause of a bug before attempting a fix. Activates when a bug is reported, a test is failing, or unexpected behavior is observed. Prevents guess-and-check debugging that introduces additional bugs while chasing symptoms.

karthikrshet/aiskills · 60 tokens

skill-release-gate

Evaluate an Agent Skill bundle for structural integrity, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity, and target-host portability before release.

rohitg00/ai-engineering-from-scratch · 36 tokens

mcore-testing

Test system for Megatron-LM. Covers test layout, recipe YAML structure, adding and running unit and functional tests, golden values, marker filters, and CI parity.

NVIDIA/skills · 38 tokens

i4h-catheter-navigation-e2e

End-to-end smoke for catheter navigation covering setup, digital twin, DRR, and unit tests. Use when asked to run the full catheter workflow smoke or demo the v0.7 pipeline.

NVIDIA/skills · 49 tokens