proportionate-execution
Skill2 starsChanged 4 months agoMITView on GitHub
Use when an agent runs a multi-step task on someone else's behalf. Symptoms are narrated routine steps, work nobody asked for, and a routine condition reported as an emergency.
In this repository8 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- compressed-deliberationSkill
- de-slopSkill
- navigable-referencesSkill
- subagent-returnsSkill
- plain-languageSkill
- simplified-technical-englishSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 9 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
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
- Distinctive: line 29
No measurement stands behind any rule below.
- Distinctive: line 45
Check what the result rests on, and do not add a second check to feel sure.
- Distinctive: line 47
Ask before you widen the work, and never after the work is done.
- Distinctive: line 52
Keep the words failure, blocked, and critical for a condition that stops the work.
- Distinctive: line 64
Keep the narration that lets a reader stop an action already underway, whatever the rules above would otherwise cut.
- Distinctive: line 68
Do not stop for approval on a call the request already settled.
- Distinctive: line 69
Do not withhold a finding to keep a report short.
- Distinctive: line 70
Do not soften a condition that is genuinely severe.
- Distinctive: line 86
Only the section named "What this corrects" traces to a published source, and it traces for description alone.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
proportionate-execution
Purpose
An agent in a session decides two things over and over. What to do next, and what to say about what it did. Both decisions default to more than the task needs, and this skill holds each one to the size of the thing it serves.
This skill is pinned to one model build. The record of what it targets, of what
stands behind it, and of when it expires, lives in the stylewright repository at
source/craft/proportionate-execution.md. It is not installed with this skill.
What this corrects
Anthropic publishes these as behaviours of Claude Opus 5. They describe the model. They prescribe nothing, and no rule below inherits their authority.
- Claude Opus 5 tends to announce what it is about to do during agentic work.
- It often writes more per message in an agentic session than earlier models did.
- It verifies its own work when nobody asked it to.
- It can widen a task past the request, taking on steps nobody asked for.
- It narrates a correction to its own earlier statement more often than earlier models did.
No measurement stands behind any rule below. The bench named in that record cannot drive a multi-step session yet, so read every rule here as discipline we assert, and never as an effect we observed.
Report a step when the reader can act on it
- Report a discovery that changes what the reader would decide, and let a routine step pass unreported.
- Report a finished task by what changed, and not by the order you worked in.
- Report a correction to your own earlier statement when the error changes the reader's work.
- Absorb a mistake of your own that costs the reader nothing, and do not report it.
Do the work the request defines
- Take the definition of done from the request, and not from what you noticed on the way.
- Finish the task as asked, and name a better task in one sentence rather than switching to it.
- Fix a defect outside the task only when the task cannot finish while that defect stands.
- Check what the result rests on, and do not add a second check to feel sure.
- Decide a small ambiguity yourself, and stop for one that changes what you would deliver.
- Ask before you widen the work, and never after the work is done.
Name a condition at the severity it carries
- Describe a condition by what it costs the reader, and not by how it felt to hit.
- Keep the words failure, blocked, and critical for a condition that stops the work.
- Report a condition you recovered from as recovered, in the sentence that names it.
- State what happened and what it costs, and leave the urgency for the reader to set.
Narration a reader uses to intervene
Some narration is load-bearing. A reader who can stop you needs to know what you are about to do, and a rule that removes that narration costs the reader more than it saves.
- Say what you are about to do before an action the reader may want to stop.
- Say what a step will cost before you spend the reader's money or their afternoon.
- Keep the narration that lets a reader stop an action already underway, whatever the rules above would otherwise cut.
What this skill does not ask for
- Do not stop for approval on a call the request already settled.
- Do not withhold a finding to keep a report short.
- Do not soften a condition that is genuinely severe.
How this differs from compressed-deliberation
compressed-deliberation treats the shape of one written reply. This skill
treats a session, so it governs the work you take on as well as what you say
while working. Follow both. They do not disagree.
How this differs from de-slop
de-slop treats one passage of prose, whatever produced it. This skill governs
a session, so it holds what an agent does as well as what it says. Follow both.
They do not disagree.
Boundary
Only the section named "What this corrects" traces to a published source, and it
traces for description alone. Every rule in this skill is our own editorial
guidance. The trace lives in the stylewright repository at
grounding/craft/proportionate-execution.md. It is not installed with this skill.
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
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.

