Skip to content
Back to search

read-buddy

Read Buddy: Agent Skills for reading webpages, RSS, YouTube, X, Feishu docs, OCR, podcasts, topics and personal knowledge sources

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/spacezephyr--read-buddy/badge.svg)](/listings/spacezephyr--read-buddy)

HTML

<a href="/listings/spacezephyr--read-buddy"><img src="/api/listings/spacezephyr--read-buddy/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Read Buddy 基于开放的 Agent Skills 协议,可在任何 skills-compatible 的 AI agent runtime 中运行。

方式一:一行命令(推荐,跨 runtime)

打开你正在用的 agent(Claude Code、Codex、Cursor、OpenClaw、Hermes、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等),告诉它:

帮我安装这个 skill:https://github.com/SpaceZephyr/read-buddy

或者用通用 CLI 安装器(vercel-labs/skills,支持多 runtime):

npx skills add SpaceZephyr/read-buddy

它会自动识别你当前的 runtime 并把 skill 放到正确目录。需要指定时可加 runtime 参数,例如 `-a codex` / `-a claude-code` / `-a cursor`。

方式二:手动安装

克隆仓库后,把需要的 skill 目录复制到你的 runtime skills 目录:

git clone https://github.com/SpaceZephyr/read-buddy.git

仓库结构:

read-content-digest/
read-feishu-doc/
read-ocr/
read-personal-data-harvester/
read-podcast-script-generator/
read-podcast-workflow/
read-rss-aggregator/
read-topic-collector/
read-url-markdown/
read-weread-analyzer/
read-weread-coach/
read-weread-export/
read-web-article-translator/
read-web-scraper/
read-x-blogger-analyzer/
read-x-markdown/
read-xiaoyuzhou-article/
read-youtube-feed/
read-youtube-transcript/

每个子目录都是一个独立 Skill。

命名规范

Read Buddy 内所有 Skill 都统一使用 `read-*` 命名,目录名与 `SKILL.md` 里的 `name` 保持一致。

- `read-`:表示这是 SpaceZephyr 体系下的信息读取与消化类 Skill。 - 中间词:说明来源或对象,例如 `youtube`、`x`、`rss`、`web`、`feishu`。 - 后缀词:说明动作或输出,例如 `markdown`、`transcript`、`digest`、`aggregator`、`translator`。

例如:`read-url-markdown` 把网页转成 Markdown,`read-youtube-transcript` 提取 YouTube 字幕,`read-content-digest` 消化长内容。

方式三:作为参考资料使用

即使你的 runtime 不支持 Agent Skills 自动加载,也可以直接打开对应目录里的 `SKILL.md`,把内容粘贴进对话。 它本质是一份 markdown + YAML frontmatter + 可运行脚本或工作流说明。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 317 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <h1 align="center">Read Buddy</h1>
  2. <p align="center"><code>read-buddy.skill</code></p>
  3. <p align="center"><em>「你想读懂的下一份信息,何必先被格式困住」</em></p>
  4. <p align="center">
  5. <img alt="License MIT" src="https://img.shields.io/badge/License-MIT-c8a500?style=for-the-badge">
  6. <img alt="Agent Skills Standard" src="https://img.shields.io/badge/Agent%20Skills-Standard-5aa524?style=for-the-badge">
  7. <img alt="skills.sh Compatible" src="https://img.shields.io/badge/skills.sh-Compatible-1888c8?style=for-the-badge">
  8. <img alt="Runtime" src="https://img.shields.io/badge/Runtime-Claude%20Code%20%C2%B7%20Codex%20%C2%B7%20Cursor%20%C2%B7%20OpenClaw%20%C2%B7%20Hermes-7b2bd9?style=for-the-badge">
  9. </p>
  10. <p align="center">
  11. 公众号 / 小红书 / B站 / 知乎:<strong>空格的键盘</strong> | <a href="mailto:wzfh520@gmail.com">wzfh520@gmail.com</a>
  12. </p>
  13. Read Buddy 是一套给内容创作者、研究者、产品人和知识工作者用的信息读取 Skill 集合。
  14. 它帮你把网页、RSS、YouTube、播客、X/Twitter、飞书文档、图片 OCR、微信读书、个人阅读记录和热点信号,转成可读、可检索、可总结、可继续写作的结构化内容。
  15. 基于开放的 Agent Skills 协议,可在 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等兼容 runtime 中运行。
  16. 不是让 AI 凭空总结一段它没读过的材料。
  17. 是先把来源内容拿回来,再让 Agent 帮你完成:
  18. - 读网页、转 Markdown、保留元数据
  19. - 读 YouTube 字幕、播客更新和长内容
  20. - 读 RSS 和 AI 热点,形成每日信息面
  21. - 读飞书文档、图片/PDF OCR、个人历史数据
  22. - 读微信读书划线、书架和阅读数据,生成导出、分析和回顾
  23. - 读 X/Twitter 内容和博主风格,但明确反爬与同意边界
  24. - 把长内容消化成摘要、选题、长文或短帖
  25. 看效果 · 安装 · 它能读什么 · 使用方式 · 工作原理 · 诚实边界
  26. ## 效果示例
  27. ```text
  28. 用户 ❯ 把这篇网页转成 Markdown
  29. 助手 ❯ 已读取 URL,完成正文提取。
  30. 输出包含:
  31. - 标题、作者、发布时间
  32. - 正文 Markdown
  33. - 原文链接
  34. - 图片引用
  35. 已过滤导航、广告、页脚等噪声。
  36. ```
  37. 再看 YouTube:
  38. ```text
  39. 用户 ❯ 帮我提取这个 YouTube 视频字幕并总结
  40. 助手 ❯ 已提取字幕,优先语言:中文 / 英文。
  41. 主要观点:
  42. 1. AI Agent 的价值不在替代按钮,而在连接上下文
  43. 2. 工作流稳定性比单次模型能力更重要
  44. 3. 好的工具应该留下可复用的中间产物
  45. 可继续生成:短帖、长文、金句、选题卡。
  46. ```
  47. 再看热点采集:
  48. ```text
  49. 用户 ❯ 看看最近 3 天 AI 圈有什么新东西
  50. 助手 ❯ 已聚合 RSS / Product Hunt / Hacker News / 官方博客 / X 公开信息。
  51. 今日值得关注:
  52. - 新模型发布:适合写快讯
  53. - AI 编程产品更新:适合做教程
  54. - Agent 工作流案例:适合拆方法论
  55. - 开源项目上榜:适合做选题池
  56. ```
  57. Read Buddy 的目标不是囤信息。
  58. 它负责把信息变成下一步可以用的材料。
  59. ## 安装
  60. Read Buddy 基于开放的 Agent Skills 协议,可在任何 skills-compatible 的 AI agent runtime 中运行。
  61. ### 方式一:一行命令(推荐,跨 runtime)
  62. 打开你正在用的 agent(Claude Code、Codex、Cursor、OpenClaw、Hermes、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等),告诉它:
  63. ```text
  64. 帮我安装这个 skill:https://github.com/SpaceZephyr/read-buddy
  65. ```
  66. 或者用通用 CLI 安装器(vercel-labs/skills,支持多 runtime):
  67. ```bash
  68. npx skills add SpaceZephyr/read-buddy
  69. ```
  70. 它会自动识别你当前的 runtime 并把 skill 放到正确目录。需要指定时可加 runtime 参数,例如 `-a codex` / `-a claude-code` / `-a cursor`。
  71. ### 方式二:手动安装
  72. 克隆仓库后,把需要的 skill 目录复制到你的 runtime skills 目录:
  73. ```bash
  74. git clone https://github.com/SpaceZephyr/read-buddy.git
  75. ```
  76. 仓库结构:
  77. ```text
  78. read-content-digest/
  79. read-feishu-doc/
  80. read-ocr/
  81. read-personal-data-harvester/
  82. read-podcast-script-generator/
  83. read-podcast-workflow/
  84. read-rss-aggregator/
  85. read-topic-collector/
  86. read-url-markdown/
  87. read-weread-analyzer/
  88. read-weread-coach/
  89. read-weread-export/
  90. read-web-article-translator/
  91. read-web-scraper/
  92. read-x-blogger-analyzer/
  93. read-x-markdown/
  94. read-xiaoyuzhou-article/
  95. read-youtube-feed/
  96. read-youtube-transcript/
  97. ```
  98. 每个子目录都是一个独立 Skill。
  99. ### 命名规范
  100. Read Buddy 内所有 Skill 都统一使用 `read-*` 命名,目录名与 `SKILL.md` 里的 `name` 保持一致。
  101. - `read-`:表示这是 SpaceZephyr 体系下的信息读取与消化类 Skill。
  102. - 中间词:说明来源或对象,例如 `youtube`、`x`、`rss`、`web`、`feishu`。
  103. - 后缀词:说明动作或输出,例如 `markdown`、`transcript`、`digest`、`aggregator`、`translator`。
  104. 例如:`read-url-markdown` 把网页转成 Markdown,`read-youtube-transcript` 提取 YouTube 字幕,`read-content-digest` 消化长内容。
  105. ### 方式三:作为参考资料使用
  106. 即使你的 runtime 不支持 Agent Skills 自动加载,也可以直接打开对应目录里的 `SKILL.md`,把内容粘贴进对话。
  107. 它本质是一份 markdown + YAML frontmatter + 可运行脚本或工作流说明。
  108. ## 使用
  109. 装好后,可以直接告诉 agent:
  110. ```text
  111. 把这个网页保存成 Markdown
  112. ```
  113. ```text
  114. 提取这个 YouTube 视频的中文字幕
  115. ```
  116. ```text
  117. 把这个小宇宙单集转成文章
  118. ```
  119. ```text
  120. 把这篇播客摘要改成口播脚本
  121. ```
  122. ```text
  123. 最近 3 天 RSS 有什么更新
  124. ```
  125. ```text
  126. 分析这个 X 博主的内容风格
  127. ```
  128. ```text
  129. 把这篇英文网页翻译成中文 Markdown
  130. ```
  131. ```text
  132. 读取这个飞书文档
  133. ```
  134. ```text
  135. 导出我的微信读书划线
  136. ```
  137. ```text
  138. 分析我的微信读书,生成阅读画像
  139. ```
  140. ```text
  141. 把这张图里的文字 OCR 出来
  142. ```
  143. ```text
  144. 开始今日 AI 热点采集
  145. ```
  146. ## 它能读什么
  147. | Skill | 解决的问题 | 输出 |
  148. | --- | --- | --- |
  149. | `read-url-markdown` | 用 Chrome CDP 读取网页,支持登录态页面等待后转 Markdown | Markdown |
  150. | `read-web-scraper` | 轻量网页抓取,把 HTML 正文转 Markdown | Markdown / raw HTML |
  151. | `read-web-article-translator` | 在线文章翻译为中文并保存 Markdown | 中文 Markdown |
  152. | `read-x-markdown` | X/Twitter 推文、线程、文章转 Markdown,使用前需明确同意风险 | Markdown + YAML |
  153. | `read-x-blogger-analyzer` | 分析 X/Twitter 博主内容风格、爆款原因和增长策略 | 分析报告 |
  154. | `read-youtube-feed` | 获取关注 YouTube 博主/播客的近期更新 | 更新列表 |
  155. | `read-youtube-transcript` | 提取 YouTube 字幕并转成中文文字稿 | Markdown / text / JSON |
  156. | `read-podcast-workflow` | YouTube 播客更新选择、字幕提取、内容消化、飞书保存 | 工作流产物 |
  157. | `read-podcast-script-generator` | 播客笔记、摘要、文稿改写成视频口播脚本 | 口播脚本 |
  158. | `read-xiaoyuzhou-article` | 小宇宙单集音频下载、Groq Whisper 转录、整理成文章 | 文稿 + 文章 |
  159. | `read-rss-aggregator` | 聚合 OPML 中的 RSS 源近期更新 | 更新摘要列表 |
  160. | `read-topic-collector` | 采集 AI 热点、产品发布、论文、博客和社区动态 | 结构化热点清单 |
  161. | `read-content-digest` | 长文、播客、访谈、文章转短帖和长文叙事 | 摘要 / 短帖 / 长文 |
  162. | `read-feishu-doc` | 通过飞书开放 API 读取飞书文档和 blocks | 文档内容 / blocks JSON |
  163. | `read-ocr` | 图片、PDF、扫描件 OCR 识别 | 结构化 JSON / 文本 |
  164. | `read-weread-export` | 导出微信读书个人划线和想法,支持 Markdown / PDF | 读书笔记文件 |
  165. | `read-weread-analyzer` | 基于书架、阅读时长、划线和想法生成 10 维度阅读分析 | 9:16 HTML 阅读报告 |
  166. | `read-weread-coach` | 用已读书做阶梯书单、写作引用和每日划线回顾 | 推荐 / 引用 / 回顾 |
  167. | `read-personal-data-harvester` | 采集用户自己的阅读、观看、收藏历史到本地数据库 | SQLite / 结构化数据 |
  168. ## 使用方式
  169. 你可以用自然语言直接触发,也可以点名调用单个 Skill。
  170. | 方式 | 示例 | 会触发什么 |
  171. | --- | --- | --- |
  172. | URL 读取 | `把这个网页转 Markdown`、`保存这篇文章` | 读取网页正文、清理噪声、输出 Markdown |
  173. | 视频/播客 | `提取这个 YouTube 字幕`、`处理这个播客` | 拉字幕、生成文字稿、可继续摘要和入库 |
  174. | 小宇宙播客 | `小宇宙转文字`、`把这个小宇宙链接转成文章` | 下载音频、切片转录、生成文稿和文章 |
  175. | 口播脚本 | `改成口播`、`生成播客脚本` | 把播客摘要改写成第一人称视频脚本 |
  176. | 信息流更新 | `最近 RSS 有什么`、`获取播客更新` | 聚合 RSS 或 YouTube 关注源 |
  177. | 热点采集 | `开始今日选题`、`今日 AI 热点` | 多源搜索并生成结构化热点列表 |
  178. | 内容消化 | `总结这篇长文`、`生成短帖和长文版` | 提炼观点、反共识、金句和叙事结构 |
  179. | 文档读取 | `读取这个飞书文档`、`提取 blocks` | 调用飞书 API 获取文档内容 |
  180. | OCR 读取 | `识别这张图`、`提取 PDF 文字` | 调用 OCR 脚本返回文本和置信度 |
  181. | 微信读书 | `导出我的微信读书划线`、`分析我的微信读书`、`今日笔记` | 导出笔记、生成阅读报告、抽取历史划线 |
  182. | X 分析 | `保存这条推文`、`分析这个博主` | 转 Markdown 或生成博主分析报告 |
  183. | 个人数据 | `同步我的读书记录`、`采集我的收藏` | 在本机建立个人内容历史采集管道 |
  184. ## 工作原理
  185. Read Buddy 不是一个单一爬虫,而是一组信息读取和消化 Skill。
  186. 它把阅读任务拆成四层:
  187. | 层次 | 说明 |
  188. | --- | --- |
  189. | 来源接入 | URL、RSS、YouTube、X、飞书、OCR、微信读书、本地文件、个人平台数据 |
  190. | 内容抽取 | HTML 清洗、字幕提取、OCR、API blocks、线程解析、RSS 条目聚合 |
  191. | 结构化整理 | Markdown、JSON、SQLite、YAML front matter、更新列表、分析报告 |
  192. | 认知处理 | 摘要、翻译、热点判断、风格分析、选题提炼、长短文改写 |
  193. 常见分支:
  194. - 网页读取:优先用轻量抓取,遇到登录态或 JS 渲染页面时使用 Chrome CDP。
  195. - 视频播客:先获取更新或字幕,再交给 `read-content-digest` 做观点提炼;小宇宙单集可走 `read-xiaoyuzhou-article` 下载音频并转写。
  196. - 口播创作:播客摘要或结构化笔记可交给 `read-podcast-script-generator` 改成视频口播稿。
  197. - 热点采集:先收集多源链接,再按来源、主题和选题价值整理。
  198. - X 内容:能手动就手动,自动抓取需要用户知情并接受反爬风险。
  199. - 微信读书:依赖官方 `weread-skills` 提供的 API Gateway 和用户自己的 `WEREAD_API_KEY`。
  200. - 个人数据:只处理用户自己的数据,默认本地保存,不上传。
  201. ## 适合谁
  202. - 自媒体作者:读网页、读视频、读热点,沉淀选题和素材
  203. - 研究者:聚合 RSS、论文、官方博客和访谈内容
  204. - 产品经理:追踪竞品动态、用户讨论、行业新闻
  205. - 播客听众:把 YouTube / 小宇宙播客转文字稿、摘要、文章和口播脚本
  206. - 知识管理用户:把网页、飞书、个人历史数据转成本地知识库
  207. - 内容运营:分析 X 博主、热点来源和内容风格
  208. ## 风控与安全性说明
  209. Read Buddy 的定位是公开内容读取、个人数据整理和知识消化,不是账号自动化或大规模爬虫工具。
  210. - 只读优先:默认只读取公开内容、用户提供的链接、用户本机文件或用户自己的平台数据。
  211. - 不做账号动作:不执行发帖、点赞、评论、关注、私信、批量互动等写操作。
  212. - 凭据不入库:飞书 app secret、Cookie、API Key、`.env`、浏览器登录态和个人数据库都不应提交到仓库。
  213. - 微信读书数据:只处理用户授权后的个人书架、划线、想法和阅读数据,报告发布前应脱敏。
  214. - X 风险提示:`read-x-markdown` 使用非官方接口,必须先获得用户同意,并告知可能失效或触发平台限制。
  215. - 个人数据本地化:`read-personal-data-harvester` 默认只在用户设备上采集和保存,不上传到第三方。
  216. - 小宇宙转写:`read-xiaoyuzhou-article` 需要 `ffmpeg` 和 `GROQ_API_KEY`,音频下载与转录应仅用于你有权处理的内容。
  217. - 低频采样:RSS、网页、YouTube、X 等来源应低频、按需读取,避免给平台造成压力。
  218. - 分享前脱敏:报告和 Markdown 发布前移除 Cookie、token、邮箱、手机号、私密链接和未公开账号信息。
  219. ## 诚实边界
  220. 每个信息读取工具都应该说明自己做不到什么。
  221. - 不是实时全网监控:RSS、搜索、YouTube 和网页结果都受来源更新和接口限制影响。
  222. - 抓取不保证成功:登录、验证码、Cloudflare、JS 渲染、反爬和地区限制都可能失败。
  223. - OCR 会出错:低清图片、复杂表格、手写体和多语言混排需要人工复核。
  224. - 自动摘要和口播脚本不等于原文:`read-content-digest` / `read-podcast-script-generator` 会压缩、重组和改写观点,关键事实仍应回看原始文稿。
  225. - X 自动抓取成功率低:推荐用户手动复制内容再分析。
  226. - 个人数据采集需要授权:微信读书和其他个人平台只能处理用户自己的数据,不能替代平台导出或合规审查。
  227. 一个不告诉你边界在哪的阅读工具,不值得信任。
  228. ## 参考
  229. Read Buddy 汇集并整理了多个信息获取、内容读取、转写、翻译、摘要和个人数据采集 Skill。其中播客链路整合了 [SpaceZephyr/onepod-Skill](https://github.com/SpaceZephyr/onepod-Skill) 的 YouTube / 小宇宙处理能力,微信读书链路整合了 [SpaceZephyr/space-weread](https://github.com/SpaceZephyr/space-weread) 的导出、分析和回顾能力。
  230. 其中部分 Skill 依赖 Chrome CDP、Feishu Open API、YouTube transcript、OCR API、RSS feed、Playwright 或本地脚本,具体依赖以各目录的 `SKILL.md` 和 `scripts/` 为准。
  231. ## 许可证
  232. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.