Search the docs, videos, blog, apps, teams, skills and release notes.
At a glance
What it is
First, the math of effort. A teammate handed five suggestions will pick the easiest two and call it done. A teammate handed one edit will do that edit and ship a meaningfully better piece. Constraint forces compounding.
A skill is a written procedure a bot loads when a job calls for it. This one is a single file, SKILL.md, and the whole file is on this page.
The whole file, exactly as it downloads. Read it before you rely on it.
SKILL.md
57 lines · 782 words
Mode skill. Default-enabled on the Verdict specialist.
Use at the close of every Verdict pass, after score-and-rank and flag-and-fix have produced their outputs. Use also when a teammate asks "if I could only do one thing, what would it be?" This is the discipline that prevents the verdict from drifting into a rewrite: a forced selection of the single change that would lift the piece furthest.
First, the math of effort. A teammate handed five suggestions will pick the easiest two and call it done. A teammate handed one edit will do that edit and ship a meaningfully better piece. Constraint forces compounding.
Nothing. It ships with Murage, which is open source. Your bots run on the AI plan you already have.
Yes. Open it in Settings → Skills to read, edit or duplicate it. Skill Guard scans it again after every edit.
Download the app, connect the AI you already pay for, and tell your Chief of Staff what needs doing. Plan on about ten minutes from install to a working team.
No account needed · Runs on the AI plan you already pay for
Paste it into your agent's instructions (CLAUDE.md, AGENTS.md or a custom GPT), or add it to a bot in Murage.
Ask Ember for the bot, then switch the skill on in its settings.
Step 1
Send your Chief of Staff this message. It proposes the bot and its role first, and creates it when you say go.
Send this to Ember
“Create a bot that uses the The One Edit skill, and show me the plan first.”
You're done when your Chief proposes the bot and its role, and the bot appears in your sidebar once you say go.
Step 2
You're done when you see the bot’s skills and the library.
Step 3
You're done when the skill shows as on for that bot.
Step 4
You're done when the bot takes the job and opens the skill when it needs it.
Prefer to do it yourself? Choose + in the sidebar, then New Bot.Read the full guide to skills and Skill Guard
What it teaches a bot, what it covers, and the whole file to read.
The principle
**Mode skill.** Default-enabled on the Verdict specialist.
What it covers
When to use
The one-edit principle
Procedure
Decision rules
Anti-patterns
Before / after
Each of these library teams gives its bots this skill. Import one and look inside first.
Two reasons to name one edit, not five.
First, the math of effort. A teammate handed five suggestions will pick the easiest two and call it done. A teammate handed one edit will do that edit and ship a meaningfully better piece. Constraint forces compounding.
Second, the math of attention. The audience does not care that you tightened the third paragraph if the headline is still a 5. Highest-payoff move first; the rest is grace. The one edit is the move that, applied alone, would move the audience experience furthest.
Cross-reference rubric and flags. Lay the eight scores beside the flag list. Where do they agree? A 5 in hook strength plus three unpaid-hook flags is a screaming match; that is the move. A 4 in clarity plus six ai-mush flags is the same. Convergence tells you where the payoff lives.
Test three candidates. For the two lowest rubric scores and the densest flag cluster, ask: if this one thing were fixed, where would the piece sit? Score the imagined-fixed version. The candidate that moves the average furthest is the edit.
Name the edit at the right altitude. Not too small ("change the verb in line three") — that is a copy edit, not a gate decision. Not too large ("rewrite the body") — that is a return-to-author, not an edit. The right altitude is one specific, scoped change: "Replace the opening line with a customer-voice pull from line nine." "Cut the second paragraph and merge the third into the CTA setup." "Move the proof point from paragraph four to under the hook."
State the lift. Name the dimension the edit moves and the rough magnitude. "Hook from 5 to 7, average from 6.4 to 6.8." The teammate sees the math; you keep yourself honest.
Stop there. Do not stack a second edit "while you're in there." Stack and the piece becomes a rewrite-by-creep. One edit.
The one edit is always something the teammate can do in under thirty minutes. A "one edit" that requires re-interviewing customers is a return, not an edit.
The one edit lifts a binding constraint. Lifting a 9 to a 10 is grace; lifting a 5 to a 7 is the real move. Choose the binding lift.
If the binding constraint is "voice match," the edit may be a route to Brand or Mira, not a copy change. State the route as the edit: "Run the draft through Mira's brand-voice pass before shipping."
If two dimensions tie for lowest and no single edit lifts both, name the one that protects the reader's first-three-seconds experience. Hook and platform fit beat clarity, which beats everything else, when nothing else breaks ties.
Hedging: "Either tighten the hook or cut the third paragraph — both would help." Pick. The teammate does not need a menu.
Naming an edit the teammate cannot act on without further inputs. "Add a stronger customer story" is not an edit; it is a research request. Either the story is in the draft material or it is not.
Stacking a "while you're at it" second edit. The discipline is one. Hold the line.
Naming an edit on a dimension already at 8+. You are improving the strong side of the piece while the weak side ships unchanged.
Brief: A founder-coach landing page hero block, score-and-rank returned an average of 6.5, flag list named hook strength (5), differentiation (5), and four ai-mush sentences clustered in the sub-headline.
Before (multi-suggestion verdict):
"Sharpen the hook, cut the ai-mush in the sub-head, add a proof point near the button, and tighten the bullet list."
After (one-edit verdict):
Replace the sub-headline with the verbatim founder quote sitting in line 14 of the brief ("I knew the strategy. I could not get my own calendar to obey me."). Lifts hook from 5 to 7 and differentiation from 5 to 7 in one move. Average moves from 6.5 to 7.4 — ships. Other flags can wait for the next pass.
SKILL.md
57 lines · 782 words
The text of SKILL.md is shown as it downloads, under the Apache-2.0 license, by Ferrox Labs. The license is the one in the file's own frontmatter.
Your new bot
The One Edit bot
Waiting in your sidebar once you say go.
No account needed · Runs on the AI plan you already pay for