XSkill's Manual

add — Install a skill

Install a skill from a source to a target directory.

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

Options:

• -f, --from <SOURCE> — Source name, ORG/REPO, or Git URL
• -s, --skill <SKILL> — Skill name (use '*' for all skills)
• -g, --global — Install to global ~/.agents/ directory
• -a, --agent <AGENT> — Target platform (use '*' for all platforms)
• -A, --all — Shorthand for --skill '*' --agent '*' (requires --from)

Install targets

Source info display

Before installation, the source information is displayed: Source: <source-name> (<source-url>) (label in cyan bold).

Multi-source name collision

When -f is not specified and multiple sources (including registry) contain identically named skills:

• Interactive terminal: a skim single-select TUI is shown with three aligned columns: [registry] / - (first column — [registry] for registry entries, - for local sources), source_name, url. Registry entries show - as source name when empty or conflicting with a local source.
• Non-interactive terminal: an error is shown listing all matching sources (with URLs), suggesting xskill add -f <source> -s <skill>.

Output style

Labels (Name, Description, Version, Path) are displayed in cyan bold. Name values are shown in yellow. Empty Description or Version lines are hidden.

• Path (cyan bold): skill path within the repository (e.g. skills/vue/SKILL.md).
• Installed (green): canonical directory path.
• Symlinked (green): platform directory path (no arrow or target shown, as Installed already displays the canonical path).
• Source (cyan bold): Source: <name> (<url>).

Examples

# Install to project
xskill add -f antfu -s vue

# Install to global
xskill add -f antfu -s vue -g

# Install to a specific platform
xskill add -f antfu -s vue -a claude

# Install to all platforms
xskill add -f antfu -s vue -a '*'

# Install all skills from a source
xskill add -f antfu -s '*'

# Install everything everywhere
xskill add -f antfu -A