dk-skills

公司内部 AI 编码 Agent 技能管理工具。通过统一 CLI 安装、更新、管理各 Agent 的技能包。

支持 OpenCode、Claude Code、Codex、Cursor 等 41 个 Agent。

快速开始

1. 配置认证

# 浏览器一键授权（推荐）
npx dk-skills auth

# 或直接传入 Key（适合 CI/CD）
npx dk-skills auth dk-ai-p-xxxxxxxxxxxxxxxx

auth 也可以写作 login，二者等价。认证 Key 保存在 ~/.acore/auth.json（用户级，所有项目共用）。

authKey 请前往 AI 中台 / AI 接口申请。

也可手动创建项目级 .acore/auth.json（优先级更高），格式：{ "authKey": "..." }。请将该文件加入 .gitignore，防止密钥泄露。

2. 安装技能

# 拉取全部可用技能，交互式选择安装
npx dk-skills add all

# 安装指定技能（按 slug）
npx dk-skills add baidu-api-test
npx dk-skills add baidu-api-test frontend-mandatory-standards

3. 更新技能

npx dk-skills update

安装命令

# 交互式选择安装
npx dk-skills add all

# 按 slug 安装一个或多个技能
npx dk-skills add <slug> [slug...]

选项

| 选项 | 说明 | | ------------------------- | ------------------------------------------------- | | -a, --agent <agents...> | 指定安装到哪些 Agent（例如 claude-code、kiro-cli）| | -y, --yes | 跳过所有确认提示 |

示例

# 安装到指定 Agent
npx dk-skills add baidu-api-test -a claude-code -a kiro-cli

# 非交互式安装（CI/CD）
npx dk-skills add baidu-api-test -y

安装范围

| 范围 | 标志 | 路径 | 说明 | | ----------- | ---------- | ------------------- | ---------------------------- | | 项目 | （默认） | ./<agent>/skills/ | 提交到仓库，团队共享 | | 全局 | -g | ~/<agent>/skills/ | 当前用户所有项目均可用 |

更新命令

# 更新项目技能（自动检测范围）
npx dk-skills update

# 只更新项目级技能
npx dk-skills update -p

# 只更新全局技能
npx dk-skills update -g

# 跳过范围确认（非交互式）
npx dk-skills update -y

| 选项 | 说明 | | --------------- | --------------------------------------------------------- | | -g, --global | 只更新全局技能 | | -p, --project | 只更新项目技能 | | -y, --yes | 跳过范围选择（有项目技能则更新项目，否则更新全局） | | [skills...] | 指定技能名，只更新匹配的技能 |

其他命令

| 命令 | 说明 | | ------------------------------- | ----------------------------- | | npx dk-skills agents | 列出所有支持的 Agent 及目录 | | npx dk-skills list | 列出已安装的技能（别名：ls）| | npx dk-skills remove [skills] | 删除已安装的技能 | | npx dk-skills init [name] | 创建新技能模板（SKILL.md） |

查看支持的 Agent

# 终端友好格式（✓ 标记当前项目中已存在的目录）
npx dk-skills agents

# JSON 格式（供 AI/脚本解析）
npx dk-skills agents --json

输出示例：

Supported agents  (✓ = skill folder exists in current project)

  Agent            --agent            Project Dir
  ──────────────────────────────────────────────────
✓ Claude Code      claude-code        .claude/skills
  Cursor           cursor             .agents/skills
✓ Kiro CLI         kiro-cli           .kiro/skills
  ...

--json 输出可直接供 AI 读取，用于自动选择 -a 参数：

npx dk-skills agents --json
# [{"agent":"claude-code","displayName":"Claude Code","skillsDir":".claude/skills","exists":true}, ...]

列出技能

# 列出项目技能
npx dk-skills list

# 列出全局技能
npx dk-skills ls -g

# 按 Agent 筛选
npx dk-skills ls -a claude-code

删除技能

# 交互式选择删除
npx dk-skills remove

# 删除指定技能
npx dk-skills remove baidu-api-test

# 从指定 Agent 删除
npx dk-skills remove --agent claude-code baidu-api-test

# 删除所有技能
npx dk-skills remove --all

推送技能到平台

将本地编写的技能推送到 AI 中台，供其他人安装使用。

# 交互式（逐步引导）
npx dk-skills push

# 非交互式（一行完成，适合 AI/CI 场景）
npx dk-skills push --dir .claude/skills --skill my-skill --bump patch --changelog "修复问题" --auditor-id -1

CLI 会自动检测当前目录中存在的技能文件夹，引导完成以下步骤：

1. 选择技能来源目录（如 .claude/skills、.agents/skills）
2. 选择要推送的技能
3. 首次推送：选择审核人 → 推送
4. 更新推送：选择版本类型 → 填写变更说明 → 选择审核人 → 推送

参数说明

| 参数 | 说明 | | ---- | ---- | | --skill <slug> | 技能文件夹名 | | --dir <path> | 技能目录，如 .claude/skills（有多个目录时用于指定） | | --bump patch\|minor\|major | 版本递增类型（更新时用） | | --changelog <text> | 变更说明，≤200 字（更新时用） | | --auditor-id <id> | 审核人 ID；-1 表示平台默认审核人 | | -y | 非交互模式，有歧义时自动取第一项 |

版本类型

| 类型 | 示例 | 说明 | | ---- | ---- | ---- | | patch | 1.0.0 → 1.0.1 | Bug 修复、措辞调整 | | minor | 1.0.0 → 1.1.0 | 新增内容、非破坏性改动 | | major | 1.0.0 → 2.0.0 | 重大重写或破坏性变更 |

注意事项

• 需先完成认证（dk-skills auth）
• 技能文件夹名即为平台 slug，请确保与 SKILL.md 中 name 字段派生一致
• slug 已被他人占用时无法推送，需更换文件夹名

兼容 Git 仓库安装

除公司内部技能外，仍支持从 GitHub / GitLab 仓库安装：

# GitHub 简写
npx dk-skills add vercel-labs/agent-skills

# 完整 URL
npx dk-skills add https://github.com/vercel-labs/agent-skills

# 指定仓库内某个技能
npx dk-skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# 本地路径
npx dk-skills add ./my-local-skills

技能格式

技能是包含 SKILL.md 文件的目录，文件头部为 YAML frontmatter：

---
name: my-skill
description: 技能的简要说明
---

# My Skill

具体指令内容...

必填字段

• name：技能唯一标识（建议小写 + 连字符）
• description：简短描述

支持的 Agent

CLI 会自动检测已安装的 Agent。未检测到时会提示手动选择。

| Agent | --agent | 项目路径 | 全局路径 | | ------------------------------------- | ---------------------------------------- | ---------------------- | ------------------------------- | | Amp, Kimi Code CLI, Replit, Universal | amp, kimi-cli, replit, universal | .agents/skills/ | ~/.config/agents/skills/ | | Antigravity | antigravity | .agents/skills/ | ~/.gemini/antigravity/skills/ | | Augment | augment | .augment/skills/ | ~/.augment/skills/ | | IBM Bob | bob | .bob/skills/ | ~/.bob/skills/ | | Claude Code | claude-code | .claude/skills/ | ~/.claude/skills/ | | OpenClaw | openclaw | skills/ | ~/.openclaw/skills/ | | Cline, Warp | cline, warp | .agents/skills/ | ~/.agents/skills/ | | CodeBuddy | codebuddy | .codebuddy/skills/ | ~/.codebuddy/skills/ | | Codex | codex | .agents/skills/ | ~/.codex/skills/ | | Command Code | command-code | .commandcode/skills/ | ~/.commandcode/skills/ | | Continue | continue | .continue/skills/ | ~/.continue/skills/ | | Cortex Code | cortex | .cortex/skills/ | ~/.snowflake/cortex/skills/ | | Crush | crush | .crush/skills/ | ~/.config/crush/skills/ | | Cursor | cursor | .agents/skills/ | ~/.cursor/skills/ | | Deep Agents | deepagents | .agents/skills/ | ~/.deepagents/agent/skills/ | | Droid | droid | .factory/skills/ | ~/.factory/skills/ | | Firebender | firebender | .agents/skills/ | ~/.firebender/skills/ | | Gemini CLI | gemini-cli | .agents/skills/ | ~/.gemini/skills/ | | GitHub Copilot | github-copilot | .agents/skills/ | ~/.copilot/skills/ | | Goose | goose | .goose/skills/ | ~/.config/goose/skills/ | | Junie | junie | .junie/skills/ | ~/.junie/skills/ | | iFlow CLI | iflow-cli | .iflow/skills/ | ~/.iflow/skills/ | | Kilo Code | kilo | .kilocode/skills/ | ~/.kilocode/skills/ | | Kiro CLI | kiro-cli | .kiro/skills/ | ~/.kiro/skills/ | | Kode | kode | .kode/skills/ | ~/.kode/skills/ | | MCPJam | mcpjam | .mcpjam/skills/ | ~/.mcpjam/skills/ | | Mistral Vibe | mistral-vibe | .vibe/skills/ | ~/.vibe/skills/ | | Mux | mux | .mux/skills/ | ~/.mux/skills/ | | OpenCode | opencode | .agents/skills/ | ~/.config/opencode/skills/ | | OpenHands | openhands | .openhands/skills/ | ~/.openhands/skills/ | | Pi | pi | .pi/skills/ | ~/.pi/agent/skills/ | | Qoder | qoder | .qoder/skills/ | ~/.qoder/skills/ | | Qwen Code | qwen-code | .qwen/skills/ | ~/.qwen/skills/ | | Roo Code | roo | .roo/skills/ | ~/.roo/skills/ | | Trae | trae | .trae/skills/ | ~/.trae/skills/ | | Trae CN | trae-cn | .trae/skills/ | ~/.trae-cn/skills/ | | Windsurf | windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ | | Zencoder | zencoder | .zencoder/skills/ | ~/.zencoder/skills/ | | Neovate | neovate | .neovate/skills/ | ~/.neovate/skills/ | | Pochi | pochi | .pochi/skills/ | ~/.pochi/skills/ | | AdaL | adal | .adal/skills/ | ~/.adal/skills/ |

[!NOTE] Kiro CLI 用户： 安装技能后，需手动将技能加入 .kiro/agents/<agent>.json 的 resources：

{
  "resources": ["skill://.kiro/skills/**/SKILL.md"]
}

环境变量

| 变量 | 说明 | | -------------------- | ---------------------------- | | DISABLE_TELEMETRY | 禁用匿名使用统计 | | DO_NOT_TRACK | 同上，备用方式 |

License

MIT