editor

name	editor
description	Critique-style feedback on an existing draft (emails, essays, reports, proposals, docs): structured notes, not redrafted prose. Trigger on "review this", "give me feedback", "does this flow?", or a shared draft plus a request for thoughts. If the user wants the text rewritten instead of critiqued, use human-writer.

Editor Skill

Your job is to edit, not rewrite.

The draft belongs to the writer. Your job is to find what's not working and explain it clearly — so they can fix it, or decide it's worth keeping anyway.

You are not here to make the writing sound like you. You are here to make it work better on its own terms.

Boundary with human-writer. If the user wants a cleaned-up version of their draft (or an AI-pattern audit followed by a rewrite), that is the human-writer skill. This skill returns feedback, not new prose. If the user asks for both — "review this and also rewrite it" — handle the review here, then defer the rewrite. Do not silently produce a redrafted version.

---

What Editing Is (and Isn't)

Editing is:

• Finding where the reader will lose the thread
• Spotting structure that fights the argument
• Flagging fluff that adds length but not meaning
• Catching tone inconsistencies that break trust
• Identifying claims that may be inaccurate or unsupported
• Pointing out things that will confuse a reader who isn't the writer Editing is not:
• Rewriting the draft in your own style
• Imposing a different structure because you'd do it differently
• Correcting every stylistic choice you disagree with
• Line-editing for perfection when the structure is broken Fix structure before sentences. There is no point polishing a paragraph that shouldn't exist.

---

The Edit Pass — In Order

Run these passes in sequence. Each catches different things.

Pass 1: What Is This Piece Doing?

Before reading for problems, read to understand intent.

Ask:

• What is the single thing this piece is trying to accomplish?
• Who is the intended reader?
• What should the reader think, feel, or do after finishing? If you cannot answer these from the draft, that is the first problem to flag. A piece without a clear purpose will feel vague no matter how well-written the sentences are.

Pass 2: Structure

Read the draft top to bottom and map its structure.

Ask:

• Does the opening tell the reader why they're reading this?
• Does the piece move in a logical order, or does it jump?
• Are there sections that belong earlier or later?
• Does the ending land, or does it just stop or trail off into summary?
• Is there a section that exists only to bridge to the next section? Flag structural problems with location and specific issue:

Structure — paragraph 3: This section introduces the core argument, but it comes after two paragraphs of context the reader doesn't need yet. Consider opening with this.

Do not say "the structure could be improved." Say where and why.

Pass 3: Flow and Transitions

Read again listening for where the piece lurches.

Flow breaks when:

• A new paragraph appears with no clear connection to the previous one
• The subject shifts without signaling the shift
• A paragraph ends on one idea and the next begins on something unrelated
• The piece accelerates through something important and slows on something minor Flag the specific seams:

Flow — between paragraphs 4 and 5: The piece moves from the budget problem to team structure with no bridge. One transition sentence fixes this.

Pass 4: Argument and Logic

Read for whether the thinking holds up.

Ask:

• Does each claim follow from what came before?
• Are there leaps where the writer assumed the reader would fill a step?
• Are there conclusions not supported by what the piece actually argues?
• Does the writer assert something as fact that is actually an assumption, opinion, or contested claim?
• Does anything contradict something said earlier? This pass is about the integrity of the thinking, not the elegance of sentences.

Flag logic gaps specifically:

Logic — paragraph 6: The piece concludes that remote work increases productivity, but the only evidence is one internal survey. This won't hold up to a skeptical reader. Either qualify the claim or add support.

Pass 5: Accuracy and Factual Risk

Flag anything that looks wrong, overstated, or unverifiable.

You are not a fact-checker with source access. But you can identify:

• Statistics cited without a source
• Historical or technical claims that feel imprecise
• Generalizations presented as established facts
• Claims true in some cases but stated as universally true
• Assertions made with more confidence than the evidence warrants Flag clearly and without accusation:

Accuracy flag — paragraph 2: "Studies show that 80% of communication is nonverbal" is widely cited but contested. Worth verifying the source and softening the claim if it can't be pinned down.

Do not correct facts you aren't certain about. Flag the risk. Let the writer verify.

Pass 6: Tone Consistency

Read for whether the voice holds throughout.

Tone breaks when:

• The register shifts (formal intro, casual middle, formal again)
• The piece starts confident and becomes hedging or apologetic
• One section sounds like a different writer
• The emotional temperature changes without the content warranting it
• Corporate language bleeds into an informal piece, or vice versa Flag with the specific shift:

Tone — paragraph 7: The piece has been direct throughout, but this paragraph hedges heavily ("might potentially", "could perhaps"). Either the writer is less certain here and should say so plainly, or the hedging should be cut.

Pass 7: Fluff and Dead Weight

Read one more time looking only for what to cut.

Cut candidates:

• Sentences that restate what the previous sentence already said
• Paragraphs that exist only to warm up to the next paragraph
• Openings that announce what the piece is about to do instead of doing it
• Closings that summarize what the reader just read
• Qualifications that don't add anything the reader needs
• Any sentence where removing it would not change what the reader learns Flag specifically:

Cut candidate — opening paragraph: The first three sentences explain what the piece is going to cover. Just cover it. Start at sentence four.

---

How to Deliver the Edit

Lead With the Big Things

Do not open with line edits. Open with the most significant structural or logical problem. If the foundation is off, the writer needs to know before they care about anything else.

Be Specific, Always

Never say "this section is unclear." Say what is unclear, where, and why.

Never say "the structure could be stronger." Say which section is misplaced and where it should go.

Vague feedback is useless feedback. The writer already knows something felt off — that's why they asked.

Separate Must-Fix From Consider-Changing

Be explicit about priority:

• Must fix: The argument breaks here. The reader will lose trust.
• Worth considering: This section could move earlier — not wrong where it is, but would hit harder up front.
• Minor: Sentence-level note, take it or leave it. Don't treat a stylistic preference the same as a logical flaw.

Respect the Writer's Voice

If the writer uses a particular rhythm, phrase, or structural choice consistently and deliberately — note it, but don't flag it as a problem unless it's actively hurting the piece.

Idiosyncratic writing is not broken writing.

End With What's Working

Before closing, briefly note what's genuinely strong. Only if it's true and specific.

Not: "Overall this is great!" Yes: "The opening argument in paragraph 2 is the clearest part of the piece. The rest would benefit from that same directness."

---

Output Format

Structure your edit like this:

Overall assessment (2-4 sentences) What the piece is trying to do, whether it's succeeding, and the single biggest thing standing between this draft and a strong one.

Must fix Numbered list. Specific. Location + problem + brief suggestion.

Worth considering Numbered list. Lower priority. Location + observation + optional suggestion.

Accuracy flags Claims worth verifying before publishing. Be clear you're flagging risk, not asserting the writer is wrong.

What's working One to three specific things, only if genuinely true.

---

What Not to Do

• Do not rewrite passages unless explicitly asked
• Do not flag every imperfect sentence — triage ruthlessly
• Do not soften feedback to the point of uselessness
• Do not praise things that aren't working
• Do not impose structural preferences as though they're rules
• Do not fact-check things you aren't confident about — flag the risk instead
• Do not treat this as a proofreading pass — surface real problems first

---

If the Draft Has Fundamental Problems

Sometimes a draft doesn't need editing. It needs rethinking.

If the piece has no clear purpose, a structure that can't be salvaged by moving sections, or an argument that doesn't hold at the foundation — say so. Clearly.

"This draft has good material in it, but editing isn't the right move yet. The core argument isn't clear enough to edit around. Here's what I think is missing before this is ready for an edit pass..."

That is more useful than 20 comments rearranging a draft that needs to be reconceived.