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.
What this skill does
# 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:
| Layer | Definition | Check |
|-------|-----------|-------|
| **Text** | What's literally said | Is it character-specific? Efficient? Natural rhythm? |
| **Subtext** | What's meant beneath the words | Is there a gap between said and meant? |
| **Context** | What shapes the exchange | Power 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
**Fix:** Let one character dominaRelated in Image & Video
watch
IncludedWatch a video (URL or local path). Downloads with yt-dlp, extracts auto-scaled frames with ffmpeg, pulls the transcript from captions (or Whisper API fallback), and hands the result to Claude so it can answer questions about what's in the video.
physical-ai-defect-image-generation
IncludedUse when the user wants to orchestrate defect image generation, run associated setup, or handle outputs on OSMO. The Day 0 path handles cold-start with USD-to-ROI, image-edit augmentation, and AnomalyGen to create initial PCBA datasets. The Day 1 path performs inference and labeling on real images. This skill helps with first-time asset setup, creation of finetuning checkpoints, and configuring deployment. Trigger keywords: defect image generation, dig workflow, dig pipeline, defect image detection workflow, aoi pipeline, aoi anomalygen, usd2roi anomalygen, day 0 pcba, day 1 pcba, day 1 real-photo alignment, day 1 manual roi, metal surface anomaly, glass defect, anomalygen finetune, setup_pcb, setup_metal, setup_glass, setup_pretrained, dig setup, dig datasets, dig pretrained checkpoint, dig image-edit endpoint.
accelint-react-best-practices
IncludedReact performance optimization and best practices. ALWAYS use this skill when working with any React code - writing components, hooks, JSX; refactoring; optimizing re-renders, memoization, state management; reviewing for performance; fixing hydration mismatches; debugging infinite re-renders, stale closures, input focus loss, animations restarting; preventing remounting; implementing transitions, lazy initialization, effect dependencies. Even simple React tasks benefit from these patterns. Covers React 19+ (useEffectEvent, Activity, ref props). Triggers - useEffect, useState, useMemo, useCallback, memo, inline components, nested components, components inside components, re-render, performance, hydration, SSR, Next.js, useDeferredValue, combined hooks.
elevenlabs-agents
IncludedBuild conversational AI voice agents with ElevenLabs Platform using React, JavaScript, React Native, or Swift SDKs. Configure agents, tools (client/server/MCP), RAG knowledge bases, multi-voice, and Scribe real-time STT. Use when: building voice chat interfaces, implementing AI phone agents with Twilio, configuring agent workflows or tools, adding RAG knowledge bases, testing with CLI "agents as code", or troubleshooting deprecated @11labs packages, Android audio cutoff, CSP violations, dynamic variables, or WebRTC config. Keywords: ElevenLabs Agents, ElevenLabs voice agents, AI voice agents, conversational AI, @elevenlabs/react, @elevenlabs/client, @elevenlabs/react-native, @elevenlabs/elevenlabs-js, @elevenlabs/agents-cli, elevenlabs SDK, voice AI, TTS, text-to-speech, ASR, speech recognition, turn-taking model, WebRTC voice, WebSocket voice, ElevenLabs conversation, agent system prompt, agent tools, agent knowledge base, RAG voice agents, multi-voice agents, pronunciation dictionary, voice speed control, elevenlabs scribe, @11labs deprecated, Android audio cutoff, CSP violation elevenlabs, dynamic variables elevenlabs, case-sensitive tool names, webhook authentication
humanizer
IncludedHumanize AI-generated text by detecting and removing patterns typical of LLM output. Rewrites text to sound natural, specific, and human. Uses 28 pattern detectors, 560+ AI vocabulary terms across 3 tiers, and statistical analysis (burstiness, type-token ratio, readability) for comprehensive detection. Use when asked to humanize text, de-AI writing, make content sound more natural/human, review writing for AI patterns, score text for AI detection, or improve AI-generated drafts. Covers content, language, style, communication, and filler categories.
generating-mermaid-diagrams
IncludedSalesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says "diagram", "visualize", "ERD", or asks for sequence diagrams, flowcharts, class diagrams, or architecture visualizations in Mermaid. DO NOT TRIGGER when: user wants PNG/SVG image output (use generating-visual-diagrams), or asks about non-Salesforce systems.