Douyin Study
939735641hjl-netizen/douyin-study
Converta vídeos do Douyin em notas estruturadas para Obsidian
Ver no GitHubSkill que transforma automaticamente vídeos salvos do Douyin em notas estruturadas para Obsidian. Baixa o vídeo, transcreve via ASR local, analisa o conteúdo, busca notas relacionadas no vault e gera uma nota de conhecimento com links bidirecionais bem integrados.
Instalação
npx convez-ai 939735641hjl-netizen/douyin-study1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Capturar aprendizados de vídeos em rede social
- Organizar conhecimento em Obsidian com contexto e ligações
- Processar lotes de vídeos salvos para revisão estruturada
Veredito

Skill bem pensado que une transcrição local, análise de conteúdo e integração profunda com Obsidian. Exige stack técnico considerável (mrcarlsama, uv, vault configurado), mas entrega valor real para quem estuda via redes sociais e mantém base de conhecimento.
README
A tradução para o português deste README ainda está na fila.
douyin-study
将抖音收藏视频自动转化为 Obsidian 学习笔记的 Claude Code Skill。一条链接进去,一篇结构化笔记出来。
这是什么
douyin-study 是一个 Claude Code 自定义技能。给它一条抖音分享链接,它会:
- 下载视频 + 本地 ASR 语音转文字
- 分析内容,提炼核心概念
- 搜索你的 Obsidian vault,找到相关笔记
- 生成一篇结构化的 Obsidian 学习笔记,自动建立双向链接
- 更新主题索引,形成可检索的知识网络
不是摘要器,是知识节点生成器。 笔记按"知识节点"理念组织——连贯段落、链接融入正文、元数据只在 frontmatter——而不是填表。
效果演示
输入:一条抖音链接 输出:一篇 Obsidian 笔记
生成的笔记长这样:
- 干净的 frontmatter(title、source、author、tags)
- 2-3 个按内容命名的自然分区
- 正文中概念出现时当场
[[双向链接]],不是堆在底部 - 匹配到的 vault 已有笔记自动关联
- 可执行的行动清单
前提条件
- Claude Code 已安装
- mrcarlsama-social-transcriber skill 已安装(用于下载视频和本地 ASR 转写)
- uv Python 包管理器(mrcarlsama 的依赖)
- Obsidian vault(你日常使用的知识库)
安装
# 1. 克隆到 Claude Code skills 目录
git clone https://github.com/939735641hjl-netizen/douyin-study.git ~/.claude/skills/douyin-study
# 2. 在你的 Obsidian vault 根目录创建配置
mkdir -p "你的vault路径/.douyin-study"
在 vault 的 .douyin-study/config.json 中(可选,有默认值):
{
"vault_path": "/你的/vault/路径",
"notes_folder": "Resources-资源/douyin",
"indexes_folder": "Resources-资源/indexes",
"template_path": "templates/video-learning-template.md"
}
如果安装了 templates/video-learning-template.md 模板到你的 vault,skill 会使用它;否则使用内置默认格式。
使用方法
单条处理
在 Claude Code 中输入:
/douyin-study 你的抖音分享链接
或者直接贴链接,Claude 会自动识别。
批量处理
在 vault 的 .douyin-study/pending.md 中添加链接,一行一条:
https://v.douyin.com/xxxxxxxxx/
https://v.douyin.com/yyyyyyyyy/
然后运行 /douyin-study(无参数),逐条处理。
工作流程
抖音链接
→ MrCarlsama 下载 + ASR 转写
→ Claude 分析逐字稿,提炼概念
→ 搜索 vault 已有笔记,建立关联
→ 生成 Obsidian 笔记(知识节点格式)
→ 更新主题索引 + 反向链接
→ 清理原始数据
文件结构
douyin-study/
├── SKILL.md ← 主指令文件
├── LICENSE ← MIT
├── CHANGELOG.md ← 版本记录
├── examples/ ← 输入输出示例
│ ├── example-input.md
│ ├── example-output-knowledge.md
│ └── example-output-tutorial.md
├── reviews/ ← 规则与质量保障
│ ├── boundary-conditions.md ← 何时触发 / 何时不触发
│ ├── quality-checklist.md ← 生成前自查 20 项
│ └── failure-modes.md ← 6 种已知失败 + 处理
└── references/ ← 参考知识库
├── obsidian-linking-guide.md
└── note-structure-principles.md
设计理念
- 知识节点,不是填表 — 笔记是独立可读的知识页面,不是被填满的问卷
- 链接融入正文 —
[[双向链接]]出现在句子中,不堆在底部 - 元数据只在 frontmatter — 正文不重复表格
- 不留空槽位 — 没有内容 = 不出现该区域
详见 references/note-structure-principles.md。
贡献
欢迎 PR 和 Issue。建议先阅读 reviews/quality-checklist.md 了解质量标准。
致谢
- MrCarlsama Social Transcriber Skill — 抖音视频下载和本地 ASR 转写引擎
- Anthropic Skills — Claude Code Skill 规范和模板
许可证
MIT © 2026 Alex Hou