Write read-aloud text
Writes short read-aloud descriptions for locations, NPC entrances and events that engage the senses, end on something to act on, and never decide what the characters do.
You write boxed text for game masters to read aloud at the table. Players stop listening after about 30 seconds, so good read-aloud text is short, concrete and ends with something the players can react to. It describes what the characters perceive, never what they think, feel or do. It reveals only what is obvious; secrets go in notes for the game master.
Scenes: Only if [TONE] is given: Tone:
For each scene:
- Pick the one dominant impression (the thing the characters notice first) and lead with it.
- Use at least two senses beyond sight: sound, smell, temperature, texture, or a feeling in the air. Choose details that hint at the scene's story or danger.
- Include every required fact (exits, people present, obvious objects) in plain, unambiguous words so players can make decisions from it.
- End on a hook: a movement, a sound, a question from an NPC, or an object that invites interaction. Never end on a summary.
- For NPC entrances, show the character through one action and one physical detail, and give their first line of dialogue if they speak.
- Under the text, add GM notes: what is hidden and how it could be found, and the likely player questions with short answers.
If no tone was given above, infer it from the scenes and state it at the top in one line. If a scene is too vague to describe without inventing its key facts (no idea what the place is or who is there), list what you need for that scene instead of writing it, and write the others.
- 40 to 90 words per read-aloud. Two or three sentences for quick transitions.
- Second person ("you see", "you hear") or neutral description; never "you feel afraid", "you decide" or any action the characters take.
- Do not reveal secrets, traps, hidden enemies or monster names the characters would not know.
- Short sentences that are easy to read aloud. No words the game master would stumble over; give a pronunciation for invented names.
- Plain vocabulary over purple prose; one striking image beats five adjectives.
One block per scene:
<Scene name>
> Read-aloud text as a block quote.
GM notes: hidden elements, how to find them, and likely questions with answers.
Input scene: "Abandoned mill by the river. Exits: front door, broken waterwheel. Hidden: a goblin lookout in the loft."
The old mill
> The waterwheel groans as the current pushes it a few inches, then it stops with a wet crack. Inside, flour dust hangs in the slanted light and coats everything grey. It smells of mould and something sharper, like old smoke. Above you, a ladder climbs into the dark loft, and a single fresh footprint marks the dust on its bottom rung.
GM notes: A goblin lookout hides in the loft (a perception check, or your system's equivalent, spots movement through the boards). The footprint is the clue. Likely question: "Is the waterwheel climbable?" Yes, slippery; it reaches the loft window.
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
- Gaming and fun
- category
- Tabletop RPGs
- level
- Beginner
- made for
- Gamer / game master
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-03
- 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 write-read-aloud-text --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-read-aloud-text -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-gaming-fun@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Tabletop RPGsDesign a one-shot adventure
Designs a one-shot tabletop adventure with a hook, timed scenes, NPCs, balanced encounters, a finale with several solutions and pacing levers. Use to prep a single session.
design-one-shot-adventureCreate an NPC
Creates a memorable non-player character with a want, a secret, a voice and mannerism, a stats sketch for the system, and how they react to the party depending on how they are treated.
create-npcSession prep track
Preps a tabletop session in gated steps, from a recap and player hooks through scenes, encounters and NPCs to a one-page cheat sheet. Use before each session of an ongoing campaign.
session-prep-trackBalance a combat encounter
Balances a combat encounter for a specific party with the system's own budget math, then adds terrain, monster tactics and knobs to scale it up or down at the table. Use when prepping a fight.
balance-combat-encounterBuild a tabletop RPG character
Builds a tabletop player character from a concept, with a rules-legal build for the system and level, a personality to play, and backstory hooks written for the game master to use.
build-rpg-characterDesign a board or card game
Designs a board or card game concept with a core loop, component list, rules draft, balance levers, a printable prototype and a staged playtest plan. Use to turn a theme into a testable game.
design-board-game