jwynia/agent-skillsMIT3 files

Dialogue

Diagnose flat dialogue, same-voice characters, and lack of subtext. Use when conversations feel wooden, characters sound alike, or dialogue only does one thing at a time.

Specification
Skill ID
jwynia/agent-skills/dialogue
Publisher
jwynia
Repository
agent-skills
Installs
0
Files
3
License
MIT
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

jwynia/agent-skills/dialogueInstalls these files
  • SKILL.md
  • scripts/dialogue-audit.ts
  • scripts/voice-check.ts

What this skill tells the agent

Dialogue: Diagnostic Skill

You diagnose dialogue-level problems in fiction. Your role is to identify why conversations feel flat and guide writers toward dialogue that does multiple things simultaneously.

Core Principle

Dialogue must do more than one thing at a time or it is too inert for the purposes of fiction. (Sloane, 1979)

Good dialogue simultaneously advances plot, reveals character, builds tension, establishes relationship dynamics, and creates subtext. If dialogue is only delivering information, it's failing.


The Three Layers

Every line of dialogue operates on three layers:

LayerDefinitionCheck
TextWhat's literally saidIs it character-specific? Efficient? Natural rhythm?
SubtextWhat's meant beneath the wordsIs there a gap between said and meant?
ContextWhat shapes the exchangePower dynamics? History? What each character wants?

When dialogue fails, it usually fails at Layer 2 (no subtext) or Layer 1 (undifferentiated voices).


The Dialogue States

State D1: Identical Voices

Symptoms: All characters sound the same. Covering dialogue tags makes speakers indistinguishable. Vocabulary, rhythm, and sentence structure are uniform across characters.

Key Questions:

  • Can you identify speakers without tags?
  • Does education/background show in speech patterns?
  • Do characters have verbal tics, catchphrases, or avoidances?
  • Does emotional state affect speech differently per character?

Diagnostic Checklist:

  • [ ] Vocabulary range differs between characters
  • [ ] Sentence complexity varies by character
  • [ ] Directness levels differ (blunt vs. circumlocutory)
  • [ ] Each character has something they never say or topics they avoid

Interventions:

  • Profile each character's speech patterns separately
  • Read dialogue aloud, voice each character distinctly
  • Give each character a verbal tic and a verbal avoidance
  • Use voice-check tool for quantitative analysis

State D2: Wooden Dialogue

Symptoms: Dialogue feels stilted, formal, unnatural. Characters speak in complete grammatical sentences. No contractions. No interruptions. No fragments.

Key Questions:

  • Are characters speaking in formal, complete sentences?
  • Is the dialogue too clean for the context?
  • Are there contractions? Fragments? Interruptions?
  • Does it sound natural when read aloud?

Diagnostic Checklist:

  • [ ] Characters use contractions appropriately
  • [ ] Some sentences are incomplete or interrupted
  • [ ] Dialogue has rhythm variation (not metronomic)
  • [ ] Characters occasionally talk past each other

Interventions:

  • Read every line aloud - if you can't say it naturally, rewrite it
  • Let characters interrupt each other
  • Cut complete sentences into fragments where natural
  • Add verbal stumbles where emotionally appropriate

State D3: Exposition Dump

Symptoms: Characters explain things they'd both already know. One character asks questions just so another can explain. "As you know, Bob..." syndrome.

Key Questions:

  • Are characters telling each other things they'd already know?
  • Is one character functioning as audience stand-in?
  • Is information delivery the primary purpose?
  • Could this information be discovered rather than explained?

Diagnostic Checklist:

  • [ ] No "As you know..." constructions
  • [ ] Characters disagree about information (not just relay it)
  • [ ] Information emerges from conflict, not lecture
  • [ ] Reader discovers alongside character when possible

Interventions:

  • Find conflict in the information - let characters disagree
  • Have someone discover information on-page
  • Break exposition across multiple scenes
  • Let characters get facts wrong and be corrected

State D4: No Subtext (On-The-Nose)

Symptoms: Characters say exactly what they mean, feel, and want. No gap between surface and meaning. Dialogue lacks dramatic tension because everything is explicit.

Key Questions:

  • Are characters stating feelings directly? ("I'm angry")
  • Is there a gap between what's said and what's meant?
  • Do characters have hidden agendas in conversations?
  • What are characters NOT saying that matters?

Diagnostic Checklist:

  • [ ] Emotional states shown through behavior, not declared
  • [ ] Characters want things they can't ask for directly
  • [ ] Body language can contradict words
  • [ ] What's unsaid is as important as what's said

Interventions:

  • Give each character a hidden agenda for every conversation
  • Convert direct statements to indirect expressions (jealousy → comment on someone's "nice corner office")
  • Add body language that contradicts or complicates words
  • Ask: what would this character never admit out loud?

State D5: Single-Function Dialogue

Symptoms: Dialogue accomplishes one thing (usually plot information) but nothing else. Conversations feel functional but inert. No relationship shift, no character revelation, no tension.

The Double-Duty Test: For every exchange, you should be able to answer at least three:

  1. What does this accomplish for plot?
  2. What does it reveal about character?
  3. What is the subtext?
  4. How does it affect the relationship?

Diagnostic Checklist:

  • [ ] Each conversation advances plot AND reveals character
  • [ ] Relationship between speakers shifts during exchange
  • [ ] Something changes by end of conversation
  • [ ] Scene ends at different emotional point than it began

Interventions:

  • Refuse single-function dialogue - always add second purpose
  • Track what each character wants vs. what they say they want
  • End scenes at changed state, not just information transferred
  • Use dialogue-audit tool to check function coverage

State D6: Pacing Mismatch

Symptoms: Dialogue pacing doesn't match scene needs. Tense moments have leisurely exchanges. Calm moments have rapid-fire dialogue. No rhythm variation within scenes.

Key Questions:

  • Does dialogue speed match emotional intensity?
  • Is there rhythm variation within the scene?
  • Are action beats and pauses used to control pacing?
  • Do important moments get appropriate emphasis?

Pacing Tools: | Fast Pacing | Slow Pacing | |-------------|-------------| | Short exchanges | Longer speeches | | Minimal/no tags | Pauses described | | No action beats | Action beats between lines | | Interruptions | Reflection embedded |

Interventions:

  • Quicken dialogue as tension rises
  • Slow down for emotional weight
  • Use silence and pause deliberately
  • Vary exchange length within scenes

Anti-Patterns

The Exposition Dump

Pattern: "As you know, Bob, our company was founded in 1985 when your father and my uncle..." Problem: Characters explain mutual knowledge for reader benefit Fix: Find conflict in information or discover it on-page

The Identical Twins

Pattern: Every character uses same vocabulary, rhythm, directness Problem: Voices indistinguishable without tags Fix: Profile each character's speech patterns; give distinct verbal DNA

The Court Reporter

Pattern: "Um, hi." "Oh, hey, yeah, so..." "Right, right." Problem: Realistic but dramatically dead - fiction dialogue is compressed reality Fix: Cut to the meaningful; small talk only if it reveals character

The Emotional Narrator

Pattern: "she said angrily," "he replied nervously," "she exclaimed furiously" Problem: Tags doing dialogue's job; telling not showing Fix: Let words and actions carry emotion; use "said"

The Philosopher

Pattern: Characters articulate themes, lessons, or subtext explicitly Problem: Trust removed from reader; preachiness Fix: Trust readers to infer meaning from behavior and implication

The Tennis Match

Pattern: Perfectly alternating, evenly-sized responses, no interruption or power differential Problem: Unnaturally balanced; no one dominates or defers

Use this skill in a project

Open any RiverX project, search the Skills panel for jwynia/agent-skills/dialogue, and install it in one click.

Use this skill