skills-center

XAgent Marketplace 的 Skill 命令行工具，用于搜索、安装和私有发布以 SKILL.md 为入口的完整 Skill 包。

快速开始

npx skills-center search testing
npx skills-center install @alice/test-generator --client codex
npx skills-center install @alice/one @bob/two --client codex,claude,qoder,kiro

同一套功能也通过 agents-center 别名包提供：

npx agents-center search testing

默认 registry 是 https://agents.nihao.cool。本地开发或私有部署可通过参数或环境变量覆盖：

export SKILLS_CENTER_REGISTRY_URL=http://127.0.0.1:8080

登录与发布

skills-center login
skills-center whoami
skills-center publish ./my-skill

login 会创建一个 5 分钟有效的一次性请求，显示 Marketplace 确认地址，并在交互终端按回车后打开浏览器。网页使用当前登录态确认授权，CLI 轮询成功后把 registry token 保存到 ~/.skills-center/config.json；配置文件权限为 0600。

CI 中可以直接使用 SKILLS_CENTER_TOKEN；需要密码模式时，同时设置 SKILLS_CENTER_USERNAME 和 SKILLS_CENTER_PASSWORD，或传入 --username 与 --password。不要把 token 或密码写入仓库。

上传目录必须在根目录同时包含 cpm.json 和 SKILL.md，entry 必须是 SKILL.md：

{
  "name": "@alice/test-generator",
  "displayName": "Test Generator",
  "version": "1.0.0",
  "summary": "Generate focused tests",
  "description": "Generate focused tests for an existing codebase.",
  "author": "Alice",
  "category": "Testing",
  "tags": ["test"],
  "entry": "SKILL.md"
}

publish 必须使用已登录账号，始终把完整 ZIP 私有保存到该账号的工作区，不修改为公开，也不会提交审核。同名包提升 SemVer 后再次执行 publish，会作为新的私有版本追加；相同版本不会覆盖已有制品。

安装目标

--client codex       ${CODEX_HOME:-~/.codex}/skills/<scope>--<name>
--client chatgpt     Codex 的别名
--client claude      ${CLAUDE_CONFIG_DIR:-~/.claude}/skills/<scope>--<name>
--client cluade      claude 的拼写兼容别名
--client qoder       ~/.qoder/skills/<scope>--<name>
--client qorder      qoder 的兼容别名
--client kiro        ~/.kiro/skills/<scope>--<name>
--client vscode      ~/.copilot/skills/<scope>--<name>
--client universal   ~/.config/agents/skills/<scope>--<name>
--client project     <cwd>/.agents/skills/<scope>--<name>

多个客户端用逗号分隔。未传目标时会检查 Codex、Claude Code、Qoder 和 Kiro 的配置目录，并安装到所有已检测到的客户端；没有检测到客户端时回退到当前项目的 .agents/skills。--client auto 可显式触发同一逻辑，SKILLS_CENTER_CLIENT 可设置默认值，--target <dir> 可覆盖为自定义根目录。旧的 --tool、--agent 和 -a 已移除，CLI 会明确报错并提示使用 --client。

当前 Marketplace 模型只有 Skill 包，没有单独的 Agent 包类型；所有包都安装到客户端的 skills/ 目录，并要求客户端可发现的根级 SKILL.md。安装会保留 ht-skills 这类 Skill 的整个目录，包括 scripts/、lib/、配置模板和其他资源。每个路径、base64 内容、单文件大小和展开总大小都会先校验；替换已有安装时使用同目录临时目录完成写入，再原子切换，失败不会破坏当前版本。

完整目录结构参考 1044197988/ht-skills。默认安装位置依据各客户端的 Skill 约定： Qoder Skills、Kiro Agent Skills、 Claude Code Skills，以及 Codex 自带 Skill 创建器使用的 $CODEX_HOME/skills。

命令

skills-center login [--registry <url>]
skills-center logout [--registry <url>]
skills-center whoami [--registry <url>] [--json]
skills-center search <query> [--limit <n>] [--json]
skills-center info <name[@version]>
skills-center install <name[@version]> [more-skills...] [--client <clients>|--target <dir>]
skills-center publish [skill-dir]

历史 cpm 命令仍作为兼容入口发布。