实用工具箱:把高频生活类小工具收进一个 Agent Skill

前言

在对话里做二维码、压图、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 已加载的前提下,用自然语言点名官方简介中的能力,并附上必要输入(文件路径、目标格式、尺寸约束等)。

示例表述方式(意图与官方能力对齐,非虚构脚本输出):

  1. 二维码:说明要编码的文本或链接,要求生成二维码图片并给出保存位置。
  2. OCR / 文字提取:提供图片或扫描件路径,要求识别文字并整理为可编辑文本。
  3. 图片处理:说明去水印、压缩、画质或老照片修复需求,并指明输出格式(如 PNG、JPG、WEBP)。
  4. 证件照:给出原图与规格(如一寸照),按 Skill 内规则裁剪与换底(若 SKILL.md 有额外字段,以本地安装包为准)。
  5. 单位换算:写出数值与源单位、目标单位。
  6. 格式转换:说明源文件与目标类型(如 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 页面。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye