Agent skill

Article To Podcast Script

by digoal in digoal/blog

Convert a Markdown article into a natural first-person podcast script for 1 to 4 speakers and save it as a .txt file under the current project's markdown directory.

GPL-2.0Auto-check passedMedia & Creative

Install Article To Podcast Script

skills CLI
$ npx skills add digoal/blog --skill article-to-podcast-script -a claude-code

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

GitHub CLI
$ gh skill install digoal/blog article-to-podcast-script --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/digoal/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/article-to-podcast-script .claude/skills/article-to-podcast-script && 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
article-to-podcast-script
GitHub stars
8.6k
Token cost
~1.6k tokens
SKILL.md length
803 words
Files
3 (incl. scripts)
Skills in repo
98
Repo updated
First seen
Licence
GPL-2.0

At a glance

Convert a Markdown article into a natural first-person podcast script for 1 to 4 speakers and save it as a .txt file under the current project's markdown directory.

  • Works in 5 steps: Read the input Markdown article and… → Confirm the requested speaker count is… → Write a podcast-ready Chinese dialogue… → …
  • The user provides an article Markdown file and a podcast speaker count
  • SKILL.md covers Workflow, Script Requirements, Diction Polish and Speaker Patterns, plus 1 more section
  • Runs Python scripts from its folder; calls python3

What it does

Article To Podcast Script is an agent skill from digoal/blog. Convert a Markdown article into a natural first-person podcast script for 1 to 4 speakers and save it as a .txt file under the current project's markdown directory. Default to Chinese output unless the user explicitly specifies another language, while preserving English terms that appear in the article. Use when the user provides an article Markdown file and a podcast speaker count, asks for a VibeVoice-style podcast script, dialogue rewrite, narrated audio script, multi-host conversation, solo podcast monologue…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `agents/openai.yaml` and `scripts/save_podcast_script.py`).

It sits in Media & Creative, covering Podcasting. The repository describes itself as: AI,Opensource,Database,Business,Finance,Minds. git clone --depth 1 https://github.com/digoal/blog. The licence is GPL-2.0.

When your agent uses it

  • The user provides an article Markdown file and a podcast speaker count
  • Asks for a VibeVoice-style podcast script
  • Dialogue rewrite
  • Narrated audio script

Example prompts

  • “/article-to-podcast-script”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Read the input Markdown article and identify its title, thesis, key sections, facts, examples, and conclusion.
  2. Confirm the requested speaker count is an integer from 1 to 4. If it is missing or outside this range, ask for a valid count before…
  3. Write a podcast-ready Chinese dialogue script by default, using only labels in the form Speaker N: where N is from 1 to the requested…
  4. Save the result as a .txt file in the current project's markdown directory. Create that directory if needed.
  5. Report the output path and any important assumptions.

What it can do on your machine

Read from SKILL.md and the folder at commit ad6fcb7. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Article To Podcast Script loads about 1.6k tokens when it runs. Until then it costs about 150 tokens; SKILL.md has 803 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~150
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); the scripts in this folder are not scanned.

SKILL.md

The full file from digoal/blog at commit ad6fcb7, republished under its GPL-2.0 licence (© digoal). 803 words, ~1,593 tokens.

Download SKILL.mdSave it as .claude/skills/article-to-podcast-script/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
article-to-podcast-script
description
Convert a Markdown article into a natural first-person podcast script for 1 to 4 speakers and save it as a .txt file under the current project's markdown directory. Default to Chinese output unless the user explicitly specifies another language, while preserving English terms that appear in the article. Use when the user provides an article Markdown file and a podcast speaker count, asks for a VibeVoice-style podcast script, dialogue rewrite, narrated audio script, multi-host conversation, solo podcast monologue, or personal-viewpoint audio script based on an article.

Article To Podcast Script

Workflow

  1. Read the input Markdown article and identify its title, thesis, key sections, facts, examples, and conclusion.
  2. Confirm the requested speaker count is an integer from 1 to 4. If it is missing or outside this range, ask for a valid count before writing the script.
  3. Write a podcast-ready Chinese dialogue script by default, using only labels in the form Speaker N: where N is from 1 to the requested count. If the user explicitly specifies another language, write the script in that language instead. Transform the article's ideas into the speaker's own first-person viewpoint, as if the speaker is directly sharing their thinking on the topic, not reviewing, summarizing, or reacting to an article.
  4. Save the result as a .txt file in the current project's markdown directory. Create that directory if needed.
  5. Report the output path and any important assumptions.

Use scripts/save_podcast_script.py to write the final text:

bash
python3 /path/to/article-to-podcast-script/scripts/save_podcast_script.py ARTICLE.md SPEAKER_COUNT < draft.txt

The script validates the speaker count, creates ./markdown, builds a stable output filename from the article name, and writes stdin to the .txt file.

Script Requirements

  • Start directly with Speaker 1:. Do not add a title block, cast list, markdown formatting, stage directions, or bullets.
  • Default to natural spoken Chinese for the dialogue content unless the user requests another language. Keep the Speaker N: labels in English exactly as shown.
  • Preserve English terms that appear in the article, including acronyms, product names, model names, paper titles, project names, protocol names, company names, and technical terms. Do not translate them into Chinese unless the article itself already provides an established Chinese rendering.
  • Keep every line as one speaker turn:
text
Speaker 1: 大家好,欢迎收听本期节目。今天我想聊一个很关键的判断...
Speaker 2: 没错,真正的核心不是表面的新闻,而是背后的传导链条...
  • Use exactly the requested number of speaker labels across the script. For one person, use only Speaker 1:.
  • Rotate speakers naturally for 2 to 4 people; do not force equal length if the conversation would sound unnatural.
  • Preserve the article's core claims and important evidence. Do not invent facts, names, numbers, or citations.
  • Convert dense exposition into spoken language: short sentences, natural transitions, reactions, clarifying questions, and concise analogies.
  • Make the script self-contained for listeners who have not read the article.
  • Avoid excessive filler, repeated greetings, ads, music cues, timestamps, sound effects, and production notes.
  • Avoid any AI-generated trace, meta-writing, source-processing disclosure, or reading-response framing. Do not mention "我作为AI", "AI生成", "资料边界", "公开资料显示", "不是基于全文精读", "这篇文章", "本文", "这篇读书笔记", "原文", "作者认为", "评论者认为", "根据材料", "我读完", "读到这里", "我理解这篇文章", "文章里提到", "这篇报告", or similar source-framing phrases. It is fine to say "AI" when AI is the actual topic or an English term from the source.
  • Never present the episode as a book report, article review, article summary, reading note, or post-reading reflection. The listener should feel the speaker is sharing their own structured view directly, not explaining how they understood a source text.
  • Put the host inside the source article's knowledge and evidence boundary while removing the source frame. The host may say "我的判断是", "我会这样看", "这里真正的问题是", "如果把它落到实践里", but must not pretend to have experiences, authority, interviews, fieldwork, proprietary data, or personal relationships that are not in the article.
  • Rewrite source-boundary paragraphs into natural first-person caveats or omit them when they do not help listeners. For example, instead of saying "这本书的公开资料边界也要先讲清楚...", say "我更愿意把它当成一套思考复杂问题的框架,而不是照搬案例的操作手册。"
  • Keep the voice like a real human host preparing a thoughtful episode: specific, opinionated within the article's evidence, and free of template-like transitions.
Show full SKILL.md (250 more words)Show less

Diction Polish

  • Do not use source-object verbs such as "读", "看", "这篇文章讲", "作者说", "报告指出" to frame the episode. Convert them into direct viewpoint verbs such as "我判断", "我更关心", "真正的变化是", "这里可以归结为".
  • Attribute ideas to the speaker's own reasoning voice instead of the source. Prefer "我的核心判断是..." over "作者的核心判断是..." or "作者透过这本书要表达的是...".
  • Use precise synthesis verbs. Prefer "收敛到三个问题", "归结为一个判断", "落到一个方法" instead of generic "收束成..." when closing an argument.
  • Before saving, do one final wording pass for Chinese texture: replace stiff, generic, assistant-like, or reading-response phrases with direct first-person viewpoint phrasing while keeping facts unchanged.

Speaker Patterns

  • 1 speaker: Write a solo host monologue in first person, with rhetorical questions, clear signposting, and periodic recap phrases.
  • 2 speakers: Use host plus co-host. Let Speaker 1 guide the structure and Speaker 2 clarify, challenge, summarize, or add examples.
  • 3 speakers: Use host plus two panelists. Give one speaker the explanatory role and one the skeptical or practical role.
  • 4 speakers: Use a roundtable. Keep turns shorter so all voices remain present without becoming chaotic.

Structure

Follow this shape unless the article clearly calls for another:

  1. Opening hook and topic setup.
  2. Core personal thesis in plain language.
  3. Main points in a natural spoken order, using the article only as the evidence and logic source.
  4. Tensions, tradeoffs, limitations, or counterpoints if present in the article.
  5. Practical takeaway or closing synthesis.

Match length to the article and user request. If no duration is specified, produce enough script to cover the article's substance without padding.

© digoal, GPL-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

SKILL.md and 2 other files (scripts) in skills/article-to-podcast-script of digoal/blog.

  • SKILL.md
  • agents/openai.yaml
  • scripts/save_podcast_script.py

Open the folder on GitHubat commit ad6fcb7

Compare with similar skills

Article To Podcast Script 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.

Article To Podcast Script compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Article To Podcast Script this skilldigoal/blog8.6k—~1.6kAutomated safety check: PassGPL-2.0
Podcastzarazhangrui/personalized-podcast437—~2.3kAutomated safety check: NotesNone
Podpullxiaoleiy/podpull146—~962Automated safety check: PassMIT
Xiaoyuzhou Downloadgainubi/wechat-skills170—~551Automated safety check: PassNone
Summarizetrpc-group/trpc-agent-go1.9k22 repos~552Automated safety check: PassApache-2.0
Z Qwen Audio Studiotjxj/z-skills547—~716Automated safety check: PassNone

Similar skills

  • Podcast

    zarazhangrui/personalized-podcast

    Generate a podcast episode from content you provide. An agent skill from zarazhangrui/personalized-podcast.

    437 GitHub stars~2.3k tokensUpdated 6 mo ago
    Media & CreativeAuto-check: notes
  • Podpull

    xiaoleiy/podpull

    A skill your agent uses when the user wants to download a podcast episode's audio file (mp3/m4a) to disk — from an Apple Podcasts show or episode link, a raw RSS feed, or a 小宇宙/xiaoyuzhou episode…

    146 GitHub stars~962 tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Xiaoyuzhou Download

    gainubi/wechat-skills

    Download Xiaoyuzhou FM podcast episode audio files from xiaoyuzhoufm.com/episode links.

    170 GitHub stars~551 tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Summarize

    trpc-group/trpc-agent-go

    Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).

    1.9k GitHub starsUsed in 22 repos~552 tokens
    Media & CreativeAuto-check passed
  • 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…

    547 GitHub stars~716 tokensUpdated 17 days ago
    Media & CreativeAuto-check passed
  • Podcast

    team-attention/plugins-for-claude-natives

    Generate Korean podcast episodes from any source (URLs, tweets, articles, PDFs) — analyzes content, writes a script, generates audio via OpenAI TTS, converts to MP4, and auto-uploads to YouTube.

    827 GitHub stars~1.5k tokensUpdated 5 mo ago
    Media & CreativeAuto-check passed

More from digoal/blog

All 98 skills in this repo
  • 三层审查模型,逐段逐句验证文章真伪、证据链与逻辑结构。Use when the user asks to fact-check, verify, audit, or evaluate the credibility of an article, essay, report, opinion piece, social-media post, or any written claim —…

    8.6k GitHub stars~939 tokensUpdated today
    Auto-check passed
  • Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…

    8.6k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Digoal

    digoal/blog

    Portable digital employee distilled from digoal's personal blog for PostgreSQL, PolarDB, DuckDB, AI+database, vector/RAG, database operations, source-code reading, technical content creation…

    8.6k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • 从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…

    8.6k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Analyze a product from documentation, websites, PDFs, articles, release notes, pricing pages, app listings, reviews, filings, or related links; save separate intermediate analyses from seven roles…

    8.6k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Turn a blog post, article, notes, or any source material into a set of vertical poster images — one cover plus several coherent content slides that explain the core points.

    8.6k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Questions about Article To Podcast Script

What does Article To Podcast Script do?

Convert a Markdown article into a natural first-person podcast script for 1 to 4 speakers and save it as a .txt file under the current project's markdown directory. Article To Podcast Script is an agent skill from digoal/blog.txt file under the current project's markdown directory.

When should I use Article To Podcast Script?

Article To Podcast Script fits situations like: the user provides an article Markdown file and a podcast speaker count; asks for a VibeVoice-style podcast script; dialogue rewrite; narrated audio script.

How do I install Article To Podcast Script in Claude Code?

Run `npx skills add digoal/blog --skill article-to-podcast-script -a claude-code`. Or copy the skill folder (skills/article-to-podcast-script in digoal/blog) into .claude/skills/article-to-podcast-script in your project. Claude Code loads it when a task matches its description.

How do I install Article To Podcast Script in Codex?

Run `npx skills add digoal/blog --skill article-to-podcast-script -a codex`. Or copy the skill folder (skills/article-to-podcast-script in digoal/blog) into .agents/skills/article-to-podcast-script in your project. Codex loads it when a task matches its description.

Can I use Article To Podcast Script 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 digoal/blog --skill article-to-podcast-script -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/article-to-podcast-script, .gemini/skills/article-to-podcast-script, .github/skills/article-to-podcast-script and .opencode/skills/article-to-podcast-script in your project.

What does Article To Podcast Script need to run?

Going by SKILL.md and its folder, Article To Podcast Script needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Article To Podcast Script 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 Article To Podcast Script 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Article To Podcast Script use?

Article To Podcast Script is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Article To Podcast Script use?

About 1.6k tokens (SKILL.md is roughly 6.4k 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 Article To Podcast Script?

Skills that share tags, products or a category with Article To Podcast Script: Podcast (zarazhangrui/personalized-podcast, 437 stars), Podpull (xiaoleiy/podpull, 146 stars), Xiaoyuzhou Download (gainubi/wechat-skills, 170 stars) and Summarize (trpc-group/trpc-agent-go, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Article To Podcast Script?

digoal (a GitHub user) maintains it in digoal/blog, which has 8,586 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on October 9, 2026.

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