你有没有这样的体验：用 AI Agent 写文章很顺手，但一到做封面图、生成信息图、翻译发布、提取视频字幕这些”周边工作”，就得在各种工具之间来回切换？内容创作的工作流被切得七零八落。

Baoyu Skills 就是来解决这个问题的。它是宝玉（JimLiu）分享的一套 AI Agent 技能集，包含 20+ 个实用技能，覆盖内容生成、AI 图像、日常工具三大类。安装到 Claude Code 或 Codex 之后，你只需要用自然语言告诉 Agent 做什么，它就知道该调用哪个技能。

Baoyu Skills 是什么？ 由宝玉（JimLiu）开发的开源 AI Agent 技能集（MIT 许可证），包含 20+ 个可移植技能文件，覆盖小红书图片卡片、信息图、SVG 图表、封面图、幻灯片、视频字幕、翻译、Markdown 处理、公众号发布等场景。通过 npx skills add 一键安装到 Claude Code、Codex 等主流 AI 编码工具。

关键数据：

• 🌟 GitHub Stars: 快速增长中（仓库链接）
• 📦 技能数量：20+ 个，按内容/生成/工具三大类组织
• ⚖️ 许可证：MIT License
• 🧠 核心特性：内容创作全链路覆盖——从写作到配图到发布
• 📦 核心特性：支持 10+ 图像生成 Provider（Google、OpenAI、Azure、DashScope、即梦、豆包等）
• 📖 配套图书：《图解 Skill —— AI 提效实战指南》

前提条件

开始本 Baoyu Skills 安装教程前，你需要准备：

• Node.js 环境：已安装，能运行 npx 命令
• 一个 AI 编码工具：Claude Code、Codex、Cursor 等任意一个
• API Key（可选）：图像生成类技能需要对应的 API Key，内容工具类技能大多不需要

概述

本教程是 Baoyu Skills 的完整使用指南，将详细介绍：

1. 一键安装方法
2. 三大类 20+ 个技能的功能和用法
3. 在 Claude Code 和 Codex 中的接入方式
4. 环境配置和自定义扩展

💡 提示：Baoyu Skills 已收录 20+ 个 skill，请按需安装你真正会用到的那几个——每个加载的 skill 都会在 Agent 运行时占用额外上下文。

详细步骤

第一步：一键安装

1

npx skills add jimliu/baoyu-skills

安装完成后，所有技能即可在你的 AI Agent 中使用。

第二步：在 AI 工具中安装

Baoyu Skills 支持多种安装方式，适配不同的 AI 编码工具：

Claude Code：

1

npx skills add jimliu/baoyu-skills

Claude Code 会自动加载 SKILL.md，后续在对话中直接使用技能命令即可。

**Codex (OpenAI)**：
Codex 会扫描项目里的 .agents/skills 目录。可以把需要的 skill 目录复制或软链接到当前项目：

1
2
3

<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

OpenClaw：
通过 ClawHub 安装单个技能：

1
2

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

其他工具：
也可以告诉 Agent 直接安装：”请帮我安装 github.com/JimLiu/baoyu-skills 中的 Skills”。

第三步：选择你需要的技能

Baoyu Skills 分为三大类。下面逐一介绍每个技能的功能和用法。

内容技能（Content Skills）

内容生成和发布类技能，是 Baoyu Skills 的核心。

baoyu-xhs-images：小红书图片卡片生成器

将内容拆解为 1-10 张卡通风格图片卡片，支持 风格 × 布局 系统和可选配色覆盖。做小红书内容的利器。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 自动选择风格和布局
/baoyu-xhs-images posts/ai-future/article.md

# 指定风格
/baoyu-xhs-images posts/ai-future/article.md --style notion

# 指定布局
/baoyu-xhs-images posts/ai-future/article.md --layout dense

# 组合风格和布局
/baoyu-xhs-images posts/ai-future/article.md --style notion --layout list

# 覆盖配色
/baoyu-xhs-images posts/ai-future/article.md --style notion --palette macaron

12 种视觉风格：cute（默认）、fresh、warm、bold、minimal、retro、pop、notion、chalkboard、study-notes、screen-print、sketch-notes

6 种信息布局：

baoyu-infographic：专业信息图生成器

支持 20 种信息布局 × 17 种视觉风格 的信息图生成器。分析内容后推荐布局×风格组合，生成可直接发布的信息图。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 根据内容自动推荐组合
/baoyu-infographic path/to/content.md

# 指定布局
/baoyu-infographic path/to/content.md --layout pyramid

# 指定风格
/baoyu-infographic path/to/content.md --style technical-schematic

# 同时指定布局和风格
/baoyu-infographic path/to/content.md --layout funnel --style corporate-memphis

# 指定比例
/baoyu-infographic path/to/content.md --aspect portrait

20 种信息布局（完整列表）：

17 种视觉风格：craft-handmade（默认）、claymation、kawaii、storybook-watercolor、chalkboard、cyberpunk-neon、bold-graphic、aged-academia、corporate-memphis、technical-schematic、origami、pixel-art、ui-wireframe、subway-map、ikea-manual、knolling、lego-brick

baoyu-diagram：SVG 图表生成器

从源素材生成可直接发布的 SVG 图表——流程图、时序图、架构图、示意图、类图。Claude 直接输出符合设计规范的 SVG 代码，自动支持深色模式。

1
2
3
4
5
6
7
8
9
10
11

# 主题描述
/baoyu-diagram "JWT 认证流程是怎么工作的"
/baoyu-diagram "Kubernetes 架构" --type structural
/baoyu-diagram "OAuth 2.0 流程" --type sequence

# 文件路径
/baoyu-diagram path/to/article.md

# 语言和输出路径
/baoyu-diagram "微服务架构" --lang zh
/baoyu-diagram "build pipeline" --out docs/build-pipeline.svg

五种图表类型：

这个技能不调用任何图像生成模型——Claude 通过手算坐标直接写 SVG 代码，产物是自包含的 .svg 文件，内嵌样式并自动支持深色模式。

baoyu-cover-image：封面图生成器

为文章生成封面图，支持五维定制系统：类型 × 配色 × 渲染 × 文字 × 氛围。11 种配色方案与 7 种渲染风格组合，提供 77 种独特效果。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 根据内容自动选择所有维度
/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

# 风格预设
/baoyu-cover-image path/to/article.md --style blueprint

# 纯视觉（不含标题文字）
/baoyu-cover-image path/to/article.md --no-title

五个维度：

• **类型 (Type)**：hero、conceptual、typography、metaphor、scene、minimal
• **配色 (Palette)**：warm、elegant、cool、dark、earth、vivid、pastel、mono、retro、duotone、macaron
• **渲染 (Rendering)**：flat-vector、hand-drawn、painterly、digital、pixel、chalk、screen-print
• **文字 (Text)**：none、title-only（默认）、title-subtitle、text-rich
• **氛围 (Mood)**：subtle、balanced（默认）、bold

baoyu-slide-deck：幻灯片生成器

从内容生成专业幻灯片图片。先创建包含样式说明的完整大纲，然后逐页生成幻灯片图片。

1
2
3
4
5

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

风格系统由 4 个维度组合：纹理 × 氛围 × 字体 × 密度。预设包括 blueprint（默认）、chalkboard、corporate、minimal、sketch-notes、watercolor 等。

baoyu-image-gen：通用图像生成

支持 10+ 个图像生成 Provider 的统一接口，包括 Google Gemini、OpenAI、Azure OpenAI、DashScope（通义万相）、Z.AI、MiniMax、Replicate、即梦、豆包 Seedream、Agnes 等。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 基础用法
/baoyu-image-gen "一只在写代码的猫"

# 指定 provider 和模型
/baoyu-image-gen "赛博朋克城市" --provider openai --model gpt-image-2

# 使用参考图
/baoyu-image-gen "类似风格的新图" --ref reference.png

# 指定尺寸和比例
/baoyu-image-gen "海报设计" --size 1024x1792 --ar 9:16

# 批量生成
/baoyu-image-gen "不同风格的 logo" --n 4

支持自动选择 Provider：如果指定了 --ref 参考图，会依次尝试 Google、OpenAI、Azure 等；如果只有一个 API Key，自动使用对应的 Provider。

工具技能（Utility Skills）

日常效率工具。

baoyu-youtube-transcript：YouTube 字幕下载

下载 YouTube 视频字幕/转录文本和封面图片。支持多语言、翻译、章节分段和说话人识别。

1
2
3
4
5
6
7
8
9
10
11

# 默认：带时间戳的 Markdown
/baoyu-youtube-transcript https://www.youtube.com/watch?v=VIDEO_ID

# 指定语言
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --languages zh,en,ja

# 章节分段 + 说话人识别
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --chapters --speakers

# SRT 字幕格式
/baoyu-youtube-transcript https://youtu.be/VIDEO_ID --format srt

baoyu-url-to-markdown：URL 转 Markdown

通过 Chrome CDP 抓取任意 URL 并转换为 Markdown。同时保存渲染后的 HTML 快照。

1
2
3

/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

baoyu-danger-x-to-markdown：Twitter 转 Markdown

将 X (Twitter) 内容转换为 Markdown 格式。支持推文串和 X 文章。

1
2

/baoyu-danger-x-to-markdown https://x.com/username/status/123456
/baoyu-danger-x-to-markdown https://x.com/username/status/123456 --download-media

baoyu-translate：三模式翻译

支持快速、标准、精翻三种模式的翻译技能。标准模式先分析再翻译，精翻模式含审校与润色，达到出版级质量。

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 标准模式（默认）
/translate article.md --to zh-CN

# 快速模式
/translate article.md --mode quick --to ja

# 精翻模式——完整工作流
/translate article.md --mode refined --to zh-CN

# 翻译 URL
/translate https://example.com/article --to zh-CN

# 指定受众和风格
/translate article.md --to zh-CN --audience technical --style formal

受众预设：general（普通读者）、technical（开发者）、academic（研究者）、business（商务人士）

风格预设：storytelling（叙事，默认）、formal、technical、literal、academic、business、humorous、conversational、elegant

特性：长文档（4000+ 词）自动分块并行翻译；比喻和修辞按意译而非逐字翻译；为文化/专业术语添加译注。

baoyu-format-markdown：Markdown 格式化

格式化纯文本或 Markdown 文件，添加 frontmatter、标题、摘要、层级标题、加粗、列表和代码块。自动运行排版脚本处理半角引号转全角、中英文空格等。

baoyu-markdown-to-html：Markdown 转 HTML

将 Markdown 转换为样式化 HTML，支持微信公众号兼容主题、代码高亮，以及可选的外链底部引用。

1
2

/baoyu-markdown-to-html article.md --theme grace --color red
/baoyu-markdown-to-html article.md --cite  # 外链转文末引用

baoyu-compress-image：图片压缩

压缩图片以减小文件大小，同时保持质量。

1
2

/baoyu-compress-image path/to/image.png
/baoyu-compress-image path/to/images/ --quality 80

baoyu-wechat-summary：微信群聊精华提取

从群消息中提取话题、引言和统计数据，生成结构化简报。支持增量模式、群友画像、群级事实记忆，可生成正常版和毒舌版。

1
2
3

/baoyu-wechat-summary 相亲相爱一家人 最近 1 天
/baoyu-wechat-summary AI 技术群 最近 7 天
/baoyu-wechat-summary 相亲相爱一家人 最近 3 天 毒舌版

前置要求：安装 wx-cli，macOS 上运行并登录 WeChat 4.x。

baoyu-electron-extract：Electron 应用源码提取

从任意已安装的 Electron 应用的 app.asar 中提取资源和 JavaScript。当 .js.map 内嵌 sourcesContent 时，还原原始源码树（含 TypeScript/JSX）。

1
2
3
4

/baoyu-electron-extract Codex
/baoyu-electron-extract "/Applications/Visual Studio Code.app"
/baoyu-electron-extract Codex --output ~/work/codex-source
/baoyu-electron-extract Codex --dry-run  # 仅预览

baoyu-danger-gemini-web：Gemini Web 交互

与 Gemini Web 交互，生成文本和图片。使用逆向工程的 Gemini Web API，首次运行会打开浏览器进行 Google 身份验证。

1
2

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

⚠️ 此技能使用非官方 API，使用风险自负。

另外推荐：baoyu-design

如果你需要让 Agent 直接做 UI 设计，可以安装独立项目 JimLiu/baoyu-design：

1

npx skills add JimLiu/baoyu-design

它把 Claude Design 打包成可移植的 Agent Skill，用来生成精致 UI 稿、可交互原型、线框图、落地页、仪表盘、移动 App 和幻灯片，产物都是自包含 HTML。

环境配置

图像生成类技能需要 API Key。按优先级加载：命令行环境变量 → 系统环境变量 → 项目级 .baoyu-skills/.env → 用户级 ~/.baoyu-skills/.env。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

mkdir -p ~/.baoyu-skills
cat > ~/.baoyu-skills/.env << 'EOF'
# Google Gemini
GOOGLE_API_KEY=xxx
GOOGLE_IMAGE_MODEL=gemini-3-pro-image

# OpenAI
OPENAI_API_KEY=sk-xxx

# DashScope（阿里通义万相）
DASHSCOPE_API_KEY=sk-xxx

# 豆包 Seedream
ARK_API_KEY=xxx
SEEDREAM_IMAGE_MODEL=doubao-seedream-5-0-260128
EOF

自定义扩展

所有技能支持通过 EXTEND.md 文件自定义。扩展路径（按优先级）：

1. .baoyu-skills/<skill-name>/EXTEND.md — 项目级
2. ~/.baoyu-skills/<skill-name>/EXTEND.md — 用户级

例如，为 baoyu-cover-image 自定义品牌配色：

1

mkdir -p .baoyu-skills/baoyu-cover-image

创建 .baoyu-skills/baoyu-cover-image/EXTEND.md：

1
2
3
4
5
6
7
8

## 自定义配色

### corporate-tech
- 主色：#1a73e8、#4A90D9
- 背景色：#F5F7FA
- 强调色：#00B4D8、#48CAE4
- 装饰提示：简洁线条、渐变效果
- 适用于：SaaS、企业、技术内容

常见问题（FAQ）

Q: Baoyu Skills 怎么安装？Claude Code 中如何使用？
A: 运行 npx skills add jimliu/baoyu-skills 即可一键安装。Claude Code 会自动加载 SKILL.md，后续在对话中直接使用 /baoyu-xhs-images、/baoyu-cover-image 等命令即可。详细步骤见上方安装教程。

Q: 需要全部安装吗？
A: 不建议。每个加载的 skill 会占用额外上下文。按需安装你真正会用到的几个即可。公众号文章发布的最小组合是 baoyu-cover-image + baoyu-article-illustrator + baoyu-post-to-wechat。

Q: 图像生成需要什么 API Key？
A: 取决于你使用的 Provider。支持 Google、OpenAI、Azure、DashScope、Z.AI、MiniMax、Replicate、即梦、豆包等 10+ 个。如果只有一个 Key，系统会自动使用对应的 Provider。

Q: baoyu-diagram 和 baoyu-infographic 有什么区别？
A: baoyu-diagram 生成 SVG 代码图表（流程图、时序图、架构图等），不调用图像模型，产物是矢量文件。baoyu-infographic 生成像素级信息图（20 种布局 × 17 种风格），产物是图片文件。

Q: 翻译技能支持哪些语言？
A: 支持所有主流语言。通过 --to 参数指定目标语言代码（如 zh-CN、ja、ko 等）。长文档自动分块并行翻译。

Q: 如何更新技能？
A: 在 Agent 中运行 /plugin，切换到 Marketplaces 标签页，选择 baoyu-skills，选择 Update marketplace。也可以启用自动更新。

Q: 发布到公众号需要哪些技能？
A: 最小组合：baoyu-cover-image（封面图）+ baoyu-post-to-wechat（发布）。baoyu-post-to-wechat 已内置 Markdown 到公众号 HTML 的转换，不需要单独安装 baoyu-markdown-to-html。

进阶技巧

• 公众号全流程：baoyu-format-markdown（整理格式）→ baoyu-cover-image（封面）→ baoyu-post-to-wechat（发布）
• 小红书内容流水线：写好文章 → baoyu-xhs-images 生成卡片系列 → 直接发布
• 信息图 + 图表组合：baoyu-infographic 做概览信息图 + baoyu-diagram 做详细流程图
• 翻译+发布：baoyu-translate 翻译文章 → baoyu-markdown-to-html 转 HTML → 发布
• EXTEND.md 定制：为每个技能创建自定义扩展，统一团队的品牌配色和风格

总结

以上就是 Baoyu Skills 的完整使用教程和安装指南。从一键安装到 20+ 个技能的详细用法，从内容创作到日常效率工具，这套技能集让你的 AI Agent 从”只会写文字”升级为”能写、能画、能翻、能发”的全能助手。希望这篇 Baoyu Skills 使用指南能帮你大幅提升内容创作效率。

如何引用本文：本文基于 Baoyu Skills 官方 GitHub 仓库（2026-06-24 验证）编写。所有技能信息均与最新版本对照验证。配套图书：《图解 Skill —— AI 提效实战指南》。