1. 项目定位与用途
baoyu-skills 是一个专为 Claude Code 平台设计的开源技能集合项目,由开发者 JimLiu 维护。该项目将日常工作中常见的自动化任务封装为独立的技能(Skill),用户可以通过在 Claude Code 中执行命令直接调用这些技能,无需离开当前开发环境。项目核心定位是提升工作效率,通过即插即用的方式减少重复性手动操作,让用户专注于创造性工作。技能涵盖内容生成、AI 图像处理和实用工具三大类别,每个技能都遵循统一的命名规范(baoyu- 前缀)和开发标准,确保一致的使用体验。项目采用开源 MIT-0 许可证发布,鼓励社区贡献和技能扩展。所有技能通过插件市场或 ClawHub 分发,支持自动更新机制。
2. 解决的问题
baoyu-skills 主要解决 Claude Code 环境中缺乏高效辅助工具的问题。在日常开发与内容创作过程中,用户经常需要执行网页内容抓取、格式转换、图像生成等任务,这些操作通常需要切换工具、手动复制粘贴或编写临时脚本,效率低下且容易出错。本项目通过将这些分散的功能集成到统一的技能框架中,实现了任务的自动化执行。例如,用户不再需要手动提取网页正文并转换为 Markdown,而是可以直接使用 baoyu-url-to-markdown 技能完成;也不再需要借助外部工具生成系列图像卡片,baoyu-image-cards 技能即可根据内容自动生成多种风格的视觉化卡片。这种集成化方案显著减少了上下文切换,提升了工作流的连贯性和可重复性。
3. 适用场景
baoyu-skills 适用于多种工作效率提升场景。对于内容创作者,可以使用 baoyu-image-cards 将文章自动转换为卡通风格图像卡片系列,适配社交媒体发布;使用 baoyu-comic 生成漫画风格插图。对于开发者和研究人员,baoyu-fetch 能够快速抓取网页内容并转换为 Markdown 格式,便于知识整理;baoyu-md 提供专业的 Markdown 渲染和主题定制能力。对于办公人员,项目中的 PDF 和 PPT 生成功能(基于 pdf-lib 和 pptxgenjs)可以自动化文档创建流程。此外,baoyu-chrome-cdp 技能支持 Chrome 浏览器自动化,适用于需要模拟用户操作或进行网页测试的场景。所有技能均设计为在 Claude Code 环境中直接调用,适合需要频繁进行内容处理、数据提取和文档生成的用户群体。
4. 安装方式
baoyu-skills 提供多种安装方式以适应不同用户需求。最快捷的方式是通过 npx 命令一键添加:`npx skills add jimliu/baoyu-skills`,该命令会自动将技能集合集成到 Claude Code 环境中。用户也可以在 Claude Code 内部注册插件市场:执行 `/plugin marketplace add JimLiu/baoyu-skills`,然后通过浏览 UI 选择安装。对于希望直接安装的用户,可以使用命令 `/plugin install baoyu-skills@baoyu-skills`。此外,项目支持发布到 ClawHub 平台,每个技能可独立发布,用户可通过 `clawhub install baoyu-<skill-name>` 安装特定技能。所有安装方式均依赖 Node.js 环境和 Bun 运行时,确保技能能够正常执行。安装后,用户可以通过插件市场界面更新技能或启用自动更新功能,保持技能为最新版本。
5. 使用方式
使用 baoyu-skills 时,用户只需在 Claude Code 中执行相应的技能命令即可。以核心技能 baoyu-image-cards 为例,基本用法为 `/baoyu-image-cards <文件路径>` 或直接输入文本内容。该技能支持丰富的参数定制:`--style` 指定视觉风格(如 cute、notion、chalkboard 等 12 种风格),`--layout` 指定信息密度布局(如 sparse、dense、list 等 6 种布局),`--palette` 可覆盖调色板(如 macaron、neon)。对于非交互场景,添加 `--yes` 参数可跳过所有确认提示,适合定时任务。其他技能如 baoyu-fetch 支持 `--format` 指定输出格式、`--wait-for` 等待交互等选项。所有技能的使用方法均在 README 和各自文档中详细说明,用户可根据需求查阅具体参数和示例。
6. 实现特点与架构
baoyu-skills 采用 monorepo 架构管理,使用 npm workspaces 组织 packages/ 目录下的共享包。项目核心包含三个共享库:baoyu-fetch 负责网页内容抓取与格式转换,基于 Chrome DevTools Protocol 实现;baoyu-md 提供 Markdown 渲染、主题系统和 HTML 生成能力;baoyu-chrome-cdp 封装 Chrome 浏览器自动化接口。这些共享包通过同步脚本(如 scripts/sync-clawhub.sh)复制到各技能的 vendor/ 目录,确保每个技能自包含且可独立发布。所有 Chrome 自动化技能共享单个用户配置文件,路径由 BAOYU_CHROME_PROFILE_DIR 环境变量控制,避免配置文件冲突。技能执行依赖 Bun 运行时,通过 npx 或 bun 命令调用,符合 Claude Code 环境要求。项目遵循严格的技能开发规范,包括命名前缀、SKILL.md 模板和文档标准,保证技能质量和一致性。