agentleFS
liwenjinchnliwenjinchn/claude-skills/podcast-transcribe/SKILL.md

podcast-transcribe

Skill0 starsChanged 5 months agoMITView on GitHub

播客转录 + 内容分析。当用户粘贴 xiaoyuzhoufm.com 链接、播客音频直链(.mp3/.m4a) 或本地音频文件并希望转文字/分析时使用:下载音频 → mlx-whisper 转录(Apple GPU)→ 带时间戳 Markdown → 内容分析。触发词:小宇宙链接、"转录这个播客"、"听一下这期"。

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. chubbyguan/chubbyskills★ 1.3ksame name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repositoryOne other file it gives its agents.

The file

Files
SKILL.md

播客转录分析

流程

  1. 转录(下载 + 探测时长 + mlx-whisper large-v3-turbo):

    python3 ~/.claude/skills/podcast-transcribe/scripts/transcribe.py "<小宇宙链接或音频直链>"
    • 输出 ~/Archive/podcasts/<标题slug>.md(frontmatter + [hh:mm:ss] 文本 逐段)
    • 脚本会用 ffprobe 探测时长;超过 1 小时自动进入长音频分段模式
    • 长音频务必后台跑,期间可干别的;不要因为终端短时间安静就判断卡死
  2. 长音频处理:

    • 默认每 30 分钟切一段,逐段转录并断点保存
    • 中间产物:
      • ~/Archive/podcasts/<标题slug>.partial.md:已完成段落,可边跑边读
      • ~/Archive/podcasts/<标题slug>.work/status.json:当前状态、段号、总段数、输出路径
      • ~/Archive/podcasts/<标题slug>.work/segments/*.json:每段转录结果,重跑会复用
    • 可调参数:

      python3 ~/.claude/skills/podcast-transcribe/scripts/transcribe.py "<链接>" --chunk-minutes 20
      python3 ~/.claude/skills/podcast-transcribe/scripts/transcribe.py "<链接>" --force-single
  3. 读取:转录文件可能很长(2h ≈ 2000+ 段,10h ≈ 3 万行),先 Read 开头和结尾确认质量,再用 Grep 定位主题
  4. 分析:默认输出——
    • 本期核心观点(3-5 条,带 [时间戳] 方便回听定位)
    • 嘉宾的关键判断/预测(明确区分事实陈述 vs 个人观点)
    • 值得追问的点(主持人没追、嘉宾没展开的)
    • 如果用户要深度总结,补充:结构化摘要、重点章节、怎么理解、可迁移的方法论

引擎与兜底

  • 优先 mlx_whisper(已装,模型 mlx-community/whisper-large-v3-turbo,首跑自动下载 ~1.6GB)
  • HuggingFace 下载慢/失败 → HF_ENDPOINT=https://hf-mirror.com 重试
  • mlx 不可用 → 脚本自动回退本机 whisper CLI small(CPU 慢且准确率低,仅应急)
  • 页面无 og:audio(非小宇宙平台)→ 用 yt-dlp -x 下音频(支持喜马拉雅/B站/YouTube),再把本地文件传给脚本
  • 长音频分段依赖 ffmpeg/ffprobe;缺失时先安装或改用 --force-single

注意

  • 中文转录准确率 ~90-95%,专有名词(人名/公司名)常错,引用原话时注明"转录稿,未校对"
  • 不支持说话人分离,多人对谈需靠上下文判断谁在说
  • 小宇宙超长节目经常有 5-10 小时;优先看 status.json 和 .partial.md 判断进度,不要只看进程是否有输出

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.