@onagent/claude-skill

@onagent/claude-skill — onagent CLI 安装技能

技能简介

@onagent/claude-skill 是 onagent-cli-setup 的 Claude Code 技能包，通过 npm 分发。用户安装后，Claude Code 可以通过 npx claude-skill-onagent 命令一键将 onagent CLI 安装为本地技能，无需手动配置路径、下载二进制或设置环境变量。

核心能力

• 一键安装：执行 npx claude-skill-onagent 即可将 onagent CLI 安装为 Claude Code 技能
• 多平台二进制：包内已捆绑 Windows（amd64）、macOS（Intel + Apple Silicon）、Linux（amd64 + arm64）五个平台的可执行文件
• 用户级安装支持：支持 --user 参数安装到 ~/.claude/skills/（系统级则安装到项目本地）
• 无自动安装脚本：采用显式用户调用而非 postinstall 自动脚本，规避了 npm 禁用力脚本导致的风险
• 与 @onagent/bridge 协同：与同作用域的 @onagent/bridge 配套使用，提供完整的 onagent 工作环境
• SKILL.md 驱动：技能内容由包内 skill/SKILL.md 定义，符合 Claude Code 技能标准格式

安装配置

前提条件：Node.js 环境（用于运行 npx）

安装技能

项目级安装（安装到当前项目 .claude/skills/）：

npx claude-skill-onagent

用户级安装（安装到 ~/.claude/skills/，所有项目通用）：

npx claude-skill-onagent --user

验证安装

claude-skill-onagent --version

手动构建二进制（可选）

如果需要从源码构建（需要 Go 1.21+）：

cd ../../backend
GOWORK=off GOOS=windows GOARCH=amd64 go build -trimpath -ldflags="-s -w" 
  -o ../packages/claude-skill/skill/bin/onagent-windows-amd64.exe ./cmd/onagent
GOWORK=off GOOS=darwin GOARCH=arm64 go build -trimpath -ldflags="-s -w" 
  -o ../packages/claude-skill/skill/bin/onagent-darwin-arm64 ./cmd/onagent
# 其他平台...

发布到 npm（如需修改后重新发布）

npm publish --access public

使用步骤

第一步：安装技能包

在终端运行 npx claude-skill-onagent（或 npx claude-skill-onagent --user）。

第二步：在 Claude Code 中触发技能

安装完成后，Claude Code 会自动识别 onagent-cli-setup 技能。在对话中自然触发：

用 onagent 部署一个 API 服务
用 onagent 查询当前项目状态

第三步：使用 onagent CLI

技能安装后，Claude Code 会在需要时调用 onagent 命令行工具，完成对应的开发任务。

第四步：配合 @onagent/bridge 使用

如需更完整的 onagent 工作环境，同时安装 @onagent/bridge：

npm install @onagent/bridge

适用场景

• 快速搭建 onagent 开发环境：新克隆项目后，一行命令配置好 onagent CLI
• AI Agent 工作流集成：将 onagent 的自动化能力接入 Claude Code 的任务执行流程
• 跨平台开发：同一项目在不同操作系统上，通过 npm 包保证 onagent 版本一致
• CI/CD 流水线：在自动化构建脚本中调用 npx claude-skill-onagent 确保环境一致性

适用人群

• 使用 Claude Code 进行 AI 辅助开发的工程师
• 需要 onagent CLI 工具链的 AI Agent 开发者
• 需要在团队中标准化 onagent 安装流程的开发负责人
• 在 CI/CD 中需要自动化环境配置的 DevOps 工程师

工作原理

@onagent/claude-skill 是一个标准的 Claude Code 技能包。包内 skill/SKILL.md 文件定义了技能的触发词、描述和使用方式。当 Claude Code 识别到用户请求匹配技能时，会调用包内捆绑的平台对应二进制可执行文件（位于 skill/bin/），执行 onagent 命令并返回结果。

安装命令 npx claude-skill-onagent 实际上是将 skill/SKILL.md 复制到 Claude Code 的技能目录（.claude/skills/onagent-cli-setup/），并将 skill/bin/ 中的可执行文件路径注册到 Claude Code 的环境变量中，使 Claude 能够找到并调用 onagent。

官方链接

• npm：https://npmjs.com/package/@onagent/claude-skill
• GitHub：https://github.com/onagent/claude-skill
• onagent 官网：https://onagent.dev
• @onagent/bridge：https://npmjs.com/package/@onagent/bridge