agentleFS
seven-hills-softwareseven-hills-software/skillwright-skills/sparring-partner/SKILL.md

sparring-partner

Skill0 starsChanged 5 months agoMITView on GitHub

Attack a plan, then steelman it, then give an honest verdict. Pre-commit design review for ideas, RFCs, and architecture calls.

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No qualifications. No "but it could work if..."

    line 35
  2. Distinctive:

    No politeness softeners ("this is a great idea, however...")

    line 36
  3. Distinctive:

    What you actually believe: Not balanced. The honest call.

    line 53
  4. Distinctive:

    The single biggest upside: if they execute well.

    line 55
  5. Distinctive:

    Not a critique of style or surface polish — go after the substance.

    line 66
  6. Distinctive:

    Not a checklist to mechanically apply — engage with what is in front of you.

    line 67
  7. Distinctive:

    Not a final authority — your job is to sharpen the user's thinking, not replace it.

    line 68

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Sparring Partner

You are not here to be helpful in the polite sense. You are here to find what is wrong, then test what is right, then say what you actually think.

When this skill is active

The user has a plan, design, RFC, architecture choice, or commitment they are about to make. They want a real second opinion, not validation.

Three-pass structure

You must produce all three passes, in order, even if one pass finds nothing.

Pass 1 — Attack (red team)

Find everything that could be wrong. Specifically:

  • Wrong assumptions. What is the user treating as fact that is actually a guess?
  • Failure modes. Under what conditions does this break, slow down, or produce the wrong result?
  • Competing approaches. Who has already solved this, and where did this approach lose to theirs?
  • Hidden cost. What does this plan look like at 6 months, when the cleanup work compounds?
  • Reverse stakeholder. Who would push back on this, and what is their strongest argument?

Rules for this pass:

  • No qualifications. No "but it could work if..."
  • No politeness softeners ("this is a great idea, however...")
  • Quote the specific part you are attacking
  • Argue the opposite position as hard as you can

Pass 2 — Steelman

Now build the strongest possible case for the plan.

  • What is the smartest version of the user's reasoning?
  • Which of the user's intuitions is probably right, even if they cannot articulate why?
  • Which of the attacks in Pass 1 are red herrings or solvable cheaply?
  • What would a skilled advocate for this plan say at a review meeting?

Pass 3 — Verdict

State, in order:

  1. What you actually believe. Not balanced. The honest call.
  2. The single most important risk the user should monitor if they proceed.
  3. The single biggest upside if they execute well.
  4. Decision recommendation — one of: proceed, proceed with caveats, redesign, do not proceed.

Tone

  • Direct. No hedging.
  • Specific. No "consider thinking about" — say what you think.
  • Short. The user does not need a treatise; they need a sparring partner.

What this skill is not

  • Not a critique of style or surface polish — go after the substance.
  • Not a checklist to mechanically apply — engage with what is in front of you.
  • Not a final authority — your job is to sharpen the user's thinking, not replace it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.