企业官网建设流程全解析

如何用 Caveman CLI 预览并安装第三方 Skill 给 Agent？

【免费下载链接】caveman🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman

假设你找到一个第三方 Skill（比如某个 GitHub 仓库里的owner/repository技能包），想先确认它的指令内容，再决定是否交给 Codex、Claude Code 这样的 Agent 使用。caveman 的caveman tools skills命令组提供了这条路径：先preview查看技能正文（不写任何文件），确认后用add通过官方 Skills CLI 安装到指定 Agent，并可选择把技能说明压缩成像素页以降低 token 占用。整个过程只依赖 Caveman CLI 本身，不需要 Caveman Cloud 账号。

准备条件

• 已安装 caveman CLI。安装方式见 INSTALL.md（macOS / Linux / WSL 用install.sh，Windows PowerShell 用install.ps1）。
• npm 版 CLI 要求 Node.js 22.13 或更新版本（见 cli-reference.md）。
• 明确目标 Agent：文档中出现的示例目标包括codex和claude-code。

第一步：预览，不碰磁盘

caveman tools skills支持list、preview、install、add、import五类操作，其中 preview 的定位就是“安装前预览外部 skill”（见 cli-reference.md）：

caveman tools skills list caveman tools skills preview owner/repository caveman tools skills install owner/repository

对内置技能，可以直接按名称预览，例如：

caveman tools skills preview caveman-evidence-review caveman tools skills list --json

preview 只打印技能正文，不产生任何写入——这是 skills.runtime.mjs 中测试明确验证过的行为（“preview returns canonical content without writing”）。

预览时对照 skills-hooks-and-plugins.md 给出的信任清单逐项判断：

1. 阅读技能源码和它请求的权限；
2. 确认仓库与 commit 或 release 来源；
3. 检查它会修改哪些文件；
4. 确认移除命令或手动回滚路径；
5. 在一次性项目里先测试；
6. 不要授予超出功能所需的 shell 或浏览器权限。

文档特别强调：Caveman 不做第三方技能的安全审查，所以这一步不能省。

第二步：用add安装第三方 Skill

确认内容后可信后，用add通过官方 Skills CLI 安装。文档给出的两条示例命令分别代表“仓库 + 指定单个技能”和“仓库 URL + 整包全局安装”：

caveman tools skills add mattpocock/skills --skill tdd --agent codex -y caveman tools skills add https://github.com/vercel-labs/agent-skills --agent claude-code --global -y

命令格式为caveman tools skills add <source> [npx-skills-add-options] [--density conservative|balanced|max] [--no-pixel]。来源支持 GitHub 简写、Git/GitLab URL、直连 skill URL 和本地路径；上游--skill、--agent、--global、--list、--all等参数会原样透传给官方 Skills CLI。

安装时 Caveman 会做几件你应知道的事（见 packages/cli/README.md）：

• 若启用像素化，Caveman 会强制上游使用 copy 模式，并且只转换新增或变化的 Claude Code/Codex 技能；
• 转换后的技能目录中保留SKILL.orig.md，用于字节级精确回滚；
• 每次调用会报告估算 token 缩减，标记为inferred（推断值，不是供应商账单数据）；
• 加--no-pixel则保持上游纯文本行为，不做像素转换。

一个已记录在案的本地冒烟结果（文档示例，不是你的环境应得到的固定数值）：在 Matt Pocock 的 35 个技能仓库上，27 个被转换为像素，8 个安全地保留为文本，单次调用各转换技能合计 32,314 → 9,537 估算 token（−70%inferred）。文档同时声明：这是估算器输出，不是计费数据，也不是技能质量基准。

验证安装结果

• 安装完成后到目标 Agent 的技能目录查看：Claude Code 对应~/.claude/skills，Codex 对应~/.codex/skills（见 agents.generated.ts）。
• 如果技能被像素化，技能目录中会出现SKILL.orig.md和像素页（如SKILL.px1.png），SKILL.md内会包含指向这些图片页的像素标记；若目录里是普通文本SKILL.md，说明走了--no-pixel或该技能未被转换。
• 回滚单个已转换技能：

caveman convert --revert

• 移除整个集成时，文档建议通过技能安装器或 Agent 的技能管理器移除技能包，再检查 Agent 配置里是否有残留的 endpoint 变量（见 skills-hooks-and-plugins.md 的 Removing integrations 一节）。

限制与注意事项

• 第三方指令和资源按提供原样安装，Caveman 不做安全审查；Skills 属于指令，会影响模型行为，务必完成预览阶段的信任清单。
• 官方 Skills CLI 自身的遥测行为同样生效；如需在上游层面关闭，设置DISABLE_TELEMETRY=1。
• 报错时命令以非零退出码结束，无效参数、被拒绝的配置和失败的依赖都会体现为非零状态（见 cli-reference.md 的 Exit and failure behavior 一节）。

如果你还需要把已安装技能批量打包为像素形式，可以用caveman tools convert，它支持--agent、--project、--dry-run、--revert等参数，改动大技能树前先跑一次 dry run。

【免费下载链接】caveman🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman