baoyu-skills：按需安装、实用组合与 21 个 skill 目录

AI 参与说明（Agent：Cursor、Grok Bot）：正文由 Cursor Cloud 根据 JimLiu/baoyu-skills 的中英文 README，以及该提交下 21 个 SKILL.md 的 front matter description 整理。任务由 Grok Bot（Blog）编排。事实锁定提交 5792c7dc，GitHub committer 时间为 2026-11-02T19:25:27Z；核验日期为 Asia/Shanghai 2026-11-03。本文没有运行安装器，也没有调用这些 skill 生成图片或发布内容。模型 grok-4.7-high-fast，提供方 xAI，执行入口 Cursor Cloud。reasoning effort 未作为独立字段取得运行记录。

JimLiu/baoyu-skills

先说结论

baoyu-skills 是宝玉（GitHub 用户 JimLiu）公开分享的一组 Agent Skill，README 写明适用于 Claude Code、Codex 等。在提交 5792c7dc 上，skills/ 目录是平的，里面有 21 个 baoyu-* 子目录，每个目录一份 SKILL.md。中英文 README 再用三个标题把它们分成 Content Skills、AI Generation Skills 和 Utility Skills。这 21 个名字下面有一张可以一次扫完的目录。

At this commit the marketplace exposes a single plugin, baoyu-skills, and that plugin includes every skill in the repository. The files remain 21 separate directories. The README tells you to install only the skills you will actually use, because each loaded skill adds context on every agent run.

仓库里没有 baoyu-design。那是另一个项目，JimLiu/baoyu-design，文末单独说明。

术语对照

分组标题在 README 里中英文并列。后文使用 Content Skills、AI Generation Skills、Utility Skills，以及具体的 baoyu-* 目录名。

这份目录锁定在哪一次提交

本文只描述提交 5792c7dc8d09a28d6969e8970166c5eb090ce6ad。该提交的 GitHub committer 时间是 2026-11-02T19:25:27Z，说明是 fix(baoyu-cover-image): let --quick skip first-time setup when EXTEND.md is missing (#236)。2026-11-03（Asia/Shanghai）核对时，skills/*/SKILL.md 共 21 份，与中文 README 的 #### baoyu-* 标题一一对应。

README 的安装提示写的是「20+ 个 skill」。数目录时以 21 为准。Star 数会变，这里不记录。

同一提交里，有三处 README 正文和 SKILL.md 的 description 并不相同。目录表按 description 写成一行用途；命令和参数按 README 已经写出的示例。不一致的地方留在对应小节，不把其中一边改写成另一边。

前置要求也来自 README：已安装 Node.js，并且能够运行 npx bun。本文没有在本机执行 npx bun。

安装：只装会用到的

中英文 README 都把下面这句话放在安装说明前面：每个被加载的 skill 都会在 Agent 每次运行时占用额外上下文，所以只装真正会用到的那几个。

四种入口落到的范围不一样。Claude 插件市场里现在只有一个插件，README 写明它包含仓库中的全部 skills。要只装子集，用 Codex 的项目目录，或在 ClawHub 上一次安装一个 skill。

flowchart TD
    pick["先决定要用哪些 skill"] --> scope{"安装入口"}
    scope -->|终端快速安装| npxNode["npx skills add jimliu/baoyu-skills"]
    scope -->|Claude 插件市场| plugin["安装插件 baoyu-skills"]
    plugin --> allSkills["README：这一个插件包含全部 skills"]
    scope -->|Codex 项目| copyNode["复制或软链接单个 skill 目录"]
    scope -->|ClawHub| clawNode["clawhub install 某个 skill"]

终端快速安装

README 把这条命令标为推荐的快速安装。它是在终端运行的：

npx skills add jimliu/baoyu-skills

README 没有写这个安装器的菜单、开关或「只装某几个」的参数。本文没有运行它，不补充交互步骤。若目标就是少数几个 skill，用下面两节已经写明的复制目录或 clawhub install。

Claude 插件市场

在 Agent 里注册市场：

/plugin marketplace add JimLiu/baoyu-skills

然后任选 README 列出的一种装法：

1. 浏览界面：Browse and install plugins → baoyu-skills → baoyu-skills 插件 → Install now。
2. 直接安装：/plugin install baoyu-skills@baoyu-skills。
3. 用自然语言请 Agent 安装 github.com/JimLiu/baoyu-skills 中的 Skills。

更新时在 Agent 里运行 /plugin，打开 Marketplaces，选中 baoyu-skills，再选 Update marketplace。也可以 Enable auto-update，让每次启动去取最新版本。自动更新不会停在本文锁定的 5792c7dc。要和本文对照，安装或复制时对准这次提交。

Codex 项目级目录

只在一个项目里用一部分 skill 时，不必装整个插件。README 写 Codex 会扫描项目里的 .agents/skills，把需要的 skill 整目录复制或软链接进去，例如：

<project>/.agents/skills/baoyu-cover-image/SKILL.md
<project>/.agents/skills/baoyu-article-illustrator/SKILL.md
<project>/.agents/skills/baoyu-post-to-wechat/SKILL.md

复制或软链接的是整个 skill 目录。上面的树只标出 SKILL.md 应在的位置。

ClawHub：一次安装一个 skill

仓库可以把每个 skills/baoyu-* 目录当作独立 ClawHub skill 发布。维护者预览或发布用的是仓库脚本，普通使用不必跑它：

./scripts/sync-clawhub.sh --dry-run
./scripts/sync-clawhub.sh --all

读者按单个名字安装，例如：

clawhub install baoyu-image-gen
clawhub install baoyu-markdown-to-html

README 写：发布到 ClawHub 的 skill 按该 registry 的规则以 MIT-0 分发。仓库本身另有许可，见文末。

六条可以照着做的组合

下面的斜杠命令是 README 里的 Agent 内示例，不是另一套终端 CLI。路径请换成自己的稿件。带 --yes、--quick、--no-confirm 的写法会跳过确认，适合已经看过默认选择的重复任务。

公众号文章：三件套，外加一个可选整理

中文 README 给出的最小组合是：

• baoyu-cover-image
• baoyu-article-illustrator
• baoyu-post-to-wechat

baoyu-post-to-wechat 已经包含把 Markdown 转成公众号可用 HTML 的流程，最小组合里不要再装 baoyu-markdown-to-html。草稿还是纯文本、缺少标题、摘要、层级标题、加粗和列表时，再装 baoyu-format-markdown。它会另存为 {文件名}-formatted.md。

flowchart TD
    draft["草稿或已有 Markdown"] --> structured{"已有标题、摘要和层级？"}
    structured -->|没有| formatMd["baoyu-format-markdown"]
    structured -->|已有| cover["baoyu-cover-image"]
    formatMd --> cover
    cover --> illus["baoyu-article-illustrator"]
    illus --> post["baoyu-post-to-wechat"]

封面可以让 skill 自己选五个维度，也可以用 --quick 跳过确认。五个维度是类型、配色、渲染、文字、氛围。README 写 11 种配色和 7 种渲染可以组成 77 种效果；默认宽高比 16:9，--no-title 去掉标题文字。

/baoyu-cover-image path/to/article.md
/baoyu-cover-image path/to/article.md --quick
/baoyu-cover-image path/to/article.md --type conceptual --palette cool --rendering digital

文章插图按类型、风格和色板决定画什么、怎么画。README 的风格表把 notion 标为默认。

/baoyu-article-illustrator path/to/article.md
/baoyu-article-illustrator path/to/article.md --type flowchart --style notion

发布分贴图和文章两种模式。文章模式接受 Markdown 或 HTML；贴图模式是多图配短标题和正文。description 写贴图以前叫图文。

/baoyu-post-to-wechat 文章 --markdown article.md
/baoyu-post-to-wechat 文章 --markdown article.md --theme grace
/baoyu-post-to-wechat 贴图 --markdown article.md --images ./photos/

README 列出三种发布方式：

凭证不要写进 Git。全局放 ~/.baoyu-skills/.env，只给当前项目用放 <project>/.baoyu-skills/.env。变量名是 WECHAT_APP_ID 和 WECHAT_APP_SECRET。多个公众号写在 .baoyu-skills/baoyu-post-to-wechat/EXTEND.md：没有 accounts 时走单账号；只有 1 个账号时自动选中；2 个及以上会提示选择，或用 --account <别名>。

小红书图片卡片

baoyu-xhs-images 把内容拆成 1–10 张卡通风格图片卡片。README 的可复制参数是 --style、--layout、--palette、--yes 和 --preset。

/baoyu-xhs-images posts/ai-future/article.md
/baoyu-xhs-images posts/ai-future/article.md --style notion --layout dense
/baoyu-xhs-images posts/ai-future/article.md --yes --preset knowledge-card

README 列出的风格名：cute（默认）、fresh、warm、bold、minimal、retro、pop、notion、chalkboard、study-notes、screen-print、sketch-notes。可选配色：macaron、warm、neon。

SKILL.md 的 description 写的是 12 种风格、8 种布局、3 套配色。风格名和配色名的个数与 README 一致。布局名 README 只列出上面 6 个，表格里没有另外两种的名字。调用时用表里的名字。

信息图

baoyu-infographic 的 README 写明 21 种布局和 22 种视觉风格。默认布局 bento-grid，默认风格 craft-handmade。完整名单在中文 README 该小节，这里不整表复制。

/baoyu-infographic path/to/content.md
/baoyu-infographic path/to/content.md --layout hub-spoke --style technical-schematic
/baoyu-infographic path/to/content.md --aspect 3:4 --lang zh --no-confirm

--aspect 的预设是 landscape（16:9）、portrait（9:16）、square（1:1），也可以写自定义 W:H。--ref 用来提供风格、配色、构图或主体的参考图。

幻灯片

baoyu-slide-deck 先做带样式说明的大纲，再逐页生成图片。README 建议页数 8–25，最多 30。

/baoyu-slide-deck path/to/article.md --style corporate --audience executives --slides 15
/baoyu-slide-deck path/to/article.md --outline-only
/baoyu-slide-deck path/to/article.md --lang zh

风格由纹理、氛围、字体、密度四个维度组成。默认预设是 blueprint。--prompts-only 停在提示词，--images-only 从已有提示词出图，--regenerate 3 或 --regenerate 2,5,8 重做指定页。中文 README 写：生成完成后，幻灯片会合并为 .pptx 和 .pdf。description 只写到逐页图片，没有写这两个合并文件。

翻译

README 的示例命令是 /translate，不是 /baoyu-translate。三种模式：quick 直接翻译，normal（默认）先分析再翻译，refined 再加审校和润色。默认目标语言 zh-CN。标准模式做完后，README 写可以回复「继续润色」或 refine 进入后续步骤。

/translate article.md --to zh-CN
/translate article.md --mode quick --to ja
/translate article.md --mode refined --to zh-CN --audience technical --glossary my-terms.md
/translate https://example.com/article --to zh-CN

长文档按 README 的说法，超过 4000 词会自动分块并行翻译。术语表还可以放在该 skill 的 EXTEND.md。受众和风格的预设名都在中文 README 的两张表里，例如 technical、academic、formal、literal。

YouTube 字幕，再到 Markdown 文章

baoyu-youtube-transcript 按 URL 或视频 ID 下载字幕、转录和封面。README 的默认输出是带时间戳的 Markdown，默认语言代码是 en。需要中文优先时显式写 --languages。

/baoyu-youtube-transcript https://www.youtube.com/watch?v=VIDEO_ID --languages zh,en
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --chapters --speakers
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --format srt
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --list

--translate 译成指定语言，--refresh 忽略缓存重新抓取。说话人识别在 README 的选项表里注明需要 AI 后处理。

上游没有把「字幕」和「整理成文章」写成一条自动流水线。字幕稿还要标题、摘要和层级时，再交给 baoyu-format-markdown。第二步只是两个 skill 可以先后使用。

flowchart TD
    video["YouTube URL 或视频 ID"] --> transcript["baoyu-youtube-transcript"]
    transcript --> markdown["带时间戳的 Markdown"]
    markdown --> article{"要整理成文章结构？"}
    article -->|要| formatMd["baoyu-format-markdown"]
    article -->|不要| keep["保留字幕稿"]

普通网页用 baoyu-url-to-markdown。README 示例：

/baoyu-url-to-markdown https://example.com/article
/baoyu-url-to-markdown https://example.com/private --wait
/baoyu-url-to-markdown https://example.com/article -o output.md

自动模式在页面加载后抓取。--wait 等用户信号，README 用来处理要登录的页面。默认超时 30000 毫秒。

description 写抓取入口是 baoyu-fetch，用 Chrome CDP，并为 X / Twitter、YouTube 字幕、Hacker News 和经 Defuddle 的普通页面准备了适配器。README 正文写 Chrome CDP，Defuddle 失败时回退旧版提取器。两边都是把 URL 收成 Markdown。适配器和回退怎样分工，以安装下来的 SKILL.md 正文为准。

21 个 skill 目录

目录按 README 的分组和出现顺序排列。一行用途只保留 description 里的功能，不保留触发词。分组是 README 的标题，不是 skills/ 下面的子文件夹。

Content Skills

baoyu-diagram 的 README 写：不调用图像生成模型，由 Claude 直接写 SVG，并用 @media (prefers-color-scheme: dark) 让同一个文件适应深色模式。类型名是 flowchart、sequence、structural、illustrative、class，默认 auto。description 写的产物是深色 SVG、浅色 SVG，以及各自的 @2x PNG。两份说明不一样，这里并列保留。

/baoyu-diagram "JWT 认证流程是怎么工作的"
/baoyu-diagram path/to/article.md --type structural --lang zh

baoyu-comic 的 README 画风包括 ligne-claire（默认）、manga、realistic、ink-brush、chalk，基调包括 neutral（默认）以及 warm、dramatic 等。预设 ohmsha、wuxia、shoujo 在画风和基调之外还有特殊规则。默认比例 3:4。

baoyu-post-to-x 和 baoyu-post-to-weibo 的 README 都写：脚本把内容填进真实 Chrome，由人检查后再发布。纯文本默认是普通帖，Markdown 文件在发往 X 时默认按 X 文章处理。baoyu-post-to-x 的 description 还区分 Codex 里的 Chrome 插件、Computer Use，以及只在允许时才回退到 CDP 脚本。本文不展开这三条路径的操作步骤。

/baoyu-post-to-x "Hello from AI Agent!"
/baoyu-post-to-x --article path/to/article.md
/baoyu-post-to-weibo "Hello Weibo!" --image photo.png
/baoyu-post-to-weibo --article article.md --cover cover.jpg

微博头条的标题覆盖最多 32 字，摘要覆盖最多 44 字，这是 README 选项表里的上限。

AI Generation Skills

baoyu-image-gen 的 README 把 --provider 写成 google、openai、azure、openrouter、dashscope、zai、minimax、jimeng、seedream、replicate 或 agnes。自动选择按 README 的顺序：

1. 命令里写了 --provider，就用指定值。
2. 带了 --ref 且没写 provider：依次尝试 Google、OpenAI、Azure、OpenRouter、Replicate、Seedream、MiniMax，最后是 Agnes。
3. 只有一个 API 密钥：用对应服务商。
4. 多个密钥都可用：默认 Google，然后是 OpenAI、Azure、OpenRouter、DashScope、Z.AI、MiniMax、Replicate、即梦、豆包、Agnes。

同一提交里，README 示例和 OPENAI_IMAGE_MODEL 的默认值写 gpt-image-2，description 写 OpenAI GPT Image 2.5。调用时以 --model 或 OPENAI_IMAGE_MODEL 为准。

/baoyu-image-gen --prompt "一只可爱的猫" --image cat.png --ar 16:9
/baoyu-image-gen --prompt "一只猫" --image cat.png --provider openai --model gpt-image-2

密钥放在文末所说的 .env 加载顺序里。README 对若干服务商还有单独限制，例如即梦不支持参考图，Replicate 当前 --n 只接受 1，Z.AI 的 glm-image 暂不支持参考图。这些限制以锁定提交的 README「Provider 说明」为准。

baoyu-danger-gemini-web 的 README 示例：

/baoyu-danger-gemini-web "你好，Gemini"
/baoyu-danger-gemini-web --prompt "一只可爱的猫" --image cat.png

Utility Skills

baoyu-compress-image 的 README 示例是 /baoyu-compress-image path/to/image.png 和 --quality 80。默认 WebP 来自 description，README 正文没有写默认格式。

baoyu-markdown-to-html 在最小公众号组合之外仍然可以单独使用。README 示例支持 --theme、--color 和 --cite。description 还写了代码高亮、数学、经无头 Chrome 把 Mermaid 渲成 PNG、PlantUML、脚注、提示块和信息图。

baoyu-wechat-summary 的 README 把 wx-cli 写成前置依赖：npm install -g @jackwener/wx-cli，并且在 macOS 上运行已登录的 WeChat 4.x。description 写默认输出正常版，毒舌版要显式要求。它还会在多次运行之间保留群历史、群友画像和群级事实记忆，并带有隐私防护。群聊原文不要放进公开文章。

2026-11-03 再打开这个 GitHub 链接时，仓库 API 返回 Repository access blocked，block.reason 为 dmca，记录时间 2026-07-15T15:39:40Z。公开说明在 GitHub DMCA notice 2026-07-13-wechat。同一天用 npm view 仍能看到 @jackwener/wx-cli@0.3.0，包的 modified 时间是 2026-05-15T18:29:14Z。本文没有安装这个包，也不提供其他下载地址。锁定提交里的 README 仍然写着原来的仓库链接。

/baoyu-wechat-summary 群名称 最近 1 天
/baoyu-wechat-summary 群名称

第二条是 README 所说的增量模式：从上次摘要继续。群名称换成你自己的群。

baoyu-electron-extract 读取本机已经安装的 Electron 应用。README 写它跳过 node_modules，支持 macOS 和 Windows；其他平台用 --asar <path> 指定文件。--dry-run 只打印将要使用的路径。只在你有权检查该应用时使用。本文不逐步演示提取，也不讨论提取结果能否再分发。

baoyu-danger-x-to-markdown 的 README 接受 x.com、twitter.com 的 status URL，以及 https://x.com/i/article/<id>。--download-media 会把图片或视频下到本地。认证使用环境变量或 Chrome 登录。变量名见下一节，不要把 cookie 写进仓库。

名称以 danger- 开头的两个 skill

这两个 skill 的免责声明在中文 README 的免责声明一节。目录把它们留在原分组里，是为了和上游 21 个名字对齐，不是建议默认安装。

baoyu-danger-gemini-web uses the Gemini Web API through reverse engineering. The README says this is an unofficial API reached with browser cookies, that the first run opens a browser for Google sign-in, that cookies are cached afterwards, and that stability is not guaranteed. Supported browsers listed there are Google Chrome, Chrome Canary/Beta, Chromium, and Microsoft Edge.

需要代理时，README 让你在命令前设置 HTTP_PROXY 和 HTTPS_PROXY。Windows PowerShell 不接受同一行内联写法，要先在当前会话里设置变量，再从这个会话启动 Agent；已经在跑的 Agent 读不到后来才设置的值。

baoyu-danger-x-to-markdown uses a reverse-engineered X API, not an official API. The README says it can stop working without notice if X changes the API, that the account may be limited if API use is detected, and that the first use must confirm the disclaimer. Authentication is either the environment variables X_AUTH_TOKEN and X_CT0, or a Chrome login.

baoyu-design 不在这 21 个里面

baoyu-design 在 README 里单独推荐，目录名不在 skills/ 的 21 个 SKILL.md 之中。README 把它描述成一个可移植的 Agent Skill：在 Cursor、Claude Code、Codex、Claude Desktop 或其他能读写文件的编码 Agent 里生成 UI 稿、可交互原型、线框图、落地页、仪表盘、移动 App 和幻灯片，产物是留在你自己仓库里的自包含 HTML。安装命令是：

npx skills add JimLiu/baoyu-design

本文没有核对 baoyu-design 的提交或文件清单。

密钥、EXTEND.md 与许可

需要 API 密钥的 skill 从 .env 读取。README 按下面的顺序加载，排在前面的来源覆盖后面的：

1. 命令行里带上的环境变量
2. process.env
3. <cwd>/.baoyu-skills/.env
4. ~/.baoyu-skills/.env

项目级文件应加入 .gitignore。README 的示例用占位符写出各服务商变量名；真实密钥不属于文章内容，这里不复制那份模板。

每个 skill 都可以用 EXTEND.md 覆盖默认样式、账号或个人预设。查找顺序是项目 .baoyu-skills/<skill-name>/EXTEND.md，然后才是 ~/.baoyu-skills/<skill-name>/EXTEND.md。扩展内容在 skill 执行前加载。

除另有说明外，仓库采用 MIT License。发布到 ClawHub 的副本按 README 以 MIT-0 分发。第三方代码和素材仍按它们自己标明的许可。

中文 README 还介绍了作者的书《图解 Skill —— AI 提效实战指南》，以及配套仓库 JimLiu/Illustrated-Agent-Skills。购书链接见参考资料。本文不评介这本书。

关联阅读

• Matt Pocock Skills：从需求澄清到工程交付的 Agent 工作流：另一套按工程阶段组合的第三方 skills。装上之后仍要决定哪些 skill 进入当前仓库。
• 本地 Agent Skills 安装清单：区分本机已经安装、能够被看到和实际加载的 skill。
• Skills Overview：本栏其他 Skill 文档的入口。

参考资料

• 仓库：https://github.com/JimLiu/baoyu-skills
• 锁定提交：https://github.com/JimLiu/baoyu-skills/tree/5792c7dc8d09a28d6969e8970166c5eb090ce6ad
• 中文 README：https://github.com/JimLiu/baoyu-skills/blob/5792c7dc8d09a28d6969e8970166c5eb090ce6ad/README.zh.md
• 英文 README：https://github.com/JimLiu/baoyu-skills/blob/5792c7dc8d09a28d6969e8970166c5eb090ce6ad/README.md
• 免责声明：https://github.com/JimLiu/baoyu-skills/blob/5792c7dc8d09a28d6969e8970166c5eb090ce6ad/README.zh.md#%E5%85%8D%E8%B4%A3%E5%A3%B0%E6%98%8E
• baoyu-design：https://github.com/JimLiu/baoyu-design
• wx-cli：README 中的仓库链接 https://github.com/jackwener/wx-cli（2026-11-03 访问被 GitHub 以 DMCA 屏蔽）；npm 包 @jackwener/wx-cli
• 图书配套仓库：https://github.com/JimLiu/Illustrated-Agent-Skills
• 中文 README 给出的购书页：https://u.jd.com/RDY9YwC，电子书 https://www.ituring.com.cn/book/3616