delete-episode

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

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️2downloads

When & Why to Use This Skill

The Delete Episode skill is a specialized automation tool designed to streamline the removal of podcast content from TTS systems. It handles the end-to-end workflow of deleting cloud storage assets, updating backend databases, and refreshing RSS feeds, ensuring a synchronized and error-free cleanup process while maintaining data integrity across Google Cloud Storage and Hub databases.

Use Cases

  • Content Maintenance: Efficiently remove outdated, incorrect, or retracted podcast episodes from the system to maintain a high-quality feed.
  • Automated System Cleanup: Execute a multi-step runbook to purge MP3 files from Google Cloud Storage and corresponding records from the Hub database to optimize storage.
  • RSS Feed Synchronization: Automatically regenerate and upload the feed.xml after an episode deletion to ensure podcasting apps reflect the changes immediately without broken links.
  • Error-Prone Task Automation: Replace manual, multi-platform deletion processes with a guided agentic workflow that includes confirmation steps and failure reporting.
namedelete-episode
descriptionDelete podcast episodes from the TTS system. Use when asked to delete, remove, or clean up an episode from a podcast feed.

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