New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Podcast Publishing Assistant

by swyxio in swyxio/skills

Transcribe long-form audio, YouTube videos, podcasts, interviews, or panels; summarize them; extract chapter markers; and draft publishing assets like titles, YouTube descriptions, show notes, and…

MITAuto-check passedMedia & Creative

Install Podcast Publishing Assistant

skills CLI
$ npx skills add swyxio/skills --skill podcast-publishing-assistant -a claude-code

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

GitHub CLI
$ gh skill install swyxio/skills podcast-publishing-assistant --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/swyxio/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/podcast-publishing-assistant .claude/skills/podcast-publishing-assistant && 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
podcast-publishing-assistant
GitHub stars
176
Token cost
~1.4k tokens
SKILL.md length
728 words
Files
2 (incl. scripts)
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

Transcribe long-form audio, YouTube videos, podcasts, interviews, or panels; summarize them; extract chapter markers; and draft publishing assets like titles, YouTube descriptions, show notes, and…

  • Works in 5 steps: Fetch source audio first. → Transcribe with a fallback ladder. → Keep the user updated during long jobs. → …
  • A user shares a YouTube link
  • SKILL.md covers Core rules, Workflow, Transcript quality notes and Launch template, plus 3 more sections
  • Runs Shell scripts from its folder; needs OPENAI_API_KEY

What it does

Podcast Publishing Assistant is an agent skill from swyxio/skills. Transcribe long-form audio, YouTube videos, podcasts, interviews, or panels; summarize them; extract chapter markers; and draft publishing assets like titles, YouTube descriptions, show notes, and tweet/X copy. Use when a user shares a YouTube link or audio/video file and asks for transcription, diarization, summaries with timestamps, chapter markers, show notes, titles, descriptions, promo copy, or social posts. Especially use for Whisper-based workflows, source-audio-first podcast processing, and any request to…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/transcribe_youtube.sh`).

It sits in Media & Creative, covering Podcasting, Transcription and Social media posts. It works with YouTube. The repository describes itself as: Agent skills for Claude Code and other AI agents. The licence is MIT.

When your agent uses it

  • A user shares a YouTube link
  • Audio/video file and asks for transcription
  • Summaries with timestamps
  • Chapter markers

Example prompts

  • “/podcast-publishing-assistant”

Requirements

  • A Bash shell
  • A credential in OPENAI_API_KEY

Workflow steps

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

  1. Fetch source audio first.
  2. Transcribe with a fallback ladder.
  3. Keep the user updated during long jobs.
  4. Produce the publishing pack.
  5. Package timestamps correctly.

What it can do on your machine

Read from SKILL.md and the folder at commit 038ef34. 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/ (Shell), which the agent can run.

    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 these keys or tokens, usually read from environment variables:

    • OPENAI_API_KEY

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

Context cost

Podcast Publishing Assistant loads about 1.4k tokens when it runs. Until then it costs about 150 tokens; SKILL.md has 728 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.4k

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 swyxio/skills at commit 038ef34, republished under its MIT licence (© swyxio). 728 words, ~1,392 tokens.

Download SKILL.mdSave it as .claude/skills/podcast-publishing-assistant/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
podcast-publishing-assistant
description
Transcribe long-form audio, YouTube videos, podcasts, interviews, or panels; summarize them; extract chapter markers; and draft publishing assets like titles, YouTube descriptions, show notes, and tweet/X copy. Use when a user shares a YouTube link or audio/video file and asks for transcription, diarization, summaries with timestamps, chapter markers, show notes, titles, descriptions, promo copy, or social posts. Especially use for Whisper-based workflows, source-audio-first podcast processing, and any request to turn a recorded conversation into publishable assets.

Podcast Publishing Assistant

Use this skill for podcast or interview publishing workflows.

Apply swyx-writing to summaries, titles, descriptions, show notes, newsletter blurbs, and social copy. Do not apply it to verbatim transcripts or speaker labels. This skill owns transcription, timing, chapter, and publishing-pack requirements.

Core rules

  • Prefer source audio over platform captions.
  • Do not rely on YouTube captions unless the user explicitly asks for the fastest possible rough pass.
  • For Whisper or API transcripts, be honest about uncertainty. Do not claim true diarization unless the tool actually produced it.
  • If the user has a formatting preference, preserve it exactly on later turns.
  • Default chapter output for swyx: YouTube timestamp format only, start times only, followed by a 2 to 10 word headline.

Workflow

  1. Fetch source audio first.

    • For YouTube URLs, use yt-dlp to extract audio.
    • Prefer MP3 output for compatibility.

  2. Transcribe with a fallback ladder.

    • First try the OpenAI Whisper API when OPENAI_API_KEY is available.
    • The OpenAI audio transcription upload cap is about 25 MB. Expect long episodes to exceed it.
    • If the file is too large, compress before retrying, for example mono 16 kHz MP3 around 32 kbps.
    • If API transcription still fails, fall back to local Whisper.
    • If a script exists but is not executable, invoke it with bash rather than failing on permissions.

  3. Keep the user updated during long jobs.

    • Brief progress notes are enough: downloading, compressing, transcribing, packaging.
    • If a fallback happens, say what failed in one line and continue.

  4. Produce the publishing pack.

    • Summary tuned for someone deciding whether to watch or listen.
    • Key takeaways or key arguments.
    • 5 title ideas when asked.
    • 5 description ideas when asked.
    • Chapter timestamps.
    • Optional: tweet thread, show notes, key quotes, newsletter blurb.

  5. Package timestamps correctly.

    • Prefer real timestamps if the transcription source provides segments.
    • If the transcript is a single plain-text blob, estimate coarse chapter times conservatively and label them as approximate if needed.
    • For swyx, default to this exact style:
      • 0:00 Intro and origin story
      • 3:30 How the brand grew

Transcript quality notes

  • OpenAI Whisper API often returns plain text unless a segment-rich response format is requested elsewhere.
  • Plain text transcripts are good for summaries and rough chapters, but weak for precise diarization.
  • When speaker labels are needed without true diarization, reconstruct heuristically from turn-taking and identify this clearly as approximate.

Launch template

When a user wants publishing help, default to a reusable launch pack.

Show full SKILL.md (325 more words)Show less
Standard launch pack

  1. YouTube titles

    • Provide 3 to 4 options.
    • Prefer thesis first, guest second.
    • Keep them specific, not generic.

  2. YouTube descriptions

    • Provide 3 to 4 options.
    • Each should include:
      • one short framing paragraph
      • 3 to 6 concrete bullets on what the audience will learn
      • chapter markers in YouTube timestamp format when available

  3. X main post

    • Provide 3 to 4 options.
    • Structure:
      • hook or thesis
      • guest credibility line
      • 3 to 6 concrete bullets
      • link placeholder or actual link

  4. X follow-up reply

    • Provide 1 concise timestamps-only reply unless the user asks for more.
    • Use YouTube timestamp format only, start times only, 2 to 10 word headlines.

  5. Native clip ideas

    • Provide 3 to 4 options.
    • For each clip idea, include:
      • clip theme
      • why it works as promo
      • rough timestamp window if known

  6. Quote card ideas

    • Provide 3 to 4 options.
    • Prefer clean, arguable lines with strong standalone meaning.
Packaging guidance
  • Distinguish between:
    • what the episode is about
    • why it matters now
  • Prefer concrete bullets over abstract topic labels.
  • For X, optimize for curiosity plus utility, not just announcement tone.
  • For YouTube, optimize for searchable thesis plus guest credibility.
  • If the audience is technical, specificity beats hype.

Output format

Default output order:

  1. Short summary
  2. Key takeaways
  3. Chapter timestamps
  4. 3 to 4 title options
  5. 3 to 4 description options
  6. 3 to 4 X post options
  7. 3 to 4 clip ideas
  8. 3 to 4 quote card ideas

Scripts

  • scripts/transcribe_youtube.sh: download audio from YouTube, shrink oversized audio for Whisper API, and fall back cleanly.

Notes

  • Prefer speed first, but do not fake certainty.
  • If a transcript path is broken, say what failed and continue with the next fallback.
  • For long episodes, give the user a progress update before the final packaging pass.
  • If the user says a format like “always give me YouTube timestamp format”, treat that as a sticky preference for the rest of the task.

© swyxio, MIT. 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 1 other file (scripts) in podcast-publishing-assistant of swyxio/skills.

  • SKILL.md
  • scripts/transcribe_youtube.sh

Open the folder on GitHubat commit 038ef34

Compare with similar skills

Podcast Publishing Assistant 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.

Podcast Publishing Assistant compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Podcast Publishing Assistant this skillswyxio/skills176—~1.4kAutomated safety check: PassMIT
Summarizetrpc-group/trpc-agent-go1.9k22 repos~552Automated safety check: PassApache-2.0
Podcastteam-attention/plugins-for-claude-natives827—~1.5kAutomated safety check: PassMIT
VideoiBigQiang/feedgrab614—~1.6kAutomated safety check: PassMIT
Podcast Transcript FetcherVarnan-Tech/opendirectory674—~1.9kAutomated safety check: NotesMIT
WatchTheCraigHewitt/skills159—~1.6kAutomated safety check: NotesMIT

Similar skills

  • 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

  • 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

  • Video

    iBigQiang/feedgrab

    Video & Podcast Digest — send a video/podcast link, get full transcript + structured summary.

    614 GitHub stars~1.6k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed

  • Podcast Transcript Fetcher

    Varnan-Tech/opendirectory

    A skill your agent uses when fetching, searching, or analyzing transcripts from Lenny's Podcast, Dwarkesh Podcast, Cheeky Pint, 20VC, or A16z Podcast.

    674 GitHub stars~1.9k tokensUpdated yesterday
    Media & CreativeAuto-check: notes

  • Watch

    TheCraigHewitt/skills

    When the user wants to read, transcribe, summarize, or research a video — YouTube link, podcast clip, Loom, TikTok, X/Twitter video, local file, or any URL yt-dlp supports.

    159 GitHub stars~1.6k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: notes

  • Podcast And Audiograms

    social-media-skills/skills

    The audio-to-social pipeline skill -- turn a podcast episode into short, branded, captioned clips and audiograms that drive people back to the full episode.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed

More from swyxio/skills

All 89 skills in this repo

  • Programmatic Agents

    swyxio/skills

    Run a selected coding-agent CLI programmatically, with latency, error, usage, cost, and trace logging.

    176 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Reserved Handle Policy

    swyxio/skills

    Design, implement, audit, or refresh protected username and handle namespaces for public products.

    176 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • New Mac Setup

    swyxio/skills

    Fully automated new Mac setup for fullstack web developers and AI engineers.

    176 GitHub stars~4.3k tokensUpdated today
    Auto-check passed

  • Youtube API

    swyxio/skills

    Manage YouTube videos programmatically via the YouTube Data API v3 — upload video files, upload custom thumbnails, update video metadata (titles, descriptions, tags), and query video/channel info…

    176 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Youtube Studio Batch Upload

    swyxio/skills

    Batch YouTube Studio upload workflow for videos sourced from Airtable, Google Drive, Loom, YouTube, or local files.

    176 GitHub stars~1.5k tokensUpdated today
    Auto-check: warnings

  • Deep Trajectory Analysis

    swyxio/skills

    Reconstruct and visually analyze paired agent, game, or policy trajectories to determine whether changed actions produced their intended effects.

    176 GitHub stars~1.8k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Podcast Publishing Assistant

What does Podcast Publishing Assistant do?

Transcribe long-form audio, YouTube videos, podcasts, interviews, or panels; summarize them; extract chapter markers; and draft publishing assets like titles, YouTube descriptions, show notes, and…. Podcast Publishing Assistant is an agent skill from swyxio/skills. Transcribe long-form audio, YouTube videos, podcasts, interviews, or panels; summarize them; extract chapter markers; and draft publishing assets like titles, YouTube descriptions, show notes, and tweet/X copy.

When should I use Podcast Publishing Assistant?

Podcast Publishing Assistant fits situations like: A user shares a YouTube link; audio/video file and asks for transcription; summaries with timestamps; chapter markers.

How do I install Podcast Publishing Assistant in Claude Code?

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

How do I install Podcast Publishing Assistant in Codex?

Run `npx skills add swyxio/skills --skill podcast-publishing-assistant -a codex`. Or copy the skill folder (podcast-publishing-assistant in swyxio/skills) into .agents/skills/podcast-publishing-assistant in your project. Codex loads it when a task matches its description.

Can I use Podcast Publishing Assistant 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 swyxio/skills --skill podcast-publishing-assistant -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/podcast-publishing-assistant, .gemini/skills/podcast-publishing-assistant, .github/skills/podcast-publishing-assistant and .opencode/skills/podcast-publishing-assistant in your project.

What does Podcast Publishing Assistant need to run?

Going by SKILL.md and its folder, Podcast Publishing Assistant needs a shell for the scripts in its folder and credentials named OPENAI_API_KEY. Our summary lists: A Bash shell; A credential in OPENAI_API_KEY.

Does Podcast Publishing Assistant 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 Podcast Publishing Assistant 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 Podcast Publishing Assistant use?

Podcast Publishing Assistant is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Podcast Publishing Assistant use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Podcast Publishing Assistant?

Skills that share tags, products or a category with Podcast Publishing Assistant: Summarize (trpc-group/trpc-agent-go, 1.9k stars), Podcast (team-attention/plugins-for-claude-natives, 827 stars), Video (iBigQiang/feedgrab, 614 stars) and Podcast Transcript Fetcher (Varnan-Tech/opendirectory, 674 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Podcast Publishing Assistant?

swyxio (a GitHub user) maintains it in swyxio/skills, which has 176 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 5, 2026.

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