前言¶
在对话里做二维码、压图、OCR、单位换算时,常见做法是每次从零描述需求,或临时找在线工具再贴回结果。步骤多、上下文容易断。若把这些能力写成统一的 Skill,Agent 在读到说明后按同一套流程调用,日常杂事可以集中在一次对话里完成。
下面介绍 SkillHub 上的社区 Skill「实用工具箱」(@user_29dc410e/toolbox-10-skill),当前版本 1.0.1,分类为 life-service,标签标明 requires_api_key=false,即不依赖额外 API Key 配置(以 SkillHub 页面标注为准)。
这是什么¶
实用工具箱是由社区发布者 user_29dc410e(SkillHub 页面作者显示为 super paul)维护的聚合型 Skill,来源为 community。它把多种高频实用能力写进通用 SKILL.md 格式,供 Cursor、Claude Code、Codex 等支持 Skills 的客户端加载后,由模型按技能说明执行。
官方页面与 API 入口:
- SkillHub 展示页:https://www.skillhub.cn/skills/user_29dc410e/toolbox-10-skill
- API 资源地址:https://api.skillhub.cn/user_29dc410e/toolbox-10-skill
SkillHub 统计(以抓取资料为准):评分 100000,下载 6327,安装 111。
核心功能¶
下列能力均来自官方简介,未在页面单独展开实现细节的部分不臆测接口或参数。
| 方向 | 能力(官方列举) |
|---|---|
| 码与扫描 | 二维码生成、扫码王 |
| 地震相关 | 地震查询、地震预警 |
| 声音 | 噪音检测、声贝测试 |
| 图像与文档 | 图片去水印、OCR 文字识别、文字提取、图片压缩、画质修复、老照片修复 |
| 证件照 | 证件照制作、一寸照 |
| 换算与格式 | 单位换算;文件格式转换(PNG、JPG、WEBP、TXT、MD 等) |
一节只对应一类需求:你向 Agent 说明目标(例如「把这张图压到 200KB 以内并转成 WEBP」),由已安装的 Skill 引导完成;具体子工具名称以安装包内 SKILL.md 为准。
安装与启用¶
安装流程遵循 SkillHub 官方说明文档 skillhub.cn/install/skillhub.md。核心要点:使用 skillhub CLI,且必须用 --dir 指向当前 Agent 的 skills 目录,否则默认装到 ./skills/ 可能不会被客户端识别。
1、检查或安装 skillhub CLI¶
command -v skillhub && skillhub --version
若未安装,可按官方文档执行完整安装(CLI + 默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill 到对应目录¶
官方页面给出的安装坐标为 @user_29dc410e/toolbox-10-skill。通用命令形式如下(将 <skills 目录> 换成你当前环境的路径):
skillhub install @user_29dc410e/toolbox-10-skill --dir <skills 目录>
常用客户端 skills 目录(摘自官方安装文档):
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
也可将官方页面中的提示词发给 AI,让其按 skillhub.cn/install/skillhub.md 完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装
@user_29dc410e/toolbox-10-skill。
安装后按你所用客户端的要求重启或刷新 Skills 列表,使 实用工具箱 进入可用状态。
典型用法¶
公开页面未提供逐条复制的业务示例命令;可复现的用法是:在 Skill 已加载的前提下,用自然语言点名官方简介中的能力,并附上必要输入(文件路径、目标格式、尺寸约束等)。
示例表述方式(意图与官方能力对齐,非虚构脚本输出):
- 二维码:说明要编码的文本或链接,要求生成二维码图片并给出保存位置。
- OCR / 文字提取:提供图片或扫描件路径,要求识别文字并整理为可编辑文本。
- 图片处理:说明去水印、压缩、画质或老照片修复需求,并指明输出格式(如 PNG、JPG、WEBP)。
- 证件照:给出原图与规格(如一寸照),按 Skill 内规则裁剪与换底(若 SKILL.md 有额外字段,以本地安装包为准)。
- 单位换算:写出数值与源单位、目标单位。
- 格式转换:说明源文件与目标类型(如 MD 转 TXT、PNG 转 WEBP)。
经过上面的步骤,Agent 应优先遵循 SKILL.md 中的工具选择与步骤,而不是临时编造未在技能中声明的外部服务。
适用场景与注意¶
适合谁
- 经常在 IDE 或终端 Agent 里处理生活类小任务、又不想每次重写一长段提示的开发者或普通用户。
- 希望在一个 Skill 内覆盖码、图、声、换算、证件照等杂项,减少在多个单功能 Skill 之间切换。
限制与注意
- 来源为 community,能力与稳定性以发布者维护的 1.0.1 包为准;升级前可用
skillhub查看版本与变更。 - 页面标注 requires_api_key=false,不代表所有子能力在离线环境都能用;若某子工具依赖系统权限(麦克风、本地二进制等),需在你本机满足 Skill 说明中的前置条件。
- 地震查询、地震预警等涉及实时数据的能力,准确性与数据源以技能实现为准,不宜替代官方应急渠道。
- 安装统计与评分为 SkillHub 平台数据,会随时间变化;核对时请打开官方展示页。
结尾¶
实用工具箱把二维码、图像处理、OCR、证件照、单位换算、格式转换等高频能力收拢到 @user_29dc410e/toolbox-10-skill,适合作为 life-service 类 Skills 的「日常杂物抽屉」。安装与目录配置以 SkillHub 安装文档 为准,技能详情与版本见 SkillHub 页面。