# Delete Episode

> Delete podcast episodes from the TTS system. Use when asked to delete, remove, or clean up an episode from a podcast feed.

- Skill: `majiayu000/delete-episode` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/delete-episode`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/delete-episode/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/delete-episode

---


# Delete Episode

Deleting an episode requires cleanup in three places.

## Where Episodes Live

1. **Hub database** - Source of truth. Query via Kamal console from the hub directory.
2. **Google Cloud Storage** - MP3 file, manifest.json, feed.xml
3. **RSS feed** - Regenerate after manifest update so podcast apps reflect the change

## Key Relationships

From a Hub Episode record:
- `episode.podcast.podcast_id` → GCS folder name (e.g., `podcast_106f7e1301ae9fc2`)
- `episode.gcs_episode_id` → MP3 filename (without .mp3 extension)

## GCS Structure

```
gs://verynormal-tts-podcast/podcasts/{podcast_id}/
├── episodes/{gcs_episode_id}.mp3
├── manifest.json
└── feed.xml
```

## RSS Regeneration

After updating manifest.json, regenerate feed.xml using:
- `RSSGenerator` class from the tts lib directory
- Podcast config from `config/podcast.yml`
- Episodes array from the updated manifest

## Constraints

- **Confirm before deleting** - Show episode title, podcast, date, and ask for confirmation
- **Multiple matches** - If search finds multiple episodes, list all with details and ask which one
- **Stop on failure** - If any step fails, report what succeeded and what failed. Don't continue.

## Deletion Order

1. Delete MP3 from GCS
2. Update manifest.json (remove episode entry)
3. Regenerate and upload feed.xml
4. Delete episode from Hub database