npx skills add 命令完整指南
一、全选安装方式对比
| npx skills add <来源> --all | 最彻底的"全选"。一键安装仓库里所有技能，并自动适配到电脑上所有已检测到的 AI 助手。过程无交互，一步到位。 |
| npx skills add <来源> --skill '*' | 指定全选所有技能。安装仓库里所有技能，但安装到哪些 AI 助手里，取决于是否同时指定了 --agent 参数，或由交互式选择决定。 |
二、常用参数速查表
| <来源> | - | 技能来源（必填），支持 GitHub 简写、完整 URL、子目录、本地路径 | K-Dense-AI/scientific-agent-skills |
| --all | - | 安装所有技能到所有已检测到的 AI 助手 | --all |
| --skill | -s | 安装指定技能，使用 '*' 表示所有技能 | --skill frontend-design 或 --skill '*' |
| --agent | -a | 指定目标 AI 助手，可多次指定，'*' 表示所有 | -a claude-code -a cursor 或 --agent '*' |
| --global | -g | 全局安装，对所有项目生效 | -g |
| --list | -l | 仅列出可用技能，不执行安装 | -l |
| --yes | -y | 自动确认所有提示（适合 CI/CD） | -y |
三、技能安装位置
| Claude Code | .claude/skills/<技能名>/ | ~/.claude/skills/<技能名>/ |
| Cursor | .cursor/skills/<技能名>/ | ~/.cursor/skills/<技能名>/ |
| Codex | .codex/skills/<技能名>/ | ~/.codex/skills/<技能名>/ |
| OpenCode | .agents/skills/<技能名>/ | ~/.config/opencode/skills/ |
| GitHub Copilot | .agents/skills/<技能名>/ | ~/.copilot/skills/ |
| Windsurf | .windsurf/skills/<技能名>/ | ~/.windsurf/skills/<技能名>/ |
| Kilo Code | .kilocode/skills/<技能名>/ | ~/.kilocode/skills/<技能名>/ |
通用技能存储中心：CLI 工具本身还会把技能文件的源副本统一存储在 ~/.agents/skills/ 目录下。
四、常用安装命令举例
示例 1：全选安装，一步到位
安装所有技能到所有已检测到的 AI 助手，无需交互确认。
npx skills add K-Dense-AI/scientific-agent-skills --all
示例 2：全选安装，并自动确认
适合脚本或 CI/CD 环境，跳过所有提示。
npx skills add K-Dense-AI/scientific-agent-skills --all -y
示例 3：全选安装，但只装给指定助手
安装所有技能，但只装给 Claude Code 和 Cursor。
npx skills add K-Dense-AI/scientific-agent-skills --skill '*' -a claude-code -a cursor
示例 4：全局安装给所有助手
全局安装所有技能，本机所有项目都能用。
npx skills add K-Dense-AI/scientific-agent-skills --all -g
示例 5：先看看有哪些技能，再决定
先列出仓库里有哪些可用技能，不执行安装。
npx skills add K-Dense-AI/scientific-agent-skills --list
示例 6：全选安装给特定助手，全局生效
针对 Claude Code 全局安装所有技能。
npx skills add K-Dense-AI/scientific-agent-skills --skill '*' -a claude-code -g
示例 7：只安装单个技能
从仓库中只安装名为 paper-analysis 的技能到 Cursor。
npx skills add K-Dense-AI/scientific-agent-skills -s paper-analysis -a cursor
示例 8：从本地路径安装
安装存放在本地的技能文件夹。
npx skills add ./my-local-skills --all
示例 9：从 GitHub 子目录安装
直接从仓库的子目录路径安装某个技能。
npx skills add https://github.com/K-Dense-AI/scientific-agent-skills/tree/main/skills/paper-analysis
