audio-storytelling

Audio storytelling skill used by the podcast scriptwriter and show note editor. Provides narrative structure, pacing, and sound design methodologies that maximize listener immersion in an audio-only medium. Use this skill's knowledge for 'audio narrative,' 'listener retention,' 'story arc,' 'sound design,' and similar requests.

495 stars

Best use case

audio-storytelling is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Audio storytelling skill used by the podcast scriptwriter and show note editor. Provides narrative structure, pacing, and sound design methodologies that maximize listener immersion in an audio-only medium. Use this skill's knowledge for 'audio narrative,' 'listener retention,' 'story arc,' 'sound design,' and similar requests.

Teams using audio-storytelling 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

$curl -o ~/.claude/skills/audio-storytelling/SKILL.md --create-dirs "https://raw.githubusercontent.com/revfactory/harness-100/main/en/02-podcast-studio/.claude/skills/audio-storytelling/skill.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/audio-storytelling/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How audio-storytelling Compares

Feature / Agentaudio-storytellingStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Audio storytelling skill used by the podcast scriptwriter and show note editor. Provides narrative structure, pacing, and sound design methodologies that maximize listener immersion in an audio-only medium. Use this skill's knowledge for 'audio narrative,' 'listener retention,' 'story arc,' 'sound design,' and similar requests.

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

# Audio Storytelling — Audio Narrative Design Methodology

Storytelling techniques unique to the audio medium, used by the scriptwriter and shownote-editor agents.

## Why Audio Storytelling Is Different

Video is visual + auditory. Text is visual. Podcasts are **purely auditory**. This is not a limitation — it's an opportunity.

1. **Theater of the Mind**: Listeners create their own visuals in their heads — vivid description is everything
2. **Intimacy**: A medium that whispers directly into someone's ear through earbuds — it's a friend's conversation, not a formal speech
3. **Multitasking Competition**: People listen while driving/exercising/doing chores — you need devices that recapture attention

## Episode Narrative Structure: 5 Arc Patterns

### 1. Classic Three-Act Structure
- **Best for**: Character interviews, case studies
- **Opening**: Show the outcome first, then ask "How did we get here?"
- **Middle**: Specific scenes of failure/crisis
- **End**: Lesson + current status

### 2. Mystery Reveal Structure
- **Best for**: Investigative journalism, history, incident reconstruction
- **Key**: End each segment with "But then something unexpected happened"
- **Rule**: Plant clues fairly so listeners can theorize along the way

### 3. Parallel Comparison Structure
- **Best for**: Comparing two people/events/perspectives
- **Key**: Alternate between A and B, then converge at a surprising commonality/contrast
- **Tip**: Gradually shorten A and B segments → increasing crossover frequency → rising tension

### 4. List Frame Structure
- **Best for**: Educational, self-improvement, tip-sharing episodes
- **Key**: Not a simple enumeration — attach one story to each item
- **Rule**: Place the strongest items at position 3 (middle) and last (primacy + recency effect)

### 5. Conversational Exploration Structure
- **Best for**: Philosophical/social topics, panel discussions
- **Key**: The goal is not reaching a conclusion but showing the thinking process
- **Tip**: "There's no right answer — we're exploring this together"

## Pacing Formula: BPM (Beats Per Minute) Model

In audio, a "beat" is a **transition point in information units** — a new fact, emotional shift, topic change, etc.

| Episode Type | Recommended BPM | Description |
|-------------|-----------------|-------------|
| News/Information | 4–5 BPM | New info every 12–15 seconds |
| Interview/Conversation | 2–3 BPM | Perspective shift every 20–30 seconds |
| Storytelling | 1–2 BPM | Scene change every 30–60 seconds |
| Meditation/Reflection | 0.5–1 BPM | Generous use of space and silence |

### BPM Shifting Rules

1. **Opening 30 seconds**: High BPM (4–5) — hook fast
2. **Segment Intro**: Medium BPM (2–3) — set context
3. **Segment Deep Dive**: Low BPM (1–2) — in-depth exploration
4. **Transitions**: High BPM (3–4) — reignite energy
5. **Climax**: Variable — intentional silence (0 BPM) followed by burst (5+ BPM)

## 12 Audio Devices for Boosting Listener Retention

### Narrative Devices

| # | Device | Usage | Effect |
|---|--------|-------|--------|
| 1 | **Open Loop** | "The ending to this story — coming up shortly" | The brain tries to complete unfinished information (Zeigarnik effect) |
| 2 | **Cold Open** | Start with the most dramatic moment from mid-episode | "What is this?" curiosity trigger |
| 3 | **Preview Teaser** | "Today we cover X, and Y was particularly shocking" | Removes reasons not to listen |
| 4 | **Callback** | Reconnect something mentioned earlier to a later point | Narrative satisfaction |
| 5 | **Cliffhanger** | Leave a segment ending unresolved | Prevents drop-off before the next segment |

### Vocal Performance Devices

| # | Device | Usage | Effect |
|---|--------|-------|--------|
| 6 | **Intentional Silence** | 2–3 second pause after a shocking fact | Conveys the weight of the information |
| 7 | **Speed Variation** | Speak faster during tense parts, slower on key sentences | Rhythm and emphasis |
| 8 | **Tone Shift** | Explicit signal when shifting light → serious | "Let me get serious for a moment" |
| 9 | **Direct Address** | "You, listening with your earbuds right now" | Strengthens the 1:1 conversation illusion |

### Structural Devices

| # | Device | Usage | Effect |
|---|--------|-------|--------|
| 10 | **Countdown** | "The third reason is the most surprising" | Builds anticipation |
| 11 | **Summary Anchor** | One-sentence summary every 7–8 minutes | Recaptures listeners who drifted |
| 12 | **Next Episode Preview** | Reveal one key piece of next week's content at closing | Drives series listening |

## Sound Design Direction Guide

Notation for sound cues in the script:

```
> [BGM: Gentle piano — reflective atmosphere]
> [SFX: Typewriter sounds — archival feel]
> [SILENCE: 3 seconds — emotional space]
> [MUSIC TRANSITION: Bright guitar → dark ambient]
> [INSERT: Narration with a news archive clip feel]
```

### Recommended BGM Genres by Mood

| Mood | BGM Genre | Suggested Segment |
|------|-----------|------------------|
| Energy/Start | Upbeat indie pop, electronic | Opening, transitions |
| Exploration/Discovery | Minimal piano, ambient | Interview deep dives |
| Tension/Suspense | Low drone, dissonance | Mystery, crisis |
| Emotion/Reflection | Strings, acoustic guitar | Climax, closing |
| Humor/Light | Jazz, retro synth | Bridges, casual talk |

## Script Density Formula by Duration

| Episode Length | Segment Count | Per-Segment Length | Transitions | CTA Placement |
|---------------|--------------|-------------------|-------------|---------------|
| 15 min (short-form) | 2–3 | 4–5 min | 30 sec | After final segment |
| 30 min (standard) | 3–4 | 6–8 min | 30–60 sec | After Segment 2 + closing |
| 60 min (long-form) | 4–6 | 8–12 min | 60 sec | At 20 min/40 min + closing |
| 90 min+ (deep dive) | 5–8 | 10–15 min | 60–90 sec | At 25/50/75 min + closing |

Related Skills

visual-storytelling

495
from revfactory/harness-100

Visual Storytellingof Story Design, Text writing, AI Image (Gemini), HTML Layout, Integration Editing an agent team collaborates to production to line. 'Visual Story ', 'in Planning', 'Image+ combination', 'Visual in', 'Story page production', ' Story', 'Visual Planning', 'Image in', ' Story', 'Visual Narrative' etc. Imageand Text Storytelling productionin . Text Image casein Layout Integration . , video Editing, DTP, (JS ) of .

sustainability-audit

495
from revfactory/harness-100

Full audit pipeline for ESG/sustainability where an agent team collaborates to generate environmental, social, and governance assessments along with an integrated report and improvement plan. Use this skill for requests such as 'run an ESG audit', 'write a sustainability report', 'ESG assessment', 'carbon emissions calculation', 'ESG rating diagnosis', 'governance review', 'social responsibility assessment', 'GRI report', 'TCFD disclosure', 'ESG improvement plan', and other ESG/sustainability tasks. Also supports assessment of specific pillars (E/S/G) only or improving existing reports. However, actual on-site audit execution, third-party verification certificate issuance, ESG rating agency score changes, and carbon credit trading are outside the scope of this skill.

materiality-assessment

495
from revfactory/harness-100

ESG materiality assessment matrix. Referenced by the esg-reporter and improvement-planner agents when evaluating ESG issue materiality and setting priorities. Use for 'materiality assessment', 'importance analysis', or 'Materiality Matrix' requests. Stakeholder surveys and external certification are out of scope.

ghg-protocol

495
from revfactory/harness-100

GHG Protocol detailed guide. Referenced by the environmental-analyst agent when calculating and reporting greenhouse gas emissions. Use for 'GHG Protocol', 'carbon emissions', 'Scope 1/2/3', or 'carbon footprint' requests. Carbon credit trading and CDM project execution are out of scope.

citation-standards

495
from revfactory/harness-100

Academic citation and reference standards guide. Referenced by the paper-writer and submission-preparer agents when composing citations and references. Use for 'citation format', 'APA', or 'references' requests. Original paper retrieval and professional database access are out of scope.

academic-paper

495
from revfactory/harness-100

Full research pipeline for academic paper writing where an agent team collaborates to generate research design, experiment protocols, analysis, manuscript writing, and submission preparation. Use this skill for requests such as 'write an academic paper', 'research paper writing', 'help me write a paper', 'design a study', 'run statistical analysis', 'prepare journal submission', 'manuscript writing', 'research methodology design', 'hypothesis testing', 'academic writing', and other academic research paper tasks. Also supports analysis, rewriting, and submission preparation when existing data or drafts are available. However, actual data collection execution, official IRB submission, journal system login and upload, and running actual statistical software are outside the scope of this skill.

product-copy-formulas

495
from revfactory/harness-100

Product copy formula library. Referenced by the detail-page-writer and marketing-manager agents when writing purchase-driving copy. Use for 'product copy', 'marketing copy', or 'ad copy' requests. Ad placement and design mockup creation are out of scope.

ecommerce-launcher

495
from revfactory/harness-100

Full launch pipeline for e-commerce products where an agent team collaborates to generate product planning, detail pages, pricing strategy, marketing, and CS setup all at once. Use this skill for requests such as 'launch an e-commerce product', 'prepare a product launch', 'register a product on Naver Smart Store', 'launch on Coupang', 'create a detail page', 'develop a pricing strategy', 'create a marketing plan', 'launch prep', 'product planning brief', 'e-commerce CS manual', and other e-commerce product launch tasks. Also supports supplementing pricing/marketing/CS even when existing briefs or detail pages are provided. However, actual platform API integration (automated product registration), payment system development, logistics system integration, and real-time order management are outside the scope of this skill.

conversion-optimization

495
from revfactory/harness-100

Purchase conversion optimization framework. Referenced by the detail-page-writer and pricing-strategist agents when designing detail pages and pricing with a conversion focus. Use for 'conversion rate optimization', 'CRO', or 'purchase psychology' requests. A/B testing tool setup and funnel automation are out of scope.

real-estate-analyst

495
from revfactory/harness-100

Real estate investment analysis pipeline. An agent team collaborates to produce market research, location analysis, profitability analysis, risk assessment, and investment reports. Use this skill for requests such as 'analyze this real estate', 'apartment investment analysis', 'studio apartment yield', 'real estate market research', 'location analysis', 'real estate investment report', 'buy vs lease', 'reconstruction investment analysis', 'commercial property yield analysis', and other general real estate investment analysis tasks. Actual purchase contracts, brokerage services, interior design, and property management are outside the scope of this skill.

location-scoring

495
from revfactory/harness-100

Location scoring scorecard. Referenced by the location-analyst agent for systematic real estate location evaluation. Use for requests involving 'location analysis', 'location assessment', or 'commercial area analysis'. On-site inspections and surveying are out of scope.

cap-rate-calculator

495
from revfactory/harness-100

Real estate yield calculator. Reference formulas and models used by the profitability-analyst agent for quantitative investment return analysis. Use for requests involving 'Cap Rate', 'yield analysis', 'DCF', or 'cash flow analysis'. Tax advisory and loan underwriting are out of scope.