skill-cli

将 Claude Code 的渐进式技能系统带到任何支持 Node.js 的环境。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:skill-cli。
它的用途是:将 Claude Code 的渐进式技能系统带到任何支持 Node.js 的环境。
完整的 Skill 内容见:https://321skill.com/skills/skill-cli/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

在 GitHub Actions 的 YAML 配置中,您可以这样使用:`- run: node skill-cli.js show api-design-guidelines`。这会在 CI 流水线中仅加载该技能的快速参考(约1500 token),为后续的代码检查或部署提供必要的上下文,而无需加载全部文档,极大优化了 Token 消耗。

介绍

Claude Code 内置的 Skill() 功能仅在其桌面端可用,这限制了技能在自动化流程、其他 AI 编程助手等环境中的复用。Skill CLI 解决了这一问题,它是一个零依赖的 Node.js 命令行工具,让您能在 GitHub Actions、Cursor、Windsurf 等任何运行 Node.js 的地方加载和使用技能。

使用方式非常简单。克隆仓库后,在 skills/ 目录下按照规范创建技能文件夹和 Markdown 文件。通过 ./skill-cli.js list 查看所有技能,./skill-cli.js show <技能名> 获取快速参考,./skill-cli.js detail <技能名> <文件名> 按需加载详细文档。

它非常适合需要在 CI/CD 流程中注入领域知识的运维工程师,在 Cursor 等编辑器中希望复用 Claude Code 技能的前后端开发人员,以及正在开发和测试新技能,需要快速迭代的智能体开发者。

建议遵循其倡导的“渐进式披露”原则:先通过 listshow 命令加载少量上下文(约1500-3000 token),仅在必要时才使用 detail 命令加载完整文档,这通常能节省 70-90% 的 token 消耗。

核心特点

核心区别在于实现了与 Claude Code 一致的“渐进式披露”技能加载模式,并能脱离 Claude Code 环境运行。同类工具可能只是简单的文档聚合器,而它通过分层命令(list/show/files/detail)精确控制上下文加载量,在非 Claude Code 环境中最大化复用了 Claude Code 的技能生态和最佳实践。

注意事项

这是一个 CLI 工具,需要用户手动或在脚本中调用,无法像 Claude Code 原生集成那样在对话中智能触发和自动加载技能。

常见问题

这个工具和 Claude Code 里的 Skill() 函数有什么区别?

Skill() 是 Claude Code 内置功能,只能在 Claude Code 桌面端使用。Skill CLI 是一个独立的命令行工具,可以在任何运行 Node.js 的环境(如 GitHub Actions、Cursor、终端)中加载相同的技能文件,实现类似的渐进式信息加载效果。

使用 Skill CLI 能节省多少 Token?

通过渐进式披露(先看列表和摘要,再按需加载细节),相比一次性加载所有技能文档,通常可以节省 70-90% 的 Token 消耗。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/skill-cli/raw/index.md 读取 skill-cli 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。