宝玉技能库：开箱即用的 AI 技能集

它是什么

baoyu-skills 是一套面向 AI Agent 的开源「技能包」（Skills）合集，由作者 JimLiu（宝玉）整理发布，定位是用现成的技能模块提升日常工作与内容生产效率。所谓 Skill，可以理解为一份带说明文档的标准化指令目录：其中 SKILL.md 描述了这项技能解决什么问题、需要哪些输入、按什么步骤执行、产出什么结果。Agent 在识别到匹配的任务时读取对应技能，按既定流程调用工具完成工作，用户不必每次重新口述做法。

这套合集覆盖 20 个以上的技能，方向集中在内容生产与分发：封面图生成、文章配图、微信公众号发布、Markdown 格式化与转换等。它同时兼容 Claude Code、Codex 等主流 Agent 运行时，并提供多条安装与分发路径——npx 一键安装、注册为插件市场、Codex 项目级目录挂载，以及发布到 ClawHub / OpenClaw。仓库以 MIT 协议开源。

从更宏观的角度看，Agent Skills 的出现解决的是一个常见的工程问题：Agent 本身能力通用，但缺乏领域化的"标准作业程序"。把流程沉淀成技能包后，同一段工作可以在不同会话、不同项目中稳定复现，也便于团队共享统一做法。

核心功能 / 内容清单

README 中明确点名或示例出现的技能包括（完整清单以官方 README 为准）：

封面图生成（baoyu-cover-image）：为文章生成封面图。在公众号工作流中，它被列为基础三件套之一，解决的是"文章写完了却没有合适封面"的高频卡点。
文章配图（baoyu-article-illustrator）：为正文生成并安排插图。相比封面，它处理的是正文内的视觉节奏问题——长文需要合适的图来分隔段落、降低阅读疲劳。
发布到微信公众号（baoyu-post-to-wechat）：把文章推送到公众号。README 特别说明该技能已经内置 Markdown 转微信可用 HTML 的完整流程，因此无需额外安装 baoyu-markdown-to-html，避免重复安装带来的冗余。
草稿结构化（baoyu-format-markdown）：把原始文本或初稿整理成规范 Markdown 文章，补齐标题、摘要、小标题、加粗、列表等结构。它针对的是"有想法但格式混乱"的输入，是进入发布流程前的整理环节。
Markdown 转 HTML（baoyu-markdown-to-html）：独立的格式转换技能，可单独在 ClawHub 安装使用。
图片生成（baoyu-image-gen）：README 在 ClawHub 的安装示例中以它作为演示技能之一，同样支持单独安装。

典型使用场景

场景一：从草稿到公众号发布的一条龙流程。 手头有一篇写得很随意的初稿，目标是发到微信公众号。此时按 README 建议安装最小技能集：baoyu-format-markdown（把散乱文字整理成结构化文章）、baoyu-cover-image（生成封面）、baoyu-article-illustrator（生成正文配图）、baoyu-post-to-wechat（转换并发布）。凭证按作用范围放进 ~/.baoyu-skills/.env 或项目目录下的 .baoyu-skills/.env，Agent 即可串起整条链路。如果不确定要不要装 baoyu-markdown-to-html，README 的答案是：发布技能已包含转换流程，不必重复安装。

场景二：只在一个项目里用少量技能。 如果你用 Codex，且只需要某个项目内具备两三项能力，不必安装完整插件。Codex 会扫描项目内的 .agents/skills 目录，因此把需要的技能作为完整目录复制或软链接进去即可，例如 <project>/.agents/skills/baoyu-cover-image/SKILL.md。这种做法把技能的生效范围限制在当前项目，不会污染其他工程的上下文。

场景三：把技能发布到 ClawHub。 面向技能作者：仓库提供了 sync-clawhub.sh 脚本，可先用 --dry-run 预览将发布的内容，再用 --all 发布 ./skills 下所有变更过的技能。ClawHub 以单个技能为单位安装，而非整体打包，所以发布后用户可以按需执行 clawhub install baoyu-image-gen 这类命令单独获取。

适合谁用

内容创作者与公众号运营者：从草稿整理、配图、封面到发布，整条链路都有对应技能，适合需要稳定产出图文内容的个人或小团队。
Claude Code / Codex 等 Agent 的重度用户：希望把重复性的编辑、排版、发布动作固化下来，减少每次重新描述流程的成本。
按项目隔离工具链的开发者：需要把技能限制在单个仓库范围内，使用 Codex 项目级 .agents/skills 挂载方式最合适。
技能作者与分发者：需要把自己的 Skill 发布到 ClawHub，或用插件市场方式统一注册管理的人。

快速上手

前置条件是本机已安装 Node.js 环境，并能执行 npx 相关命令。

最省事的路径是推荐的一键安装：npx skills add jimliu/baoyu-skills。另一种方式是在 Agent 中执行 /plugin marketplace add JimLiu/baoyu-skills，把它注册为插件市场后按界面提示选择技能（README 提到可选通过 Browse UI 浏览安装）。Codex 用户若只需项目级子集，则把技能目录复制或软链接到 <project>/.agents/skills/ 下。

微信公众号相关技能需要配置 API 凭证，按适用范围放置：用户级为 ~/.baoyu-skills/.env，项目级为 <project>/.baoyu-skills/.env。

README 中还有 ClawHub / OpenClaw 的发布与安装流程，以及完整的技能清单与各技能参数说明，具体命令、字段与最新支持范围以官方 README（含中文版 README.zh.md）为准。

注意事项

不要全量安装。 README 明确提示：仓库包含 20 多个技能，批量安装会为 Agent 的每次运行引入不必要的上下文开销。只装当前真正需要的技能。
避免重复安装。 baoyu-post-to-wechat 已包含 Markdown 转微信 HTML 的流程，无需再装 baoyu-markdown-to-html；后者适合独立在其他场景使用。
凭证安全。 .env 文件包含 API 凭证，不要提交到 Git 仓库。项目级 .env 适合凭证只在当前项目生效的情况。
协议差异。 仓库整体采用 MIT 协议开源；但按 ClawHub 注册表规则，发布到 ClawHub 的技能会以 MIT-0 发布。若涉及二次分发，需留意两者条款的区别。
路径与目录结构。 Codex 依赖 .agents/skills 扫描技能，且要求每个技能是完整目录（含 SKILL.md），仅拷贝单个文件通常不生效。
环境差异。 依赖 Node.js 与 npx，在受限网络或权限受限的环境中可能安装失败，建议提前确认执行权限与网络可达性。