Introduction
1.
Features
2.
Installation
2.1.
Quick install
2.2.
From npm
2.3.
From crates.io
2.4.
From Git
2.5.
From source
2.6.
Requirements
2.7.
Pre-built binaries
3.
Quick Start
3.1.
Configure a source
3.2.
Query available skills
3.3.
Install a skill
3.4.
List installed skills
3.5.
Remove a skill
4.
Global Options
5.
Commands
5.1.
sources — Manage configured sources
5.2.
platforms — Manage configured platforms
5.3.
add — Install a skill
5.4.
link — Symlink existing skills to a platform
5.5.
remove — Remove a skill
5.6.
update — Update installed skills
5.7.
restore — Restore skills from lock file
5.8.
list — List installed skills
5.9.
query — Query skills from a source
5.10.
find — Interactively find and install skills
5.11.
rec — Manage recommended skills
5.12.
cache — Manage skills cache
5.13.
config — Manage configuration
5.14.
new — Create a skill project
6.
Configuration
6.1.
Config file location
6.2.
Configuration structure
6.3.
Full example
6.4.
Platforms
6.5.
Sources
6.6.
Recommended
6.7.
Cache
6.8.
Registry
6.9.
--from parameter resolution
6.10.
--skill parameter
6.11.
--agent validation
6.12.
URL normalization
7.
Installation Model: Canonical Directory + Symlinks
7.1.
Global vs local paths
7.2.
Symlink rules
7.3.
Fallback mechanism
7.4.
Platform directory behavior
8.
Lock File
8.1.
Locations
8.2.
Format
8.3.
Entry Fields
8.4.
Top-level Fields
9.
JSON Schemas
9.1.
xskill.schema.json — Tool configuration
9.2.
registry.schema.json — Registry index
9.3.
Editor integration
10.
Development
10.1.
Building
10.2.
Testing
10.3.
Project Structure
11.
License
Light (default)
Rust
Coal
Navy
Ayu
XSkill's Manual
Lock File
The lock file tracks installed skills for reproducibility.