Agent skill

Audio Storytelling

by revfactory in revfactory/harness-100

Audio storytelling skill used by the podcast scriptwriter and show note editor.

Apache-2.0Auto-check passedWriting & Content

Install Audio Storytelling

skills CLI
$ npx skills add revfactory/harness-100 --skill audio-storytelling -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install revfactory/harness-100 audio-storytelling --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .claude/skills && cp -r skills-src/en/02-podcast-studio/.claude/skills/audio-storytelling .claude/skills/audio-storytelling && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
audio-storytelling
GitHub stars
1.3k
Token cost
~1.6k tokens
SKILL.md length
696 words
Files
1
Skills in repo
274
Repo updated
First seen
Licence
Apache-2.0

At a glance

Audio storytelling skill used by the podcast scriptwriter and show note editor.

  • Works in 5 steps: Classic Three-Act Structure → Mystery Reveal Structure → Parallel Comparison Structure → …
  • Tasks that involve Storytelling
  • SKILL.md covers Why Audio Storytelling Is…, Episode Narrative Structure: 5…, Pacing Formula: BPM (Beats Per… and 12 Audio Devices for Boosting…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Audio Storytelling is an agent skill from revfactory/harness-100. 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.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Storytelling, Music and audio generation and Podcasting. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Storytelling
  • Tasks that involve Music and audio generation
  • Tasks that involve Podcasting

Example prompts

  • “s knowledge for”
  • “listener retention,”
  • “story arc,”
  • “/audio-storytelling”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Classic Three-Act Structure
  2. Mystery Reveal Structure
  3. Parallel Comparison Structure
  4. List Frame Structure
  5. Conversational Exploration Structure

What it can do on your machine

Read from SKILL.md and the folder at commit 8e8d35c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Audio Storytelling loads about 1.6k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 696 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from revfactory/harness-100 at commit 8e8d35c, republished under its Apache-2.0 licence (© revfactory). 696 words, ~1,561 tokens.

Download SKILL.mdSave it as .claude/skills/audio-storytelling/SKILL.md (or your agent's skills folder).
name
audio-storytelling
description
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.

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 TypeRecommended BPMDescription
News/Information4–5 BPMNew info every 12–15 seconds
Interview/Conversation2–3 BPMPerspective shift every 20–30 seconds
Storytelling1–2 BPMScene change every 30–60 seconds
Meditation/Reflection0.5–1 BPMGenerous 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

Show full SKILL.md (313 more words)Show less
Narrative Devices
#DeviceUsageEffect
1Open Loop"The ending to this story — coming up shortly"The brain tries to complete unfinished information (Zeigarnik effect)
2Cold OpenStart with the most dramatic moment from mid-episode"What is this?" curiosity trigger
3Preview Teaser"Today we cover X, and Y was particularly shocking"Removes reasons not to listen
4CallbackReconnect something mentioned earlier to a later pointNarrative satisfaction
5CliffhangerLeave a segment ending unresolvedPrevents drop-off before the next segment
Vocal Performance Devices
#DeviceUsageEffect
6Intentional Silence2–3 second pause after a shocking factConveys the weight of the information
7Speed VariationSpeak faster during tense parts, slower on key sentencesRhythm and emphasis
8Tone ShiftExplicit signal when shifting light → serious"Let me get serious for a moment"
9Direct Address"You, listening with your earbuds right now"Strengthens the 1:1 conversation illusion
Structural Devices
#DeviceUsageEffect
10Countdown"The third reason is the most surprising"Builds anticipation
11Summary AnchorOne-sentence summary every 7–8 minutesRecaptures listeners who drifted
12Next Episode PreviewReveal one key piece of next week's content at closingDrives 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]
MoodBGM GenreSuggested Segment
Energy/StartUpbeat indie pop, electronicOpening, transitions
Exploration/DiscoveryMinimal piano, ambientInterview deep dives
Tension/SuspenseLow drone, dissonanceMystery, crisis
Emotion/ReflectionStrings, acoustic guitarClimax, closing
Humor/LightJazz, retro synthBridges, casual talk

Script Density Formula by Duration

Episode LengthSegment CountPer-Segment LengthTransitionsCTA Placement
15 min (short-form)2–34–5 min30 secAfter final segment
30 min (standard)3–46–8 min30–60 secAfter Segment 2 + closing
60 min (long-form)4–68–12 min60 secAt 20 min/40 min + closing
90 min+ (deep dive)5–810–15 min60–90 secAt 25/50/75 min + closing

© revfactory, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in en/02-podcast-studio/.claude/skills/audio-storytelling of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

Audio Storytelling next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Audio Storytelling compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Audio Storytelling this skillrevfactory/harness-1001.3k—~1.6kAutomated safety check: PassApache-2.0
Z Qwen Audio Studiotjxj/z-skills548—~716Automated safety check: PassNone
Audio Mixing Masteringcalesthio/generative-media-skills197—~7kAutomated safety check: PassMIT
Pitch Craft Timed Scriptsooiyeefei/ccc495—~1.7kAutomated safety check: PassMIT
Podcast Pipelineericosiu/ai-marketing-skills3.6k1 repos~2.6kAutomated safety check: PassMIT
Exec Commsmenkesu/awesome-pm-skills434—~4.4kAutomated safety check: PassCustom licence

Similar skills

  • Z Qwen Audio Studio

    tjxj/z-skills

    A skill your agent uses when creating complete generated audio with qwen-audio-3.1-tts-next, including podcasts, radio drama, advertisements, multiple speakers, reference voices, ambience, sound…

    548 GitHub stars~716 tokensUpdated 18 days ago
    Media & CreativeAuto-check passed
  • Audio Mixing Mastering

    calesthio/generative-media-skills

    Provider-independent audio mixing and mastering direction for AI agents finishing generated videos, ads, trailers, explainers, podcasts, recuts, avatar clips, music videos, documentaries, and social…

    197 GitHub stars~7k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Writes or fixes spoken scripts that must fit a clock: demo voiceovers, deck narration and pitch speeches, with word budgets, storytelling rules and named trim points.

    495 GitHub stars~1.7k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Podcast Pipeline

    ericosiu/ai-marketing-skills

    Podcast-to-Everything content pipeline. An agent skill from ericosiu/ai-marketing-skills.

    3.6k GitHub starsUsed in 1 repo~2.6k tokens
    Writing & ContentAuto-check passed
  • Exec Comms

    menkesu/awesome-pm-skills

    Rewrite an exec update, memo, strategy doc, deck outline, Slack post or talk so it lands with senior people, and get a graded score plus the top 3 fixes.

    434 GitHub stars~4.4k tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • AI Podcast Creation

    NeverSight/learn-skills.dev

    Create AI-powered podcasts with text-to-speech, music, and audio editing.

    217 GitHub starsUsed in 1 repo~2k tokens
    Media & CreativeAuto-check passed

More from revfactory/harness-100

All 274 skills in this repo
  • Anti Bot Analyzer

    revfactory/harness-100

    A skill for analyzing website anti-bot defense mechanisms and developing legitimate evasion strategies.

    1.3k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • API Error Design Patterns

    revfactory/harness-100

    Reference for designing how an API reports failures: structured error codes, response shapes, client-friendly messages, an error catalog and retry or fallback advice.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • API Security Checklist

    revfactory/harness-100

    Walks a backend-dev agent through OWASP API Top 10 checks, authentication and authorization patterns, and defense code during API design.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Arg Parser Generator

    revfactory/harness-100

    Methodology for systematically designing and generating CLI tool argument parser structures.

    1.3k GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed
  • Audience Segmentation

    revfactory/harness-100

    Audience segmentation skill used by the analyst and curator agents.

    1.3k GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Audit Checklist Engine

    revfactory/harness-100

    A systematic checklist generation engine for compliance audits.

    1.3k GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed

Questions about Audio Storytelling

What does Audio Storytelling do?

Audio storytelling skill used by the podcast scriptwriter and show note editor. Audio Storytelling is an agent skill from revfactory/harness-100. Audio storytelling skill used by the podcast scriptwriter and show note editor.

When should I use Audio Storytelling?

Audio Storytelling fits situations like: tasks that involve Storytelling; tasks that involve Music and audio generation; tasks that involve Podcasting.

How do I install Audio Storytelling in Claude Code?

Run `npx skills add revfactory/harness-100 --skill audio-storytelling -a claude-code`. Or copy the skill folder (en/02-podcast-studio/.claude/skills/audio-storytelling in revfactory/harness-100) into .claude/skills/audio-storytelling in your project. Claude Code loads it when a task matches its description.

How do I install Audio Storytelling in Codex?

Run `npx skills add revfactory/harness-100 --skill audio-storytelling -a codex`. Or copy the skill folder (en/02-podcast-studio/.claude/skills/audio-storytelling in revfactory/harness-100) into .agents/skills/audio-storytelling in your project. Codex loads it when a task matches its description.

Can I use Audio Storytelling in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add revfactory/harness-100 --skill audio-storytelling -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/audio-storytelling, .gemini/skills/audio-storytelling, .github/skills/audio-storytelling and .opencode/skills/audio-storytelling in your project.

What does Audio Storytelling need to run?

SKILL.md names no scripts, command-line tools or credentials: Audio Storytelling is instructions for the agent only.

Does Audio Storytelling access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Audio Storytelling safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Audio Storytelling use?

Audio Storytelling is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Audio Storytelling use?

About 1.6k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Audio Storytelling?

Skills that share tags, products or a category with Audio Storytelling: Z Qwen Audio Studio (tjxj/z-skills, 548 stars), Audio Mixing Mastering (calesthio/generative-media-skills, 197 stars), Pitch Craft Timed Scripts (ooiyeefei/ccc, 495 stars) and Podcast Pipeline (ericosiu/ai-marketing-skills, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Audio Storytelling?

revfactory (a GitHub user) maintains it in revfactory/harness-100, which has 1,295 GitHub stars. The repository holds 274 skills in this directory. The repository was last updated on March 22, 2026.

Source: revfactory/harness-100 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.