> ## 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.

# Cheatsheet

> Quick reference for common FastSkill operations

# 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](/cli-reference/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                                                                          |
| Read skill content    | `fastskill read my-skill-id`           | Full `SKILL.md` and base path in an agent-oriented format                                               |
| Read skill metadata   | `fastskill read my-skill-id --meta`    | ID, version, description, source (add `--json` for machine output)                                      |
| Dependency tree       | `fastskill read my-skill-id --tree`    | Dependency relationships for the skill                                                                  |
| 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                              |

## 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                                    |
| Resolve paths (agents) | `fastskill search "query" --local --paths`                | Emits canonical skill paths instead of result rows                 |
| Paths with content     | `fastskill search "query" --local --paths --content full` | Includes `SKILL.md` content (`none`, `preview`, or `full`) in JSON |

## Diagnostics

| Operation         | Command                   | What It Does                                                                                                               |
| ----------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Environment check | `fastskill doctor`        | Reports configuration and environment readiness, including whether an embedding provider is configured for semantic search |
| Machine-readable  | `fastskill doctor --json` | Same checks as JSON                                                                                                        |

<Note>
  Modern agents (Claude Code, Cursor, …) read skills directly from the skills directory — there is no metadata-file sync step. Just `fastskill install` (or `fastskill add`) and the agent discovers them.
</Note>

## 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                                        |

## 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                                           |

See [Registry overview](/registry/overview) and [repos command](/cli-reference/repository-command).

## Local server

| Operation         | Command                                                                                                      | What it does                                                                                                  |
| ----------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| HTTP server       | `fastskill serve`                                                                                            | Web UI and HTTP API under `/api/v1/…` (`--host`, `--port`; see [serve command](/cli-reference/serve-command)) |
| Liveness probe    | `curl http://localhost:8080/healthz`                                                                         | Returns JSON with fastskill version; suitable for container health checks                                     |
| Readiness probe   | `curl http://localhost:8080/readyz`                                                                          | Returns 200 when ready, 503 during graceful shutdown                                                          |
| List skills (API) | `curl http://localhost:8080/api/v1/skills`                                                                   | JSON list of installed skills                                                                                 |
| Search (API)      | `curl -X POST http://localhost:8080/api/v1/search -d '{"query":"text"}' -H 'Content-Type: application/json'` | Search skills via HTTP                                                                                        |