# podcast-downloader

podcast-downloader downloads podcast audio files, show notes, and metadata from Apple Podcasts through RSS. Useful for saving single episodes or batches of recent releases.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 24 installs · ★ 196 repo stars
- Author: crazynomad
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/crazynomad/tutorial/tree/HEAD/02-podcast-downloader/artifact/podcast-downloader/SKILL.md
- Updated: 2026-07-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/podcast-downloader

## What it does

This skill runs `scripts/download_podcast.py` to retrieve audio and feed details using an RSS feed. It handles three common tasks: fetching the newest release, retrieving the latest set of episodes, or archiving an entire show. Episode indexes start at 1, which represents the most recent recording.

Output lands in `/mnt/user-data/outputs` inside a dedicated folder named after the show. Each run produces audio files alongside matching JSON records for episode metadata and a top-level `podcast_info.json`. Problematic characters in file titles are cleaned up before writing to disk.

The Python environment must have `feedparser` and `requests` installed; execution fails without them. When an agent receives a web link to Apple Podcasts instead of an RSS address, it uses Apple's lookup API to find the underlying feed URL before running the script.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add crazynomad/tutorial --skill podcast-downloader -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/podcast-downloader/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/podcast-downloader/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add crazynomad/tutorial --skill podcast-downloader -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/podcast-downloader/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add crazynomad/tutorial --skill podcast-downloader -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/podcast-downloader/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install crazynomad/tutorial 02-podcast-downloader/artifact/podcast-downloader
```

2. **Manually: put the files in place**
- File: `.github/skills/podcast-downloader/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add crazynomad/tutorial --skill podcast-downloader -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/crazynomad/tutorial --path 02-podcast-downloader/artifact/podcast-downloader
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/podcast-downloader/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add crazynomad/tutorial --skill podcast-downloader -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/crazynomad/tutorial/tree/HEAD/02-podcast-downloader/artifact/podcast-downloader/SKILL.md

## When to use it
- download latest audio episodes from an Apple Podcasts feed
- extract show notes and episode metadata into JSON files
- find an RSS feed URL from an Apple Podcasts link
- save a full podcast archive to a local folder

## Example prompts
- Download the latest episode of this podcast from its RSS feed
- Fetch the last 5 episodes and save them to outputs
- Download episode 2 using this Apple Podcasts link

## Similar
- [podcast-production](https://affpapa.org/en/nevibecode/skills/podcast-production.md) — skill · 133 installs
- [podcast-edit](https://affpapa.org/en/nevibecode/skills/podcast-edit.md) — skill · 291 installs
- [Podcast Automation](https://affpapa.org/en/nevibecode/skills/podcast-automation.md) — skill · 4800 installs
- [podcast](https://affpapa.org/en/nevibecode/skills/marswaveai-podcast.md) — skill · 1200 installs
- [podcast-studio](https://affpapa.org/en/nevibecode/skills/podcast-studio.md) — skill · 353 installs
- [podcast-editor](https://affpapa.org/en/nevibecode/agents/podcast-editor.md) — subagent · 392 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
