XSkill's 用户指南

add — 安装技能

从源安装技能到目标目录。

xskill add [OPTIONS] --from <SOURCE> --skill <SKILL>

选项：

• -f, --from <SOURCE> — 源名称、ORG/REPO 或 Git URL
• -s, --skill <SKILL> — 技能名称（使用 '*' 表示所有技能）
• -g, --global — 安装到全局 ~/.agents/ 目录
• -a, --agent <AGENT> — 目标平台（使用 '*' 表示所有平台）
• -A, --all — --skill '*' --agent '*' 的简写（需配合 --from）

安装目标

源信息显示

安装前会输出源信息：Source: <source-name> (<source-url>)（标签 cyan bold）。

多源同名技能选择

当未指定 -f 且多个源（含注册中心）包含同名技能时：

• 交互终端：弹出 skim 单选 TUI，三列对齐显示：[registry] / -（第一列，注册中心条目显示 [registry]，本地源显示 -）、source_name、url。注册中心 source_name 为空或与本地源冲突时显示 -。
• 非交互终端：报错并列出所有匹配源（含 URL），提示使用 xskill add -f <source> -s <skill>。

输出样式

标签（Name、Description、Version、Path）使用 cyan bold 显示。Name 值使用黄色显示。Description 或 Version 为空时不显示该行。

• Path（cyan bold）：技能在仓库中的完整路径（如 skills/vue/SKILL.md）。
• Installed（green）：规范目录路径。
• Symlinked（green）：平台目录路径（不显示箭头和目标，因 Installed 行已展示规范目录）。
• Source（cyan bold）：Source: <name> (<url>)。

示例

# 安装到项目
xskill add -f antfu -s vue

# 安装到全局
xskill add -f antfu -s vue -g

# 安装到特定平台
xskill add -f antfu -s vue -a claude

# 安装到所有平台
xskill add -f antfu -s vue -a '*'

# 安装源中所有技能
xskill add -f antfu -s '*'

# 安装到所有位置
xskill add -f antfu -A