info-skill

<h1 align="center">Read Buddy</h1>

<p align="center"><code>read-buddy.skill</code></p>

<p align="center"><em>「你想读懂的下一份信息，何必先被格式困住」</em></p>

<p align="center">
  <img alt="License MIT" src="https://img.shields.io/badge/License-MIT-c8a500?style=for-the-badge">
  <img alt="Agent Skills Standard" src="https://img.shields.io/badge/Agent%20Skills-Standard-5aa524?style=for-the-badge">
  <img alt="skills.sh Compatible" src="https://img.shields.io/badge/skills.sh-Compatible-1888c8?style=for-the-badge">
  <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">
</p>

<p align="center">
  公众号 / 小红书 / B站 / 知乎：<strong>空格的键盘</strong> ｜ <a href="mailto:wzfh520@gmail.com">wzfh520@gmail.com</a>
</p>

Read Buddy 是一套给内容创作者、研究者、产品人和知识工作者用的信息读取 Skill 集合。

它帮你把网页、RSS、YouTube、播客、X/Twitter、飞书文档、图片 OCR、个人阅读记录和热点信号，转成可读、可检索、可总结、可继续写作的结构化内容。

基于开放的 Agent Skills 协议，可在 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等兼容 runtime 中运行。

不是让 AI 凭空总结一段它没读过的材料。

是先把来源内容拿回来，再让 Agent 帮你完成：

- 读网页、转 Markdown、保留元数据
- 读 YouTube 字幕、播客更新和长内容
- 读 RSS 和 AI 热点，形成每日信息面
- 读飞书文档、图片/PDF OCR、个人历史数据
- 读 X/Twitter 内容和博主风格，但明确反爬与同意边界
- 把长内容消化成摘要、选题、长文或短帖

看效果 · 安装 · 它能读什么 · 使用方式 · 工作原理 · 诚实边界

## 效果示例

```text
用户      ❯ 把这篇网页转成 Markdown

助手      ❯ 已读取 URL，完成正文提取。

            输出包含：
            - 标题、作者、发布时间
            - 正文 Markdown
            - 原文链接
            - 图片引用

            已过滤导航、广告、页脚等噪声。
```

再看 YouTube：

```text
用户      ❯ 帮我提取这个 YouTube 视频字幕并总结

助手      ❯ 已提取字幕，优先语言：中文 / 英文。

            主要观点：
            1. AI Agent 的价值不在替代按钮，而在连接上下文
            2. 工作流稳定性比单次模型能力更重要
            3. 好的工具应该留下可复用的中间产物

            可继续生成：短帖、长文、金句、选题卡。
```

再看热点采集：

```text
用户      ❯ 看看最近 3 天 AI 圈有什么新东西

助手      ❯ 已聚合 RSS / Product Hunt / Hacker News / 官方博客 / X 公开信息。

            今日值得关注：
            - 新模型发布：适合写快讯
            - AI 编程产品更新：适合做教程
            - Agent 工作流案例：适合拆方法论
            - 开源项目上榜：适合做选题池
```

Read Buddy 的目标不是囤信息。  
它负责把信息变成下一步可以用的材料。

## 安装

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

### 方式一：一行命令（推荐，跨 runtime）

打开你正在用的 agent（Claude Code、Codex、Cursor、OpenClaw、Hermes、CodeBuddy、Workbuddy、Gemini CLI、OpenCode 等），告诉它：

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

或者用通用 CLI 安装器（vercel-labs/skills，支持多 runtime）：

```bash
npx skills add SpaceZephyr/read-buddy
```

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

### 方式二：手动安装

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

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

仓库结构：

```text
read-content-digest/
read-feishu-doc/
read-ocr/
read-personal-data-harvester/
read-podcast-workflow/
read-rss-aggregator/
read-topic-collector/
read-url-markdown/
read-web-article-translator/
read-web-scraper/
read-x-blogger-analyzer/
read-x-markdown/
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 + 可运行脚本或工作流说明。

## 使用

装好后，可以直接告诉 agent：

```text
把这个网页保存成 Markdown
```

```text
提取这个 YouTube 视频的中文字幕
```

```text
最近 3 天 RSS 有什么更新
```

```text
分析这个 X 博主的内容风格
```

```text
把这篇英文网页翻译成中文 Markdown
```

```text
读取这个飞书文档
```

```text
把这张图里的文字 OCR 出来
```

```text
开始今日 AI 热点采集
```

## 它能读什么

| Skill | 解决的问题 | 输出 |
| --- | --- | --- |
| `read-url-markdown` | 用 Chrome CDP 读取网页，支持登录态页面等待后转 Markdown | Markdown |
| `read-web-scraper` | 轻量网页抓取，把 HTML 正文转 Markdown | Markdown / raw HTML |
| `read-web-article-translator` | 在线文章翻译为中文并保存 Markdown | 中文 Markdown |
| `read-x-markdown` | X/Twitter 推文、线程、文章转 Markdown，使用前需明确同意风险 | Markdown + YAML |
| `read-x-blogger-analyzer` | 分析 X/Twitter 博主内容风格、爆款原因和增长策略 | 分析报告 |
| `read-youtube-feed` | 获取关注 YouTube 博主/播客的近期更新 | 更新列表 |
| `read-youtube-transcript` | 提取 YouTube 字幕并转成中文文字稿 | Markdown / text / JSON |
| `read-podcast-workflow` | YouTube 播客更新选择、字幕提取、内容消化、飞书保存 | 工作流产物 |
| `read-rss-aggregator` | 聚合 OPML 中的 RSS 源近期更新 | 更新摘要列表 |
| `read-topic-collector` | 采集 AI 热点、产品发布、论文、博客和社区动态 | 结构化热点清单 |
| `read-content-digest` | 长文、播客、访谈、文章转短帖和长文叙事 | 摘要 / 短帖 / 长文 |
| `read-feishu-doc` | 通过飞书开放 API 读取飞书文档和 blocks | 文档内容 / blocks JSON |
| `read-ocr` | 图片、PDF、扫描件 OCR 识别 | 结构化 JSON / 文本 |
| `read-personal-data-harvester` | 采集用户自己的阅读、观看、收藏历史到本地数据库 | SQLite / 结构化数据 |

## 使用方式

你可以用自然语言直接触发，也可以点名调用单个 Skill。

| 方式 | 示例 | 会触发什么 |
| --- | --- | --- |
| URL 读取 | `把这个网页转 Markdown`、`保存这篇文章` | 读取网页正文、清理噪声、输出 Markdown |
| 视频/播客 | `提取这个 YouTube 字幕`、`处理这个

... (truncated)