Revise telling into showing
Finds telling in a fiction passage (named emotions, filter words, summary where a scene belongs, explained subtext) and offers shown alternatives in the author's own voice. Use when revising a draft.
"Show, don't tell" is the most repeated and most misapplied advice in fiction. Telling is not wrong: summary moves time, compresses unimportant events and sets up scenes, and some voices (omniscient, comic, fable-like) rely on it. The problems are specific: emotions named instead of evoked ("she was furious"), filter words that put a pane of glass between reader and experience ("he saw", "she felt", "he noticed"), character traits asserted instead of demonstrated ("he was generous"), subtext explained right after a line of dialogue that already implied it, and an important dramatic moment summarised when it should play out as a scene. Generic "showing" fixes make prose worse: clichéd body language (clenched fists, racing hearts, released breaths), purple description and doubled length. A good revision shows through specific action, choice, dialogue, sensory detail and the character's distinct perception, in the author's voice.
Revise telling in this passage. Point of view and tense: .
- Voice profile: before suggesting anything, describe the author's voice in three or four lines: point of view and psychic distance, tense, typical sentence length and rhythm, diction (plain, lyrical, wry, clipped), and how they handle interiority. If is auto, state what you inferred. Every alternative must fit this profile.
- Findings: identify the telling that weakens the passage. For each instance:
- quote it exactly;
- classify it: named emotion, filter word, asserted trait, explained subtext, summarised scene, or abstract description;
- say what a reader loses (immediacy, tension, trust in the reader, characterisation);
- give one or two shown alternatives, each labelled with its technique (action or gesture specific to this character, a choice under pressure, dialogue or what is left unsaid, a concrete sensory detail filtered through this character, an image or comparison from the character's world). Rank findings by impact. List at most ten; if there are more, say how many and that the pattern repeats.
- Keep as telling: quote the telling that is doing its job (transitions, time compression, deliberate voice, a reveal after an earned scene) and say why it should stay. Do not convert everything.
- Revised passage: rewrite the passage applying the top alternatives, keeping every plot fact, every line of dialogue that does not change, the paragraph order and the author's sentence patterns. Keep it within about 130 percent of the original length. If the passage is longer than about 800 words, revise only the section with the most findings and say which.
- Do not use stock physical cues (clenched jaw, racing heart, breath she didn't know she was holding, eyes widening, stomach dropping) unless the voice is deliberately genre-pulp; prefer behaviour only this character would show.
- Do not add plot events, new characters, backstory or a change of point of view.
- Do not correct deliberate stylistic choices (fragments, omniscient commentary, comic narration); note them in Keep as telling if relevant.
- If the passage is too short or has no telling worth changing, say so plainly and give one or two craft observations instead.
Voice profile
Findings
Numbered, highest impact first: quote, type, cost, alternatives.
Keep as telling
Revised passage
Original: "Maria was nervous about the interview. She felt her hands shaking as she waited." Finding: named emotion plus filter word. Alternative (action specific to the character): "Maria read the job description a fourth time, then folded it into a smaller and smaller square until it would not fold any more."
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
- Creative arts
- category
- Fiction
- level
- Intermediate
- made for
- Writer / author, Editor
- 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
use in
npx @hermes-hq/hodios install revise-show-dont-tell --target claude-codenpx skills add hermes-hq/hodios-dist --skill revise-show-dont-tell -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-creative-arts@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of FictionCritique a fiction draft
Gives developmental feedback on a fiction draft covering point of view, pacing, stakes, character and dialogue, prioritised and without rewriting the author's prose. Use between drafts.
critique-fiction-draftPunch up dialogue
Revises a scene's dialogue for subtext, distinct voices and tension while keeping every plot beat intact, and explains each change. Use when dialogue reads stiff or expository.
punch-up-dialogueWrite a setting description
Writes setting descriptions filtered through a point-of-view character's senses, history and mood, in three lengths from a passing line to a full arrival passage. Use when a place feels flat.
write-setting-descriptionFiction-writing mentor
Fiction-writing mentor who protects the author's voice, asks craft questions before judging, and gives specific, prioritised notes. Use as a long-running writing companion for any project.
fiction-writing-mentorCheck story continuity
Finds continuity errors across chapters (names, timelines, physical details, objects, who knows what, world rules) and lists them by location with quotes. Use before beta readers or submission.
check-story-continuityDesign a plot twist
Designs plot twists that feel surprising yet inevitable, naming the reader's false assumption, the reveal, which clues to plant where and how to hide them. Use for novels and screenplays.
design-plot-twist