Przejdź do treści
Biblioteka skilli
Marketing i treści · Konwersja i formaty

podcast-transcript

/podcast-transcript

Transkrybuje odcinek podcastu w AssemblyAI i zapisuje czysty transkrypt z podpisami mówców, listę rozdziałów oraz czasy słów.

Repozytorium
open-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/transcribe.py

Co robi i kiedy

Transkrybuje odcinek podcastu w AssemblyAI i zapisuje czysty transkrypt z podpisami mówców, listę rozdziałów oraz czasy słów.

Wyzwalacze z opisu

transcribe episode Ntranscribe [guest]transcribe this
Oryginalny opis (EN)

Transcribe a podcast episode with AssemblyAI. Use when the user asks to transcribe an episode, get the transcript for a YouTube URL or a local master, or says "transcribe episode N", "transcribe [guest]" or "transcribe this". Produces a clean speaker-labelled transcript, a raw transcript, a chapter list and word-level timings in the episode folder.

Jak działa

  1. Settings
  2. When to invoke
  3. Workflow
  4. Conventions
  5. Outputs
  6. Costs
  7. Failure modes
  8. Next
Sekcje z nagłówków SKILL.md, w oryginale · 103 linii, 709 słów
Podgląd SKILL.md
---
name: podcast-transcript
description: Transcribe a podcast episode with AssemblyAI. Use when the user asks to transcribe an episode, get the transcript for a YouTube URL or a local master, or says "transcribe episode N", "transcribe [guest]" or "transcribe this". Produces a clean speaker-labelled transcript, a raw transcript, a chapter list and word-level timings in the episode folder.
version: 1.0.0
---

# /podcast-transcript

Transcribes an episode with AssemblyAI (speech model plus speaker labels and timed section summaries). Writes four files into the episode folder.

## Settings

Read the settings file first: `$PODCAST_CONFIG`, otherwise `~/.config/podcast-skills/config.json`. If neither exists, stop and ask the user to copy `config.example.json` there.

This skill uses `show.host`, `show.slug`, `paths.episodes_root`, `paths.env_file` and the `transcription` block. It needs `ASSEMBLYAI_API_KEY`.

## When to invoke

- "transcribe episode 2" / "transcribe [guest]" / "transcribe the next episode"
- "get the transcript for [YouTube URL]"
- A YouTube URL or a master file with "transcribe this"

## Workflow

### 1. Resolve the episode folder

Episode folders live under `paths.episodes_root` as `Episode N - Guest Name`.

- Episode number: look for `Episode N - *`.
- Guest name: look for `Episode * - Name*`.
- YouTube URL: search each episode README for that URL.
- Still ambiguous: ask.

### 2. Read episode metadata

From the episode `README.md`, take `episode:` and `guest:` from the frontmatter, plus the YouTube URL if there is one.

### 3. Confirm before billing

Tell the user the episode, the source (URL or file), the files that will be written and the cost estimate (`--dry-run` prints it). Wait for confirmation unless they have already said to go.

### 4. Run the script

Normal case: post-production runs before YouTube, so there is no URL yet. Extract a small mono audio file from the master and pass that. Transcript timing then equals master timing, which `/shorts` relies on.

```bash
ffmpeg -y -i "<master>.mp4" -vn -c:a aac -b:a 128k -ac 1 /tmp/episode-audio.m4a

~/.claude/skills/podcast-transcript/.venv/bin/python \
  ~/.claude/skills/podcast-transcript/scripts/transcribe.py \
  --input-file /tmp/episode-audio.m4a \
  --output-dir "<episode-folder>" \
  --guest-name "Guest Name" \
  --episode N
```

If the episode is already on YouTube, swap `--input-file` for `--url "<url>"`.

Add `--force` only after the user confirms overwriting existing transcripts.

**Master changed after transcription?** If a re-cut only removes or shifts ranges and the body is frame-identical, do not re-run. Shift every timestamp after the cut by the exact delta in `transcript-clean.md`, `chapters.md`, `youtube-description.md` and `episode-page.md`. Delete the cut sentences from the transcript text. Note in the README that `transcript-words.json` still carries the old timings. A shift is exact; a re-run costs money and produces different wording to re-review.

### 5. Verify outputs

Check the four files exist: `transcript-raw.txt`, `transcript-clean.md`, `chapters.md`, `transcript-words.json`. If any are missing, report the script's stderr.

### 6. Update the episode README

Note in the episode README that the transcript is done, and update `status:` if the README tracks one.

### 7. Report back

Give the duration, word count, speaker count, chapter count and cost estimate from the script's output. Warn if it detected three or more speakers, because the labels need a manual check.

## Conventions

- The first voice heard is labelled as the host. This holds when the host opens the episode. If a cold open starts with the guest, swap the labels by hand.
- Files are not overwritten by default: the script exits with an error if outputs exist.
- Apply `glossary` from the settings file to `transcript-clean.md` after the run, because speech-to-text gets names wrong.
- Keep API keys out of the skill folder. Use `paths.env_file` or the environment.

## Outputs

See `references/output-formats.md` for examples.

| File | Purpose |
|------|---------|
| `transcript-raw.txt` | Plain text, for archive. |
| `transcript-clean.md` | Speaker-labelled and timestamped. Feeds `/youtube-description` and `/podcast-episode-page`. |
| `chapters.md` | YouTube timestamps plus section summaries. Feeds `/youtube-description`. |
| `transcript-words.json` | Word timings in milliseconds. `/shorts` uses these to pick cut points. |

## Costs

The settings file holds `cost_per_hour_usd` (default 0.20). That is the sum of AssemblyAI's list prices for Universal-2, standard diarization and summarization when this was written. Check https://www.assemblyai.com/pricing and update the setting, because the script's estimate only knows what you tell it.

## Failure modes

- **yt-dlp fails on a private video** (unlisted is fine). Download it by hand and pass `--input-file`.
- **Cost cap** (`cost_cap_usd`) stops accidental runs on multi-hour files. Override with `--cost-cap-usd`.
- **AssemblyAI errors** come through from the API response, usually a rate limit or invalid audio.
- **No chapters returned:** `chapters.md` says so. Write them by hand from the transcript.
- **API key missing:** the script exits and says where to put it.

## Next

`/youtube-description` consumes `transcript-clean.md` and `chapters.md`.
Pliki w paczce (4)
  • SKILL.md 5 KB
  • references/output-formats.md 2 KB
  • scripts/requirements.txt 1 KB
  • scripts/transcribe.py 18 KB

Wersje

W bazie nie ma innych skilli o nazwie podcast-transcript.

Migawka bazy z 13.11.2026 · wersja paczki 8f4ecf24fb91 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100youtube-description
    Pisze tytuły i gotowy opis z tagami YouTube dla odcinka podcastu, na podstawie transkrypcji, rozdziałów i notatek.
  • 100podcast-episode-kit
    Przygotowuje odcinek podcastu: brief gościa, plan rozmowy, tytuły, opisy, notatki ze znacznikami czasu i rozdziałami.
  • 100podcast-episode-page
    Pisze stronę odcinka podcastu w markdown z metadanymi PodcastEpisode, sekcjami treści i informacjami dla wyszukiwarek.
  • 100transcribe-youtube
    Pobiera filmy z YouTube, transkrybuje je przez yt-dlp i Whisper i zapisuje tekst w pliku markdown.
  • 100podcast
    Zbiera materiał na zadany temat, pisze scenariusz i składa jeden odcinek podcastu w formie pliku mp3.
  • 100podcast-notes
    Transkrybuje odcinki podcastu lokalnie na Macu przez whisper.cpp i pisze notatki z czasem w jednym pliku HTML.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.