FastSkill Cheatsheet
Quick reference for common FastSkill operations.Installation
| Operation | Command | What It Does |
|---|---|---|
| Public registry | fastskill add pptx | Installs skill from configured registry, clones to .claude/skills/, updates skills.toml and skills-lock.toml |
| With version | fastskill add pptx@1.2.3 | Installs specific version from registry, pins exact version in lock file |
| Private registry | fastskill add team-skill | Installs from private registry (auth configured in .claude/repositories.toml), uses env var for authentication |
| Git repo | fastskill add https://github.com/org/skill.git | Git URL is the source (no package name needed), clones repository, validates skill structure, registers and installs to skills directory |
| Network share | fastskill add \\\\fileserver\\corp-skills\\team-tools | Installs from corporate network file share, copies skill to local skills directory, enables team-wide skill distribution |
| Editable install | fastskill add ./dev-skill -e | Creates symlink/reference to local path, changes reflect immediately without reinstall |
| Remove skill | fastskill remove my-skill-id | Removes skill from skills directory, updates skills.toml and skills-lock.toml, prompts for confirmation |
| Force remove | fastskill remove my-skill-id --force | Removes skill without confirmation prompt |
| Show all skills | fastskill show | Lists all installed skills with versions from lock file |
| Show skill details | fastskill show my-skill-id | Displays detailed information about specific skill (ID, version, description, source) |
| Show dependency tree | fastskill show --tree | Displays dependency relationships between installed skills |
Skill Authoring
| Operation | Command | What It Does |
|---|---|---|
| Initialize metadata | fastskill init | Extracts metadata from SKILL.md frontmatter, prompts for missing fields, creates skill-info.toml |
| With version | fastskill init --version 1.2.3 | Creates skill-info.toml with specified version, skips version prompt |
| Non-interactive | fastskill init --yes | Uses defaults from SKILL.md, creates skill-info.toml without prompts |
| Package skill | fastskill package --output ./artifacts | Packages skill into ZIP artifact with version from skill-info.toml, creates checksums and metadata |
| Auto-detect changes | fastskill package --detect-changes --auto-bump | Detects changed skills using file hashes, auto-bumps version, packages only changed skills |
| Package specific | fastskill package --skills web-scraper data-processor | Packages only specified skills into ZIP artifacts |
Servers
| Operation | Command | What It Does |
|---|---|---|
| Web UI | fastskill serve --enable-registry | Starts HTTP server with REST API and web UI at /registry for browsing installed skills |
| API server | fastskill serve | Starts HTTP server with REST API only (no web UI), exposes endpoints for programmatic access |
| Proxy | fastskill proxy | Starts proxy server that intercepts Anthropic API calls, automatically injects relevant skills into requests |
Admin
| Operation | Command | What It Does |
|---|---|---|
| List repositories | fastskill repository list | Lists all configured repositories from .claude/repositories.toml |
| Show repository | fastskill repository show repo-name | Displays repository configuration details (type, URL, auth, priority) |
| Add repository | fastskill repository add repo-name --repo-type git-marketplace <url> | Adds new repository to configuration, supports git-marketplace, git-registry, zip-url, local |
| Remove repository | fastskill repository remove repo-name | Removes repository from configuration |
| Create marketplace | fastskill repository create --path ./skills | Scans directory for skills, generates marketplace.json for repository distribution |