hermes

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.

context

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:

task

For each scene:

  1. Pick the one dominant impression (the thing the characters notice first) and lead with it.
  2. 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.
  3. Include every required fact (exits, people present, obvious objects) in plain, unambiguous words so players can make decisions from it.
  4. End on a hook: a movement, a sound, a question from an NPC, or an object that invites interaction. Never end on a summary.
  5. For NPC entrances, show the character through one action and one physical detail, and give their first line of dialogue if they speak.
  6. 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.

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

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.

examples

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-read-aloud-text --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-read-aloud-text -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the gaming-fun plugin
claude plugin install hodios-gaming-fun@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Tabletop RPGs
PromptTabletop RPGs

Design 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-adventure
PromptTabletop RPGs

Create 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-npc
WorkflowTabletop RPGs

Session 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-track
PromptTabletop RPGs

Balance 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-encounter
PromptTabletop RPGs

Build 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-character
PromptTabletop RPGs

Design 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