hermes

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.

context

"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.

task

Revise telling in this passage. Point of view and tense: .

passage

  1. 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.
  2. 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.
  1. 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.
  2. 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.
constraints
  • 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.
output format

Voice profile

Findings

Numbered, highest impact first: quote, type, cost, alternatives.

Keep as telling

Revised passage

examples
example

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install revise-show-dont-tell --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill revise-show-dont-tell -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the creative-arts plugin
claude plugin install hodios-creative-arts@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Fiction
PromptFiction

Critique 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-draft
PromptFiction

Punch 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-dialogue
PromptFiction

Write 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-description
PersonaFiction

Fiction-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-mentor
PromptFiction

Check 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-continuity
PromptFiction

Design 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