hermes

Edit a draft for structure

Edits a non-fiction draft at the structural level, covering argument, order, misplaced and missing sections, with a reverse outline and a prioritised revision plan instead of line edits.

context

A structural (developmental) edit asks whether the piece is built right before anyone polishes sentences. Typical structural faults in non-fiction: the real thesis appears on page six; sections are ordered by how the author researched rather than how the reader needs to understand; two sections make the same point; a key step in the argument is missing or asserted without support; background swamps the argument; the ending summarises instead of concluding. The standard diagnostic is the reverse outline: write what each paragraph or section actually says and does, then compare it with what the piece needs to do. Line editing at this stage is wasted effort, because the sentences may be cut or moved.

task

Give a structural edit of this draft. Only if [PURPOSE] is given: Purpose and reader:

draft

  1. If the draft is clearly an excerpt of a longer piece (it starts or ends mid-argument, refers to sections that are not there, or is a single chapter of a book), say that a structural edit needs the whole piece, give at most three observations about the excerpt's internal order, and ask for the complete draft and its purpose; do not produce the full report. A short piece that is complete in itself (a one-page memo, a brief guide) gets the full edit, with the reverse outline done sentence group by sentence group.
  2. State the thesis or central claim as the draft currently makes it, quoting where it first appears. If no purpose was given, infer the purpose and reader and say so; if it is impossible to infer, ask and stop.
  3. Write a reverse outline: for each section (or each paragraph, for pieces under about 2,000 words), one line on what it says and one on what it does for the reader (sets up the problem, gives evidence, answers an objection, digresses).
  4. Diagnose structural problems against the purpose: buried or shifting thesis, order that does not follow the reader's questions, repetition, missing steps or evidence, misplaced material, sections out of proportion to their importance, a weak opening or ending, and missing signposting between parts. For each, point to the exact sections.
  5. Propose a revised structure as an outline: section headings that state the point, what each contains, and where existing material moves (by reverse-outline number). Mark new material needed as [NEW: …] and material to cut.
  6. Turn it into a revision plan ordered by impact: the change that fixes the most first.
constraints
  • Stay at the structural level. Do not rewrite sentences or correct grammar, except a suggested one-sentence thesis or a heading.
  • Respect the author's argument and voice. Your job is to make their piece work, not to change what it argues; if you think the argument itself is weak, say so once, with the reason, as a separate point.
  • Ground every criticism in specific sections or quotes. No generic advice ("add more detail").
  • Do not invent facts or evidence to fill gaps; describe what kind of evidence is missing.
  • Be direct and kind: name what works structurally so it is kept.
output format

Diagnosis

Three to five sentences: the thesis as it stands, the biggest structural problem and the main fix.

Reverse outline

Numbered list: Says | Does.

Structural problems

Numbered, most serious first: problem, where (section numbers or quotes), why it hurts this reader, fix.

Proposed structure

An outline with point-stating headings, the source of each part's material, [NEW: …] and [CUT] marks.

Revision plan

Numbered steps in order of impact, each a concrete task.

What to leave alone

Strengths to keep through the revision.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Writing and communication
category
Editing
level
Intermediate
made for
Writer / author, Editor, Researcher / scientist, Consultant / freelancer
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install edit-for-structure --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill edit-for-structure -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the writing-communication plugin
claude plugin install hodios-writing-communication@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Editing
PromptEditing

Tighten prose

Tightens prose by cutting filler, redundancy and weak verbs toward a target reduction while keeping the author's voice, meaning and necessary qualifiers, and reports what it cut.

tighten-prose
PromptEditing

Proofread a text

Corrects grammar, spelling, punctuation and consistency errors in the chosen English variety, preserving the author's voice, and lists each change with the rule behind it.

proofread-text
PromptEditing

Build an editorial style sheet

Builds an editorial style sheet from a manuscript, recording spelling, capitalisation, hyphenation, numbers, terms, names and formatting decisions, and flags every inconsistency with its locations.

build-style-sheet
PromptBusiness writing

Write an executive summary

Writes an executive summary of a long document that leads with the bottom line, the key points and the ask, using only facts from the source. Use before sending a report to busy readers.

write-executive-summary
PersonaEditing

Editor

Editor who serves the reader and the author's intent, edits at the right level with structure before lines, and explains every change so the author can accept, reject or learn from it.

editor
PromptEditing

Rewrite a text for tone

Rewrites a text in a target tone or register, such as warmer, firmer or more formal, without changing its facts, asks or commitments, and shows which tone dials moved.

rewrite-for-tone