---
name: podcaster
description: Publish episodes to the Podcaster personal podcast feed. Use when asked to publish audio to the podcast, add a podcast episode, or manage the podcast feed.
---

# Podcaster — Podcast Publishing Skill

## Project Location
`/Users/damir/dev/pico/podcaster`

## What This Does
Publishes audio files as podcast episodes to a personal RSS feed hosted on Cloudflare R2 + Workers.

## CLI Commands

All commands run from `cli/` directory:

```bash
# Initialize feed (first time only)
deno run -A publish.ts init --title "Podcaster" --author "Damir" --email "email@example.com" --base-url "https://podcaster.<account>.workers.dev"

# Publish an episode
deno run -A publish.ts publish --title "Episode Title" --audio /path/to/file.mp3 --description "About this episode" --date 2026-02-14

# List episodes
deno run -A publish.ts list

# Delete an episode
deno run -A publish.ts delete --id "2026-02-14-episode-title"
```

## Publishing Workflow

1. Confirm audio file path and episode title with user
2. Run the publish command from the `cli/` directory
3. Verify the episode appears in the feed: `deno run -A publish.ts list`
4. Feed URL: check `episodes.json` in R2 for the configured `baseUrl`

## Optional Flags
- `--description` — Episode description (defaults to title)
- `--date` — Publication date as YYYY-MM-DD (defaults to today)
- `--episode-type` — `full` (default), `trailer`, or `bonus`
- `--duration` — Manual duration as HH:MM:SS (auto-detected via ffprobe if available)

## Notes
- Audio files must be MP3
- Duration is auto-detected if `ffprobe` is installed
- The feed rebuilds automatically on every publish/delete
- R2 bucket name: `podcaster`