Podcast Transcribe
by @dairui1
For transcript or subtitle requests involving podcast URLs, public audio URLs/files, or raw transcript cleanup. Generates audio + SRT + TXT artifacts and can...
clawhub install podcast-transcribeπ About This Skill
name: transcribe description: "For transcript or subtitle requests involving podcast URLs, public audio URLs/files, or raw transcript cleanup. Generates audio + SRT + TXT artifacts and can optionally clean transcripts with episode-page context." allowed-tools: Bash(curl:*), Bash(podcast-helper:*), Bash(npx podcast-helper:*), Bash(pnpm dlx podcast-helper:*), Bash(node dist/cli.js:*), Bash(pnpm run build:*) metadata: version: "1.4.1" tags: [podcast, transcription, audio, subtitles, asr, cleanup]
Transcribe with podcast-helper
Generate transcript artifacts from a podcast episode, audio file, or raw transcript, with an optional cleanup pass that uses episode-page context.
Default Workflow
1. Choose a dedicated output directory such as ./out/.
2. Run npx podcast-helper transcribe --output-dir .
3. Add --progress jsonl only when machine-readable progress is needed.
4. Report the generated artifact paths for audio, .srt, and .txt.
5. Ask whether the user wants cleanup. Do not run cleanup implicitly.
If you are already inside this repository and dist/cli.js exists, node dist/cli.js ... is acceptable. Do not default to repository-local build steps outside this repository.
If you are inside this repository and dist/cli.js is missing, run pnpm run build before using the repo-local entry point.
Gotchas
npx, then pnpm dlx, then a globally installed podcast-helper.yt-dlp.mlx-whisper runs require ffmpeg, python3, and a working runtime from podcast-helper setup mlx-whisper.*.cleaned.txt.Command Forms
Default:
npx podcast-helper transcribe --output-dir ./out/ --json
Fallbacks:
pnpm dlx podcast-helper transcribe --output-dir ./out/ --json podcast-helper transcribe --output-dir ./out/ --json node dist/cli.js transcribe --output-dir ./out/ --json only inside this repositoryFor offline Apple Silicon:
npx podcast-helper transcribe --engine mlx-whisper --output-dir ./out/ --json
Cleanup Branch
Only enter cleanup when the user asks for it or already has a raw transcript.
1. Fetch episode context with curl https://r.jina.ai/.
2. Use the page as reference context for obvious ASR repairs, especially names and proper nouns.
3. Do not summarize, invent missing content, or overwrite the raw transcript.
4. Write a sibling *.cleaned.txt file.
If no episode URL is available, clean conservatively and explicitly say that external episode context was not used.
References
references/inputs-and-engines.md for supported inputs, engine selection, and dependency notes.references/output-contract.md for the JSON success and failure envelopes and progress handling.references/cleanup.md for detailed cleanup rules and conservative editing guidance.references/verification.md for smoke-test inputs and verification steps.references/setup.md when installing this skill into Claude Code, OpenClaw, or other agents.