SkillsCat CLI

SkillsCat CLI 将 AI 智能体技能的搜索、安装、更新和发布集中在同一工具中。先运行 search 或 info，检查来源和内容，再通过 add 安装。

如果你使用的是 OpenClaw 生态中的 clawhub，请阅读 OpenClaw 文档，了解 /openclaw 兼容接口与原生 registry 的区别。

快速开始

在具备 Node.js 和 npx 的终端中，以下命令涵盖常见流程。将示例 slug 替换为技能详情页的实际值，不要根据仓库名猜测。

npx skillscat search "code review"
npx skillscat info owner/repo
npx skillscat add owner/my-skill
npx skillscat add owner/path/to/skill
npx skillscat update --check
npx skillscat list

搜索与检查

知道任务但不知道具体技能时，使用自然语言搜索。已知 GitHub 仓库时，用 info 检查其中有哪些技能，以及默认会安装哪一个。

npx skillscat search "seo audit"
npx skillscat search "jira auth" --category devops
npx skillscat info owner/repo

search 适合从任务或问题出发发现技能。
info 适合检查已知仓库的技能和目录结构。
多技能仓库也应先检查，再按目标技能的精确发布 slug 安装。

安装技能

add 默认安装到当前项目。需要跨项目复用时再选择 --global。已发布技能优先使用精确 slug，嵌套路径和多技能仓库同样适用。

npx skillscat add owner/my-skill
npx skillscat add owner/path/to/skill
npx skillscat add https://github.com/owner/repo
npx skillscat add owner/my-skill --global
npx skillscat add owner/my-skill --agent openclaw
npx skillscat add owner/repo --list

只知道仓库时，先运行 info 或 add owner/repo --list 发现目标技能。
--list 预览可安装条目，不写入安装文件。
--yes 跳过确认提示，供脚本流程使用。
--force 用于覆盖已有安装或继续处理需要额外确认的状态。
--agent openclaw 会按 OpenClaw 的目录结构安装。

管理安装

安装后，通过 list、remove、update 和 convert 管理本地内容。先用 update --check 检查可用更新，并保存项目中的自定义修改，再决定是否更新。

npx skillscat list
npx skillscat remove skill-name
npx skillscat update --check
npx skillscat update
npx skillscat convert openclaw --from agents
npx skillscat self-upgrade

list 查看当前项目或全局范围已安装的技能。
remove 按技能名删除本地安装。
update 优先使用 registry 更新；--check 只检查，不覆盖本地内容。
convert 将已有的 .agents 内容迁移到 OpenClaw 等目录结构。

认证与配置

访问私有技能、发布内容或执行其他写入操作前，先完成登录。whoami 与 config 可以帮助检查当前账号和 registry 配置。

npx skillscat login
npx skillscat whoami
npx skillscat logout
npx skillscat config list
npx skillscat config get registry
npx skillscat config set registry https://skills.cat/registry
npx skillscat config delete registry

login 通过浏览器完成设备登录，whoami 确认当前账号或令牌状态。原生 CLI 使用 https://skills.cat/registry；不要与 OpenClaw 指南中的 ClawHub 兼容入口混用。

发布与提交

publish 上传本地技能包，submit 提交公开 GitHub 仓库供 SkillsCat 索引。unpublish 用于下架已发布的私有技能。发布前检查目录及引用资源，确保脚本和模板完整。

npx skillscat publish ./my-skill
npx skillscat publish ./my-skill --private
npx skillscat submit https://github.com/owner/repo
npx skillscat unpublish owner/my-skill

命令参考

命令	使用场景
`npx skillscat search "code review"`	按任务或问题搜索公开技能。
`npx skillscat info owner/repo`	安装前检查仓库包含哪些技能。
`npx skillscat add owner/my-skill`	按精确发布 slug 安装技能。
`npx skillscat add owner/path/to/skill`	按嵌套路径 slug 安装已发布技能。
`npx skillscat update --check`	检查更新，不覆盖当前安装。
`npx skillscat login`	登录以访问私有技能、发布或执行写入操作。
`npx skillscat publish ./path/to/skill`	发布本地技能包。

使用 npx skillscat --help 或 npx skillscat publish --help 查看当前版本的命令与选项。

目标环境为 OpenClaw 或 ClawBot，或需要替换默认 ClawHub registry 时，请继续阅读 OpenClaw 指南。