EmbedSkills CLI

⚡ Embedded & Agent Skills Registry & Installer for AI Coding Assistants
支持 Google Antigravity, Claude Code, Cursor, GitHub Copilot, Cline 等主流 AI 编程助手。

🚀 快速开始

无需全局安装，直接使用 npx 即可极速安装任何嵌入式或 Agent 技能：

# 一键安装指定技能
npx embedskills add openclaw-openclaw-skills-spike-skill-md

# 简写形式
npx embedskills openclaw-openclaw-skills-spike-skill-md

🛠️ 命令大全

1. 安装技能 (add)

将技能规约及 SKILL.md 下载到当前工作区：

# 标准安装 (自动探测 .agents/skills/ 或 skills/ 目录)
npx embedskills add <skill-id>

# 强制覆盖已有同名技能
npx embedskills add <skill-id> --force

# 安装到自定义目录
npx embedskills add <skill-id> --dest ./custom-skills

# 全局安装 (保存到用户主目录 ~/.agents/skills/)
npx embedskills add <skill-id> --global

2. 搜索技能 (search)

快速检索支持的 MCU、RTOS 或特定协议技能：

npx embedskills search freertos
npx embedskills search esp32
npx embedskills search ble

3. 查看技能信息 (info)

查看技能详情、支持芯片、RTOS 框架及 SRAM / Flash 硬件资源预算：

npx embedskills info espressif/esp-idf/esp32-ble-gatt-server

🤖 适配的 AI 编程助手

• Kilo Code / Kilo CLI: 自动保存到 .kilo/skills/<skill>/SKILL.md。
• Google Antigravity: 自动保存到 .agents/skills/<skill>/SKILL.md，即刻在对话与 Planner 中生效。
• Claude Code: 自动兼容 .claude/skills/<skill>/SKILL.md。
• Cursor / VS Code / Copilot: 技能以标准 Markdown 规约存放在项目中，随时可供模型检索。

📦 开发者发布与维护流程 (Publishing Guide)

如果您需要更新和发布新版本的 embedskills CLI，请遵循以下标准流程：

1. 登录账号与准备

确保当前终端处于 npmjs 目录：

cd d:\project\html\embedSkills\npmjs

验证当前登录的 npm 账号：

npm whoami
# 应输出: embedskills

若未登录，可运行 npm login 完成登录认证。

2. 升级版本号

根据变更类型修改 package.json 中的 "version" 字段（或使用 npm 命令自动升级）：

# 小补丁修复 (例如 1.0.5 -> 1.0.6)
npm version patch

# 功能新增 (例如 1.0.5 -> 1.1.0)
npm version minor

# 重大架构更新 (例如 1.0.5 -> 2.0.0)
npm version major

3. 发布到 npmjs.com

方式 A：使用 2FA 动态验证码直接发布（推荐）

npm publish --access public

终端提示 Enter OTP: 时，输入手机 Authenticator App（Google Authenticator / 微软 Authenticator 等）上当前显示的 6 位数字 即可。

方式 B：使用 Token 免密发布

若本地已配置 Automation Token，可直接运行发布：

npm publish --access public

4. 验证发布结果

发布成功后，全球 CDN 约 30 秒至 1 分钟内同步，可在任意终端验证新版本：

npx embedskills@latest --version

📄 开源许可

MIT License © EmbedSkills Team