by chubbyguan
把中文全渠道内容(抖音 / B站 / 小红书 / 公众号 / X / 播客)采集进个人知识库的 14 个 AI Skill:图文存图、视频转文字稿、字幕优先免 GPU、RSS/YouTube 订阅调度与每日情报简报,附带知识库 MCP server。| Ingest Chinese content into your personal knowledge base — image/video routing, subtitle-first transcription, feed subscriptions with daily digests, and a KB MCP server.
# Add to your Claude Code skills
git clone https://github.com/chubbyguan/chubbyskillsLast scanned: 6/15/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-06-15T10:24:00.672Z",
"npmAuditRan": true,
"pipAuditRan": false,
"promptInjectionRan": true
}See how chubbyskills compares with popular alternatives.
chubbyskills is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by chubbyguan. 把中文全渠道内容(抖音 / B站 / 小红书 / 公众号 / X / 播客)采集进个人知识库的 14 个 AI Skill:图文存图、视频转文字稿、字幕优先免 GPU、RSS/YouTube 订阅调度与每日情报简报,附带知识库 MCP server。| Ingest Chinese content into your personal knowledge base — image/video routing, subtitle-first transcription, feed subscriptions with daily digests, and a KB MCP server. It has 1,285 GitHub stars.
Yes. chubbyskills passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/chubbyguan/chubbyskills" and add it to your Claude Code skills directory (see the Installation section above).
chubbyskills is primarily written in Python. It is open-source under chubbyguan on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh chubbyskills against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
中文 · English
把视频、播客、文章和本地文档保存为 Markdown,整理成能搜索、能回查来源、能交给 Agent 使用的素材库。
快速开始 · 安装到 Agent · Skill 目录 · 文档 · 更新日志 · 💬 讨论区
Chubby Skills 是一套面向内容创作者和个人知识库的 14 个 Agent Skills 与命令行工具。你可以按需安装技能,让 Agent 处理素材;也可以直接运行命令,把采集、入库、搜索和资料包导出串起来。
适合经常收藏视频、文章和播客,希望在写作时找到原文、核对出处的人。产物保存在本地 Markdown 文件中,可以用 Obsidian、文本编辑器或你的 Agent 继续处理。
链接 / 本地文档 → Markdown 原文与附件 → 本地搜索 → 带出处的资料包 → Agent 整理选题
| 你想做什么 | 项目提供什么 |
|---|---|
| 保存平台素材 | 视频字幕与转录、播客转录、文章和图文采集 |
| 导入已有资料 | Markdown、TXT、PDF 文字层导入,保留来源和引用的本地附件 |
| 写作时找回证据 | 关键词搜索、可选语义检索、原文读取;采集入库后自动更新索引 |
| 整理一份选题资料 | 导出 Markdown / JSON 资料包,包含原文摘录、行号、来源和文件摘要 |
| 让 Agent 使用知识库 | 独立技能包,以及提供搜索、原文读取等工具的可选 MCP 服务 |
| 持续跟踪可靠来源 | 订阅公开 RSS / Atom / JSON Feed、YouTube 频道与用户自带 Provider 输出;发现、审核、转录与入库分离 |
先看输出样例,或直接运行下面的本地示例。
声明能力(非实时探测),最近逐平台实测见真实平台验证,完整失败模式见平台状态:
| 平台 | 状态 | 轻量路径 |
|---|---|---|
| B站 / YouTube | 稳定 | 字幕优先,仅需 yt-dlp |
| 公众号 | 测试 | HTML 需 beautifulsoup4,PDF 兜底 |
| 抖音 / TikTok / 微博 / 知乎 | 测试·重依赖 | 视频转录需 funasr + ffmpeg |
| 播客 | 重依赖 | funasr(SenseVoice-Small),可选 DashScope / Groq 云转录 |
| X / 小红书 | 手动兜底 | 零依赖采集正文;X 长文章可配 X_COOKIES 抓登录态全文,失败可手动补全文。凭据怎么拿、上次是否成功:chubby doctor --credentials |
| RSS / YouTube 频道订阅 | P0 + P1 | 公开 Feed;支持 RSSHub / RSS-Bridge BYO 标签,默认只发现 |
| 本地文档 | 稳定 | 零依赖,Markdown/TXT/PDF 文字层 |
本项目不做反爬对抗,选择轻量接口加手动兜底,原因与适用边界见为什么不对抗风控。
核心链路只用 Python 标准库:不装第三方包、不配 API Key、不下载模型。需要 Python 3.11 及以上——先 python3 --version 确认一下:macOS 自带的是 3.9,核心命令能跑,但 subscribe 订阅链路会在导入时失败,建议 brew install python@3.12 或直接用下面的 venv 步骤。
X 推文和小红书图文都走 Python 标准库,不需要 yt-dlp、ffmpeg 或任何模型(逐平台能力与失败模式见平台状态):
git clone https://github.com/chubbyguan/chubbyskills.git
cd chubbyskills
python3 tools/chubby.py init --vault "$PWD/creator-vault"
python3 tools/chubby.py ingest "https://x.com/OpenAI/status/1663696190960173056" --no-enrich
python3 tools/chubby.py search "ChatGPT"
✅ 已写入配置:/path/to/chubbyskills/chubby.yaml
✅ 已准备队列:/path/to/chubbyskills/inbox/links.txt
✅ 已准备状态:/path/to/chubbyskills/.chubby/runs.jsonl
✅ 已准备报告目录:/path/to/chubbyskills/runs
✅ 完成:success=1 / failed=0 / dry_run=0
🧾 报告:/path/to/chubbyskills/runs/2026-10-05.md
/path/to/chubbyskills/creator-vault/00_Inbox/The-ChatGPT-iOS-app-is-now-available-in---<来源哈希>.md
The ChatGPT iOS app is now available in
00_Inbox/The-ChatGPT-iOS-app-is-now-available-in---<来源哈希>.md
# The ChatGPT iOS app is now available in > 👤 OpenAI @OpenAI | 👍 754 · 💬 115 …
抓下来的笔记自带来源、作者、时间和互动数,引用时能回查到原帖:
title: "The ChatGPT iOS app is now available in "
platform: x
source: "https://x.com/OpenAI/status/1663696190960173056"
author: "OpenAI @OpenAI"
created: 2023-05-30
likes: 754
把链接换成你要存的任意推文或小红书图文即可。
平台采集会波动。 上面是一条样本,不构成成功率:没有登录态时可能被风控拦住,X 长文章默认只取到预览。失败时先看平台状态和替代处理方式,或保存正文后走下面这条。
这条完全不碰外网,任何环境都能跑通。导入一份文档,再把它搜回来(把示例换成你自己的 .md、.markdown 或 .txt;已知原始网页时加 --source-url "原始网页地址"):
mkdir -p demo-input
cat > demo-input/notes.md <<'NOTE'
# 内容复用笔记
内容复用从保留原文和来源开始。同一份材料可以用于选题、文章和播客,但引用前要重新核对上下文。
NOTE
python3 tools/chubby.py import demo-input/notes.md --no-enrich
python3 tools/chubby.py search "内容复用"
✅ 完成:success=1 / failed=0 / dry_run=0
🧾 报告:/path/to/chubbyskills/runs/2026-10-05.md
/path/to/chubbyskills/creator-vault/00_Inbox/内容复用笔记--<来源哈希>.md
内容复用笔记
00_Inbox/内容复用笔记--<来源哈希>.md
# 内容复用笔记 内容复用从保留原文和来源开始。同一份材料可以用于选题、文章和播客,但引用前要重新核对上下文。
最后导出带出处的资料包——这是这个项目真正产出的东西:
python3 tools/chubby.py brief --topic "内容复用" \
--output "$PWD/creator-vault/30_Output/brief.md"
{
"markdown": "/path/to/chubbyskills/creator-vault/30_Output/brief.md",
"json": "/path/to/chubbyskills/creator-vault/30_Output/brief.json"
}
brief.md 里是逐字摘录、原文行号、来源链接和文件 SHA-256,可以直接回查(文件名后缀由来源路径推导,SHA-256 覆盖导入副本的内容与元数据,两者都会随你实际使用的路径和时间变化):
## E1 · 内容复用笔记
笔记相对路径:`00_Inbox/内容复用笔记--c2f47ab83782202c.md`
原始来源:未提供可打开的网页链接。
采集时间:2026-10-05T10:54:57+08:00
文件 SHA-256:`<导入副本的内容哈希>`
原文第 22–22 行:
产物落在三处:
creator-vault/00_Inbox/:带来源信息的 Markdown 和引用的本地附件。creator-vault/30_Output/brief.md 与 brief.json:资料包本体。.chubby/runs.jsonl 与 runs/:任务状态和运行报告,方便检查失败与重试。brief 全程在本地完成,不调用云模型,也不判断原文观点是否正确;上面的演示材料是人工样例。再次导出请换一个文件名,确认要替换已生成的资料包后再加 --force。
chubby 装成命令上面用的是 python3 tools/chubby.py,不装也能跑。想要 chubby init 这种形式:
python3 -m venv .venv && source .venv/bin/activate
python3 -m pip install -e . # 提供 chubby 命令,等价于 python3 tools/chubby.py
也可以装成普通包(pip install .,或 pipx install git+https://github.com/chubbyguan/chubbyskills.git)。非 editable 安装下,知识库命令全部可用——init / import / search / brief / index / doctor / subscribe(含 digest 与 site build),用户状态写在你当前所在目录,不会写进安装目录。
平台采集 ingest 同样可用:14 个 skill 目录随包一起安装(目录名 bilibili-transcribe 不是合法 Python 包名,构建时映射为 bilibili_transcribe,你不需要关心)。想把这些 skill 直接装进 Agent 而不是通过 CLI 调用,仍从仓库跑 tools/install_skill.py;两种方式互不影响。
已有知识库时把 --vault 换成它的根目录(例如 docs/quickstart.md 里的 $HOME/Documents/creator-vault);已有配置的调整见创作者工作流。
按所需能力安装运行依赖。以 YouTube 字幕为例:
bash setup.sh light
python3 -m pip install yt-dlp
python3 tools/chubby.py doctor --platform youtube
python3 tools/chubby.py ingest "替换为你的真实链接" --no-enrich
python3 tools/chubby.py search "原文中的关键词"
light 检查 Python 并提示轻量路径,不安装字幕或转录依赖。B站和 YouTube 优先取字幕;没有字幕时需要视频转录依赖。查看 Skill 目录选择平台,并按下表补依赖:
| 处理路径 | 安装 / 配置 |
|---|---|
| Markdown / TXT 导入、关键词检索、资料包 | Python 标准库,无需额外包 |
| X / 小红书图文 | Python 标准库;bash setup.sh light 检查环境,登录态与平台限制仍可能影响采集 |
| B站 / YouTube 字幕 | python3 -m pip install yt-dlp |
| 本地视频转录 | bash setup.sh video;需要系统 ffmpeg,本地模型首次使用会下载 |
| 本地播客转录 | bash setup.sh podcast;使用 SenseVoice-Small(与视频转录共用 funasr 依赖) |
| 公众号及其 PDF 路径 | bash setup.sh wechat |
| 通用 PDF 文字层导入 | python3 -m pip install 'pymupdf>=1.24' |
平台抓取受 Cookie、字幕、地区和页面变化影响。失败时查看平台状态和替代处理方式,也可以保存正文后走本地导入。支持范围与最近的实测结果分开记录,见真实平台验证。
YouTube 在部分出口 IP 上要求登录证明(Sign in to confirm you are not a bot)。两个环境变量会透传到所有平台技能的 yt-dlp 调用:YTDLP_COOKIES_FROM_BROWSER(如 chrome,对应 --cookies-from-browser)和 YTDLP_REMOTE_COMPONENTS(如 ejs:github,让 yt-dlp 下载 JS 挑战求解组件)。两者均为可选,按需配置。
X 长文章(Articles)默认只能抓到预览文本并给出警告;配置 --cookies 或 X_COOKIES(自己账号的 auth_token + ct0)后走登录态接口抓全文,失效时回退为预览。详见 x-ingest。
python3 tools/chubby.py import "/你的资料目录/report.md" --no-enrich
python3 tools/chubby.py import "/你的资料目录/report.pdf" \
--source-url "https://example.org/original-report" --no-enrich
导入器保留原文件,把文档引用的目录内附件复制到产物旁;缺失或越界的本地附件会报错。PDF 只提取文字层,不做 OCR;扫描件需先由其他工具识别。详见文档导入。
默认在本地转录音频:
python3 tools/chubby.py ingest "/你的音频目录/episode.mp3" \
--skill podcast --provider local --no-enrich
本地模型默认 SenseVoice-Small,也可选 Qwen3-ASR-0.6B(--provider local --model qwen3-asr-0.6b,需自行 pip install qwen-asr transformers torch)。2026-10 在 M3 Pro CPU 上的实测:SenseVoice RTF 0.11、Qwen RTF 0.80(慢约 7 倍);质量互有胜负——Qwen 专名/人名更稳但有幻觉改写风险且无 ITN,SenseVoice 输出带情感标签需清洗。CPU 场景保持默认,GPU 或专名敏感时选 Qwen。详见 podcast-transcribe。
可选云端后端为 阿里云百炼 DashScope 的 qwen3-asr-flash(--provider dashscope,需 DASHSCOPE_API_KEY)和 Groq 的 whisper-large-v3-turbo(--provider groq,需 GROQ_API_KEY;免费层单文件上限 25MB、有速率限制,长音频自动分片转录并支持断点续传)。音频发送至云端并可能计费;DashScope 限制为编码后不超过 10MB、时长不超过 5 分钟,超限会在提交前拒绝并提示改用本地 SenseVoice-Small。完成结果持久保存,进程中断后可恢复;--resubmit 会明确创建新任务,可能再次计费。
播客自动下载仅接受公网 HTTP(S) 直连地址,不跟随重定向,也不使用代理。需要跳转或代理的资源,先自行下载,再传本地文件。配置和恢复方法见云转录说明。云服务的真实转录尚未完成验收。
相同来源、处理参数和目的地的有效产物会复用;原文件或引用附件变化后会重新导入。--refresh 重新处理并保留旧版本。
把链接逐行放入 inbox/links.txt,再运行:
python3 tools/chubby.py run --queue inbox/links.txt --no-enrich
python3 tools/chubby.py status --failed
python3 tools/chubby.py retry --all-failed
采集入库后和统一查询前,索引会增量同步。更多例子见创作者工作流;已有索引的迁移和重建见知识库自动化。
P0 将订阅扫描和媒体处理拆开:首次同步只建立已见基线,新条目先进入待审队列;确认来源质量后,可对该来源开启 auto_ingest,让 YouTube / 播客复用现有字幕优先和转录路径。
python3 tools/chubby.py subscribe init
python3 tools/chubby.py subscribe add \
--id yt-3blue1brown --name "3Blue1Brown" \
--kind youtube_channel --channel-id UCYO_jab_esuFRV4b17AJtAw \
--content-profile video --mode discover_only
python3 tools/chubby.py subscribe sync --all # 首次只建立基线
python3 tools/chubby.py subscribe pending
定时运行使用 python3 tools/chubby.py subscribe tick --due --process-limit 3,交给 macOS launchd 或 Linux cron 每小时触发。subscribe digest 把近 N 天的订阅条目汇总成每日情报简报(零 LLM 可用,事件聚簇 + 知识库关联;--enrich 可选 DeepSeek 精选摘要,模型内容带标注);subscribe site build 再把聚簇渲染成可发 GitHub Pages 的纯静态日报站(只含标题/来源/链接/热度,无正文与本地路径),并同时产出 feed.xml 与 llms.txt 两个 Agent 出口。支持用户自带 RSSHub、RSS-Bridge 或其它 Provider 的最终公开 Feed;该标签不会启用平台抓取、认证或代理。X、小红书、抖音、B站、公众号账号扫描尚未支持。完整命令、调度、Provider 边界和失败恢复见订阅与调度,真实兼容性