build-until-agreed

build-until-agreed is a skill for Claude Code from mostafa-drz/claude-skills. It costs 209 tokens per session (2,936 once invoked), scanned A, original, MIT.

A build-and-review workflow that defines what “done” means before coding, then asks independent auditors to inspect the result. It verifies reported problems and repeats building, auditing, and fixing until the stated checks pass and no verified blocking issue remains.

In plain words
What is it for?
Use it for changes that need an agreed contract, independent read-only review, verification of findings, and a final test or harness check before a human merges the branch.
Why use it?
It reduces the chance that the person who wrote the code is also the only person deciding whether it is finished. It also prevents unverified audit claims from driving unnecessary fixes.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions subagents.

Good fit Use it for changes that need an agreed contract, independent read-only review, verification of findings, and a final test or harness check before a human merges the branch.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mostafa-drz/claude-skills/build-until-agreed
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.

Any agent
npx skills add mostafa-drz/claude-skills --skill build-until-agreed
Clone the repo
git clone --depth 1 https://github.com/mostafa-drz/claude-skills

Made for: Claude Code.

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 build-until-agreed

README.md
[![agentmods](https://agentmods.dev/badge/skills/mostafa-drz/claude-skills/build-until-agreed/github.svg)](https://agentmods.dev/skills/mostafa-drz/claude-skills/build-until-agreed)
Your own site
<a href="https://agentmods.dev/skills/mostafa-drz/claude-skills/build-until-agreed"><img src="https://agentmods.dev/badge/skills/mostafa-drz/claude-skills/build-until-agreed/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 build-until-agreed

Your own site · 80×15
<a href="https://agentmods.dev/skills/mostafa-drz/claude-skills/build-until-agreed"><img src="https://agentmods.dev/badge/skills/mostafa-drz/claude-skills/build-until-agreed.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 209 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,936 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.00209 $0.02936
Opus 5.5 $0.00084 $0.01174
Sonnet 5.5 $0.00042 $0.00587
Haiku 4.5 $0.00021 $0.00294

Measured 1mo ago against content hash 29cf86b53068, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

build-until-agreed 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 1mo 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.

code/build-until-agreed/SKILL.md · 202 lines

How it starts

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

Build Until Agreed

The builder is the worst judge of whether the work is done. This skill writes down what "done" means before building, then lets independent auditors decide — and checks their claims before acting on them.

Standing rules — they hold for the whole run, every round:

  1. Problem first. No contract without a named user and the pain it removes. If there isn't one, say so and stop — we don't build for the sake of building.
  2. Auditors are blind and read-only. Fresh, unnamed, never fork — each round. They get the contract file, the commit range and the harness — never the ledger, the builder's reasoning, earlier findings, or each other's verdicts. The ledger is git-ignored, so no commit range can show it to them.
  3. Nothing is fixed until it is verified. A blocking finding is a claim until a separate verifier reproduces it. Documented decisions are not defects.
  4. Freeze while auditing. Commit before a round; no edits until every auditor returns.
  5. Prefer cutting to adding. Before each fix, name what it protects. If nothing, cut.
  6. Never merge. Never push to the default branch. Work on a branch; the human merges. This is enforced here, in the workflow — Bash(git *) does not enforce it.
  7. Explain progress. After every round, print the round block (see reference/contract-and-ledger.md) so the user always knows where things stand and why.

Preferences

On startup, use Read to load ~/.claude/skills/build-until-agreed/preferences.md. If it is missing, use these defaults and show the first-run intro from reference/contract-and-ledger.md. Write the file after the first completed round.

  • auditors: 3 · max-rounds: 5 · bar: poc · review-bot: greptile or off (asked in the contract)
  • lenses: adopter, correctness, risk-and-simplicity (defined in reference/auditors.md)
  • Contract: .build-until-agreed/<slug>.contract.md in the target repo (committed)
  • Ledger: .build-until-agreed/<slug>.ledger.md next to it, git-ignored by a committed .build-until-agreed/.gitignore containing *.ledger.md — never committed, never in a diff, never in the PR, and not a protected path (.git and .claude writes always prompt)

Read the full file on GitHub · 202 lines

Files

What ships with it

5 files 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. 1mo ago First seen · 202 lines · 209 tokens per session scan A 29cf86b53068

Subscribe to this mod's changes

build-until-agreed is a skill published in the GitHub repository mostafa-drz/claude-skills (4 stars, last pushed 20d ago), licensed MIT. It adds 209 tokens to every session and 2,936 once invoked, about $0.0008 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-09-16.

Related

Other skills, from other repositories

omh-verification-gate

This is an OMH verification-gate workflow skill, projected for Agent Skills hosts (Claude Code, Codex, Cursor, opencode, OpenClaw, pi).

rlaope/oh-my-hermes · 79 tokens

remove-ai-slops

Removes AI-generated code smells from branch changes or an explicit file list behind regression tests. Use when the user asks to clean up, deslop, or remove AI-slop patterns from recent changes.

code-yeongyu/oh-my-openagent · 45 tokens

codex-ab

Run an A/B codex review experiment — holistic codex review vs 3 focused dimension passes (security, ecto, liveview) on the branch diff, classify findings, report a panel-value verdict. Use when the branch is fresh, before any codex review runs.

oliver-kriska/claude-elixir-phoenix · 60 tokens

059-design-atdd

Use when reviewing whether an OpenSpec change's execution goal, acceptance criteria, and implementation or verification tasks are aligned. This should trigger for requests such as Review this OpenSpec change with ATDD; Check acceptance criteria against tasks; Find acceptance criteria without task coverage; Detect…

jabrena/plinth · 93 tokens

056-design-avoid-breaking-changes

Use when you need to review a plan, OpenSpec change, specification, or implementation proposal for breaking-change risk across commands, skills, generated outputs, XML sources, README/docs, tests, CI, APIs, schemas, configuration, data, migration, and release guidance. This should trigger for requests such as Review…

jabrena/plinth · 106 tokens

053-design-simple-rules

Use when Java design, refactoring, or implementation tradeoffs should be evaluated with Kent Beck's simple design rules, including passes the tests, reveals intention, has no duplication, and has the fewest elements. This should trigger for requests such as Apply simple design rules; Review this design with Beck's…

jabrena/plinth · 86 tokens