用途
该技能面向需要把 YouTube 视频内容沉淀为 Obsidian 笔记的用户。它接收一个 YouTube URL，按固定流程自动抓取字幕、清理文本、分段、生成目录、写入笔记并提交到 git，最终产出一份结构化的 Markdown 笔记。
主要能力
- 抓取带时间戳的 SRT 字幕和纯文本字幕。
- 对纯文本字幕进行清理：纠正拼写、语法、标点、大小写，合并碎片化短语，去除填充词、重复词、旁白标签、舞台指示和尾部 URL，每句一行并用空行分隔。
- 将清理后的字幕划分为 4–7 个自然主题段落，每段使用 ## 标题，并在标题下附上对应起始时间的 YouTube 时间戳链接。
- 在正文顶部生成 Obsidian wikilink 格式的目录。
- 直接使用 YouTube 托管的缩略图地址，不经过图床上传。
- 根据视频标题生成库安全文件名，写入指定 Obsidian 库路径。
- 通过 git 暂存并提交新文件。
- 对食谱或烹饪类内容，调用 recipe-cleanup 技能补充食材清单和步骤，并再次提交。
使用方式
技能按步骤顺序执行，步骤之间不提示用户，除非某一步失败。
- 抓取带时间戳的字幕：运行
uv run --no-active --project /Users/mtm/pdev/taylormonacelli/benevolentbadger benevolentbadger --format srt "<youtube_url>"，保存完整 SRT 输出。同时运行不带格式参数的同一命令获取纯文本字幕。 - 清理字幕：这是转写任务而非摘要任务，所有口语内容都必须出现在输出中，不得跳过、压缩或总结。按规则清理后，每句一行、句间空行。
- 分段：识别 4–7 个自然主题断点，每句清理后的字幕必须且只能出现在一个段落中。每段写 ## 标题，并在标题下一行附上
https://youtu.be/<VIDEO_ID>?t=<seconds>s形式的裸链接。 - 构建目录：在正文顶部、第一个 ## 段落之前，使用 Obsidian wikilink 标题格式添加目录。
- 缩略图：直接使用
https://i.ytimg.com/vi/<VIDEO_ID>/maxresdefault.jpg，不运行 social-to-imgur 技能。 - 生成文件名：视频标题转小写、空格分隔、去除特殊字符，必要时加频道名前缀。
- 写入笔记：写入
/Users/mtm/Documents/Obsidian Vault/<filename>.md，包含 frontmatter（tags、pic）、缩略图、视频链接、引言、目录和各分段。规则包括：不写 # 标题、标签只用库中已有标签、每句一行且句间空行、不使用斜体或粗体、产品名链接到本地库页面或 Google 图片搜索。 - 提交：分别运行
git add "<filename>.md"和git commit -m "Add <short topic> note from YouTube transcript"，每条 git 命令单独执行，不用 && 连接。 - 食谱清理（仅烹饪/食谱内容）：根据标题关键词、频道关联或字幕中的食材用量和烹饪术语判断。若为食谱内容，调用
/recipe-cleanup <absolute path to vault note>，完成后再次提交。
适用场景
- 将 YouTube 讲座、教程、访谈等视频内容整理为可检索的 Obsidian 笔记。
- 需要保留时间戳以便回看原视频片段的场景。
- 需要把视频字幕转为逐句可读文本并分主题归档的场景。
- 食谱类视频需要额外提取食材和步骤的场景。
限制
- 依赖 benevolentbadger 工具及其本地项目路径。
- 笔记写入路径固定为
/Users/mtm/Documents/Obsidian Vault/。 - 标签只能使用库中已有标签，未经用户批准不得新建。
- 缩略图仅适用于 YouTube，其他平台仍需上传图床。
- 食谱清理仅对烹饪/食谱内容生效，非此类内容跳过。
- 关于收费、价格、平台支持范围等信息暂未提供。