dialogue-crafting
Create character-specific dialogue with distinct voices, subtext, and naturalistic speech patterns
Best use case
dialogue-crafting is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Create character-specific dialogue with distinct voices, subtext, and naturalistic speech patterns
Teams using dialogue-crafting should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/dialogue-crafting/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How dialogue-crafting Compares
| Feature / Agent | dialogue-crafting | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Create character-specific dialogue with distinct voices, subtext, and naturalistic speech patterns
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Dialogue Crafting Skill
## Purpose
Create distinctive, character-specific dialogue that reveals personality, advances plot, and creates subtext. Great dialogue sounds effortless but is carefully constructed to serve multiple purposes simultaneously.
## The 5 Functions of Dialogue
Every line should serve at least one:
| Function | Description | Example |
|----------|-------------|---------|
| **Character** | Reveals who they are | Vocabulary, syntax, rhythm |
| **Plot** | Advances the story | Information, decisions |
| **Conflict** | Creates tension | Opposition, evasion |
| **Subtext** | Says what isn't said | What they mean vs. say |
| **Atmosphere** | Sets mood/tone | Rhythm, word choice |
## Character Voice
### Voice Components
```
VOCABULARY
├── Education level (erudite vs. simple)
├── Regional dialect (y'all, eh, innit)
├── Professional jargon (cop, doctor, lawyer)
├── Era/period (23-skidoo, YOLO)
└── Cultural background
SYNTAX
├── Sentence length (short/punchy vs. long/flowing)
├── Grammar (proper vs. informal)
├── Contractions (can't vs. cannot)
└── Incomplete sentences
RHYTHM
├── Pace (rapid-fire vs. measured)
├── Pauses (significant silences)
├── Interruptions (talks over others)
└── Patterns (repeats certain phrases)
QUIRKS
├── Catchphrases
├── Verbal tics (um, like, you know)
├── Mispronunciations
└── Unique expressions
```
### Voice Examples
**Educated, Formal:**
```
"I find your proposition intriguing, though I confess
to harboring certain reservations regarding the
temporal constraints you've outlined."
```
**Street-Smart, Informal:**
```
"Look, you want my help? Fine. But we do this
my way, on my time. You don't like it?
Door's right there."
```
**Technical Professional:**
```
"The arterial damage is extensive. We're looking at
a six-hour procedure minimum, and even then,
the odds aren't great. Fifty-fifty at best."
```
## Subtext Techniques
### Surface vs. Underneath
**On the Nose (Bad):**
```
JOHN: I'm angry at you for sleeping with my best friend!
MARY: I'm sorry, I was lonely and he was there!
```
**With Subtext (Good):**
```
JOHN: How was your day?
MARY: Fine. Yours?
JOHN: Fine.
(beat)
Tom called. Asked about Saturday.
MARY: What did you tell him?
JOHN: That I'd check with you.
(long pause)
Should I call him back?
```
### Subtext Tools
1. **Deflection** - Answering a different question
2. **Silence** - What isn't said
3. **Actions** - Doing opposite of saying
4. **Understatement** - Saying less than meant
5. **Topic change** - Avoiding the real issue
6. **Questions** - Answering with questions
## Naturalistic Dialogue
### Real Speech Patterns
```
People actually:
- Interrupt each other
- Trail off mid-sentence...
- Use filler words (um, uh, well)
- Repeat themselves
- Speak in fragments
- Don't always respond directly
```
### Dialogue Example
```fountain
SARAH
So about last night--
MIKE
Yeah, about that. Look--
SARAH
No, let me--
MIKE
I just want to say--
SARAH
Mike.
(beat)
Let me talk. Please.
A long moment. Mike nods.
SARAH (CONT'D)
I... I don't know what I want
to say anymore.
```
## Dialogue Formatting
### Parentheticals
Use sparingly for:
- Tone that contradicts words: `(sarcastically)`
- Specific direction: `(to John)`
- Physical action with line: `(standing)`
**Don't** use for:
- Emotions the actor can interpret
- Directing the performance
- Every single line
### Beat
`(beat)` indicates a pause:
```fountain
JOHN
I love you.
(beat)
I always have.
```
### Overlapping Dialogue
```fountain
SARAH
I didn't mean to--
(overlapping)
MIKE
--you never mean to--
(overlapping)
SARAH
--if you'd just let me explain--
```
## Genre-Specific Dialogue
### Drama
- Subtext-heavy
- Emotional weight
- Character reveals
- Silences matter
### Comedy
- Setup/payback rhythm
- Surprise word choices
- Timing in phrasing
- Rule of threes
### Thriller
- Information control
- Tension building
- Double meanings
- Interrogation dynamics
### Action
- Short, punchy
- Physical verbs
- One-liners
- Under pressure
## Dialogue Checklist
- [ ] Could I identify the speaker without attribution?
- [ ] Is there subtext?
- [ ] Does it advance plot AND reveal character?
- [ ] Have I cut every unnecessary word?
- [ ] Does it sound speakable?
- [ ] Are the voices distinct?
- [ ] Is the rhythm varied?
- [ ] Does it create tension?
## Common Mistakes
1. **Exposition dumps** - Characters telling each other what they both know
2. **On the nose** - Saying exactly what they mean
3. **Same voice** - All characters sound alike
4. **Over-explaining** - Not trusting the audience
5. **Perfect grammar** - Real people don't speak perfectly
6. **Pointless chitchat** - Every line must earn its place
## Quick Fixes
| Problem | Solution |
|---------|----------|
| Too expository | Make them argue about it instead |
| Too long | Cut to essential meaning |
| Too similar | Add contrasting vocabulary |
| Too formal | Add contractions, fragments |
| Too perfect | Add interruptions, hesitation |Related Skills
dialogue-ai
Dialogue system skill for branching conversations and response generation.
socratic-dialogue-facilitation
Lead philosophical inquiry through structured questioning, elicit assumptions, expose contradictions, and guide interlocutors toward deeper understanding
process-builder
Scaffold new babysitter process definitions following SDK patterns, proper structure, and best practices. Guides the 3-phase workflow from research to implementation.
babysitter
Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called explicitly. (babysit, babysitter, orchestrate, orchestrate a run, workflow, etc.)
yolo
Run Babysitter autonomously with minimal manual interruption.
user-install
Install the user-level Babysitter Codex setup.
team-install
Install the team-pinned Babysitter Codex workspace setup.
retrospect
Summarize or retrospect on a completed Babysitter run.
resume
Resume an existing Babysitter run from Codex.
project-install
Install the Babysitter Codex workspace integration into the current project.
plan
Plan a Babysitter workflow without executing the run.
observe
Observe, inspect, or monitor a Babysitter run.