Skill

Blog Audio Script

Convert a blog post MDX file into a spoken-word script for audio narration, stripping code and visual-only content while referencing diagrams.

// writing;

Behaviour

What it does

Reads MDX post content and rewrites it for listening, not reading
Opens with a blog-style intro using post framing (e.g. in this post we cover…), never episode or podcast language
Closes with a natural sign-off pointing listeners to the written post
Inserts ElevenLabs break tags and short paragraphs for realistic pacing and breath pauses
Summarises code blocks and references visuals in the written post
Strips JSX, raw URLs, and markdown syntax from the spoken script
Uses Australian English and expands acronyms on first use
Saves to src/content/audio/{slug}.script.md without enabling hasAudio yet

When to use

Preparing a blog post for audio narration

Before calling ElevenLabs or running generate:post-audio

When code, charts, or diagrams need a spoken alternative

Install

Uses Agent Kit via npx; no global install required.

npx @levi-putna/agent-kit@latest add levi-putna/skills --skill blog-audio-script

npx @levi-putna/agent-kit@latest add levi-putna/skills --skill blog-audio-script --global --agent cursor

npx @levi-putna/agent-kit@latest add levi-putna/skills --skill blog-audio-script --global --agent claude

npx @levi-putna/agent-kit@latest add levi-putna/skills --skill blog-audio-script --project

npx @levi-putna/agent-kit@latest add levi-putna/skills

npx @levi-putna/agent-kit@latest remove blog-audio-script

Example

Blog Audio Script

Write an audio script for the blog post is-the-cms-dead. Use a blog-style intro, natural pauses, and a Twisted Brackets sign-off.

Flow