Documentation Index
Fetch the complete documentation index at: https://docs.gofastskill.com/llms.txt
Use this file to discover all available pages before exploring further.
FastSkill Cheatsheet
Quick reference for common FastSkill operations, ordered from everyday manifest workflow to advanced setup.
Manifest and workspace
| Operation | Command | What It Does |
|---|
| Install from manifest | fastskill install | Resolves [dependencies] in skill-project.toml, installs skills, updates skills.lock |
| Reproducible install | fastskill install --lock | Installs exact versions from skills.lock (CI and locked environments) |
| Update skills | fastskill update | Refreshes installed skills and lock from manifest (see update command) |
| Check updates only | fastskill update --check | Reports newer versions without changing files |
| List installed | fastskill list | Lists locally installed skills with reconciliation status (table) |
| List installed (JSON) | fastskill list --json | Same as list, machine-readable |
| Show all skills | fastskill show | Lists installed skills with versions from the lock file |
| Show one skill | fastskill show my-skill-id | ID, version, description, source |
| Show dependency tree | fastskill show --tree | Dependency relationships between installed skills |
| Read skill content | fastskill read my-skill-id | Skill docs and base path in an agent-oriented format |
| Remove skill | fastskill remove my-skill-id | Removes from skills dir, updates manifest and lock; prompts for confirmation |
| Force remove | fastskill remove my-skill-id --force | Removes without confirmation |
Add skills
| Operation | Command | What It Does |
|---|
| From registry | fastskill add pptx | Installs from the configured registry into the skills directory; updates manifest and lock |
| Pinned version | fastskill add pptx@1.2.3 | Installs that version and pins it in the lock file |
| From Git | fastskill add https://github.com/org/skill.git | Clones, validates layout, registers and installs |
| Editable local path | fastskill add ./dev-skill -e | Symlink or reference; edits apply without reinstall |
| Private registry | fastskill add team-skill | Uses auth from skill-project.toml / environment |
| Folder of skills | fastskill add ./skills -r | Adds each subdirectory that contains SKILL.md (local trees only) |
| Network share (Windows) | fastskill add \\\\fileserver\\corp-skills\\team-tools | Copies from a corporate share into the local skills directory |
| Operation | Command | What It Does |
|---|
| Sync all (non-interactive) | fastskill sync --yes | Writes the skill list to the auto-detected file (AGENTS.md, CLAUDE.md, or GEMINI.md) |
| Sync for one agent | fastskill sync --agent claude --yes | Targets that agent’s file (for example CLAUDE.md for claude) |
| Custom file | fastskill sync --agents-file custom.md --yes | Overrides auto-detection |
| Interactive | fastskill sync | Choose which skills to expose in the metadata file |
Search
| Operation | Command | What It Does |
|---|
| Catalog search | fastskill search "query" | Searches remote catalogs by default |
| Installed only | fastskill search "query" --local | Searches skills already on disk |
Skill authoring
| Operation | Command | What It Does |
|---|
| Initialize project | fastskill init | Reads SKILL.md frontmatter, prompts for gaps, writes skill-project.toml |
| Init with version | fastskill init --version 1.2.3 | Sets version without prompting |
| Init non-interactive | fastskill init --yes | Defaults from SKILL.md, no prompts |
| Package | fastskill package --output ./artifacts | Builds ZIP from skill-project.toml version with checksums and metadata |
| Package changed only | fastskill package --detect-changes --auto-bump | Hash-based change detection, version bump, package only what changed |
| Package subset | fastskill package --skills web-scraper data-processor | Packages only listed skills |
Repositories and catalog
| Operation | Command | What it does |
|---|
| List repositories | fastskill repos list | Entries from skill-project.toml |
| Repository details | fastskill repos info repo-name | Type, URL or path, priority, auth hints |
| Add repository | fastskill repos add repo-name --repo-type git-marketplace <url> | Adds a source (git-marketplace, http-registry, zip-url, local) |
| Remove repository | fastskill repos remove repo-name | Drops the entry |
| Update repository | fastskill repos update repo-name --branch main --priority 1 | Branch or priority changes |
| Test repository | fastskill repos test repo-name | Connectivity check |
| Refresh cache | fastskill repos refresh | Refreshes cached catalog metadata |
| List catalog skills | fastskill repos skills | Skills advertised by registries |
| Show catalog skill | fastskill repos show skill-id | One skill from the catalog |
| List versions | fastskill repos versions skill-id | Published versions for an id |
Local server
| Operation | Command | What it does |
|---|
| HTTP server | fastskill serve | Web UI and HTTP API (--host, --port; see serve command) |
