mcpField
V
video-note

video-note

github.com/joelhooks生产力6552 次安装1 天前更新
代码仓库

关于 video-note

video-note 是将 Obsidian 视频笔记整理为 joelclaw.com MDX 内容的发布技能，面向维护该站点内容的人。它规定了格式转换、内容筛选、语气和文件命名流程。

主要功能

  1. 01读取 Obsidian 视频笔记
  2. 02转换为站点 MDX 格式
  3. 03提取并嵌入 YouTube 视频
  4. 04筛选并改写适合发布的内容
  5. 05清理 Obsidian 语法并生成 slug

适用场景

  1. 01将视频摘要发布为网站笔记
  2. 02把 wikilinks 转为 Markdown 链接
  3. 03整理引用、演讲者背景和相关链接

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/joelhooks/joelclaw --skill video-note

安装后在 Claude Code 中输入/video-note确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
small-logo.svg
references/
content-system.md
example-note.md

详细介绍

视频笔记发布

将 /Users/joel/Vault/Resources/videos/ 中的视频笔记转换为发布在 joelclaw.com 网站 apps/web/content/ 中的 MDX 笔记。

源格式

Vault 视频笔记采用 Obsidian Markdown，包含以下 frontmatter：

type: video
source: https://www.youtube.com/watch?v=ID
channel: Channel Name
published: YYYY-MM-DD
duration: "HH:MM:SS"
nas_path: /volume1/home/joel/video/...
transcribed: YYYY-MM-DD
tags:
  - video

正文包含：H1 标题、> [!info] Source 提示框、执行摘要、要点、演讲者背景、值得关注的引言、相关链接、标签，以及可折叠的完整转录。

输出格式

以 .mdx 格式发布到 apps/web/content/，并使用以下 frontmatter：

title: "Short descriptive title"
type: "note"
date: "YYYY-MM-DD"        # use today's date
description: "One-sentence hook in Joel's voice"
source: "YouTube URL"
channel: "Channel Name"
duration: "HH:MM:SS"

转换工作流

  1. 读取源 Vault 笔记
  2. 从 source URL 中提取 YouTube 视频 ID
  3. 用 Joel 的口吻撰写笔记（阅读 joel-writing-style 技能——它位于同一 .agents/skills/ 目录中）。关键规则：
    • 以引子开篇，而不是摘要
    • 在相关情况下采用 Joel 提供的切入角度；绝不虚构他的经历、信念或个人反应
    • 使用短段落、适度爆粗，并用粗体强调
    • 戛然而止——不要强行收尾
  4. 在引言之后嵌入视频：<YouTube id="VIDEO_ID" />
  5. 选择适合发布受众、且有来源材料支持的内容。排除完整转录、私人背景信息、客户信息和付费语料内容。然后改写相关部分：
    • 执行摘要 → 改写为引言（采用 Joel 的口吻）
    • 要点 → 保留实质内容，精简文字
    • 演讲者背景 → 设为“谁是 [Speaker]”章节
    • 值得关注的引言 → 精选为“让我印象深刻的引言”
    • 相关链接 → 保留为“相关”章节
  6. 去除 Obsidian 语法：将 > [!info] 提示框改为纯文本，将 [[wikilinks]] 改为 Markdown 链接
  7. Slug：采用简洁的 kebab-case 格式（例如 openclaw-peter-steinberger-lex-fridman）

口吻参考

有关 Joel 写作风格的详情，请阅读 joel-writing-style SKILL.md 和其中的口吻示例。要点：

  • 仅在 Joel 留有记录的言论或提供的经历中使用第一人称。适合时直接对读者说话。
  • 始终使用缩写形式
  • 用粗体强调关键短语
  • 谨慎使用表情符号（每篇笔记最多 1–2 个）
  • 标题应像叙事节拍，而不是提纲
  • 将链接自然融入句子中，绝不写“点击这里”
  • 提及他人时注明姓名并添加链接

内容系统详情

有关 joelclaw.com 的内容类型、MDX 组件和路由，请参阅 content-system.md。

示例

请参阅 example-note.md，查看展示目标格式和口吻的完整已发布笔记。

评论

支持 Markdown