Skip to content
cccskills
FreePublished on GitHub

perfection-review

Adversarial "perfection" review — hold a change to an *ideal* bar, not just a correct one, assuming eternal time, unlimited energy, and no ship pressure. Use when the user asks to review "for perfection", to make a defect "impossible to express", or to hunt where a defect "relocates" across review rounds. Grounds every claim in the diff, fans out adversarial verifiers via Workflow, and reports residual surfaces with a structural fix for each. ONLY invoke when the user explicitly asks for a perfection / ideal-bar review.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md3.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Perfection review

The bar is not "closed" but "the defect can no longer be expressed." Assume eternal time, unlimited energy, no deadline. "Overridable", "acceptable for scope", and "documented intent" are still holes.

Most defects are one shape in costumes. Name the shape, then hunt where it relocates — a fix that satisfies the literal ask but lets the defect resurface one seam over is not done. Track it across rounds until it has nowhere left to go.

Method

  1. Ground in the diff, not the story — the PR body, commit messages, docs, and the author's claims are assertions to falsify, not facts. Check them against the code.
  2. Letter vs effect — a safety added but never exercised is inert. Require a real path that uses it and a test that fails when it is removed.
  3. Unspellable > absent — make the wrong thing impossible to write, not merely discouraged. If a future author can still spell the defect, it isn't closed. Beware a guarantee that proves presence, not behaviour.
  4. Reconcile claim and code — an overclaiming comment or doc is itself a defect: make the code earn the sentence, or soften the sentence.
  5. Finish the blast radius — not done until every dependent and downstream is carried to the same bar and verified against the final state.

Verify adversarially — use Workflow

Review with fresh context, separate from the author — a reviewer carrying the author's context rationalizes the author's intent; a fresh mind grounded only in the diff does not. Fan out grounded verifiers (one per claim) plus an adversary whose only job is to express the defect anyway, each citing the diff; then synthesize. Default to refuted-if-uncertain, loop until nothing new surfaces, and re-verify the headline finding yourself. Keep agent schemas flat and isolate the adversary so one failure can't abort the run.

Report

Lead with credit for what's closed — don't move goalposts on done work — then the residual surfaces, ranked, each with its structural fix. Frame each finding as the invariant it violates, not a lone exploit: a single proof-of-concept trains a one-line patch and the defect just relocates — give the property, and if you must show an example, give a few from different angles and call it one costume of many. Separate "the product is fine" from "the claim isn't yet true". Post to the PR only when asked (--post).

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

be

Free

Modern, interactive alternative to `/do` — clarify intent up front, then take a task end-to-end with a serial AI review gauntlet (lens debate (lowy ⇄ hickey) → codex debate → simplify → code-police, each editing the branch in turn) → CI → evidence. ONLY invoke when the user explicitly types `/be` or `$be`; never auto-select from a natural-language request.

The English summary is being prepared. Showing the original description.

srid/emanote965Updated Jul 26, 2026

Run /be's review gauntlet SERIALLY — /lens-debate (lowy ⇄ hickey), then /codex-debate, then /simplify, then code-police, each editing and committing on the live branch in turn. Use from /be §4, or when the user asks to "run the review gauntlet". Requires Claude Code's Skill tool.

The English summary is being prepared. Showing the original description.

srid/emanote965Updated Jul 26, 2026

ci

Free

Reference for the `odu` runner — how to invoke a full pipeline, a single recipe, or a platform-pinned node, and how to attach to a live run, from a project whose CI odu runs. Trigger when the user asks to "run CI", "run the pipeline", "re-run a check", to run named lanes or recipes (e.g. "run fmt and nix", "just the e2e lane", bare selectors like `fmt`/`nix`/`e2e`), or names a recipe by `<recipe>@<platform>`. This skill — not a repo's local `just ci` / `just <recipe>` — is how an odu-run request is served.

The English summary is being prepared. Showing the original description.

srid/emanote965Updated Jul 26, 2026

Review code for quality, simplicity, and common mistakes before declaring work complete.

The English summary is being prepared. Showing the original description.

srid/emanote965Updated Jul 26, 2026

Run an automated codex⇄Claude debate to consensus — no round cap, no deadlock exit. Two explicit subcommands. `review` (also the bare/back-compat default) — codex (reviewer) critiques the current diff and a Claude subagent (author) fixes/disputes, looping until they agree. `answer` — Claude and codex each answer a freeform prompt in parallel, then cross-check until they agree, and a unified answer is returned. Use when the user types `/codex-debate`, asks to "have codex review this", "run the codex debate", "review this PR with codex", "argue this with codex until you agree", or passes a question to "have Claude and codex debate/answer until they agree".

The English summary is being prepared. Showing the original description.

srid/emanote965Updated Jul 26, 2026

do

Free

Do a task end-to-end — implement, PR, CI loop, ship. ONLY invoke when the user explicitly types `/do` or `$do`; never auto-select from a natural-language request, even one that sounds like an end-to-end task.

The English summary is being prepared. Showing the original description.

srid/emanote965Updated Jul 26, 2026

See all skills by srid

Report a problem with this skill