docs / index
skillmod docs
A task-organized reference. To get your first skill running, start with the five-minute start; for the exact usage of a command, go to the command reference; for the rules behind the behavior, go to core concepts.
Reading paths
| You are | Suggested route |
|---|---|
| New to skillmod | Five-minute start → Scenario guide |
| Installed, looking up a command | Command reference |
| Wiring skillmod into CI or scripts | Automation & CI |
| Hitting an error or odd state | Troubleshooting |
All pages
Five-minute start
Install, add your first skill, meet SKILL.mod and SKILL.lock, and run sync and verify end to end.
02Core concepts
The division of labor between the two files, global vs project scope, the three immutable version forms, install modes and shared storage.
03Command reference
All eleven commands: syntax, common flags, behavioral conventions, and caveats.
04Scenario guide
Adopting what already exists, project distribution, updating and pinning, sharing with agents, removal and cleanup.
05Automation & CI
Exit-code table, the --json report shape, the action vocabulary, and wiring skillmod into a pipeline.
06Troubleshooting
A step-by-step self-check, what common errors mean, and preparing a report worth filing.
By task
| I want to… | Go to |
|---|---|
| Install skillmod and run a first skill | Five-minute start |
| Understand what SKILL.mod and SKILL.lock each do | Core concepts · Two files |
| Split global skills from project skills | Core concepts · Scopes |
| Pin a version and leave it alone | Core concepts · Versions |
| Get every team machine on the same skill set | Scenario guide · Distribution |
| Bring skills already on disk under management | Scenario guide · Adoption |
| Know what exit code 2 or 3 means | Automation & CI |
| Fix a drift reported by verify | Troubleshooting |