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

# Marketplace, analyze, and doctor

> CLI reference for fastskill marketplace, fastskill analyze, and fastskill doctor.

<Note>
  `fastskill sync` has been removed. Agents read the skills directory directly; no metadata-file sync is needed.
</Note>

## fastskill marketplace

### marketplace create

Scans a directory for skills (folders with `SKILL.md`) and writes `marketplace.json`.

```bash theme={null}
fastskill marketplace create --path ./skills --name my-marketplace
fastskill marketplace create -p . -o .claude-plugin/marketplace.json --name "My Marketplace"
```

| Option                                                        | Description                                                         |
| ------------------------------------------------------------- | ------------------------------------------------------------------- |
| `-p, --path <DIR>`                                            | Root to scan (default: `.`)                                         |
| `-o, --output <FILE>`                                         | Output path (default under `.claude-plugin/` in the scan directory) |
| `--base-url <URL>`                                            | Base URL for download links                                         |
| `--name <NAME>`                                               | **Required.** Marketplace name                                      |
| `--owner-name`, `--owner-email`, `--description`, `--version` | Optional metadata                                                   |

## fastskill analyze

Requires a running service context (installed skills and index) like other service commands.

### analyze matrix

Pairwise similarity between indexed skills.

```bash theme={null}
fastskill analyze matrix
fastskill analyze matrix --threshold 0.8 --limit 5
fastskill analyze matrix --full --json
```

| Option               | Description                                |
| -------------------- | ------------------------------------------ |
| `--format <FORMAT>`  | `table`, `json`, `grid`, `xml`             |
| `--json`             | Shorthand for `--format json`              |
| `--threshold <0..1>` | Minimum similarity to show (default `0.0`) |
| `-l, --limit <N>`    | Similar skills per skill (default `10`)    |
| `--full`             | Show all pairs instead of condensed view   |

### analyze cluster

Groups skills by semantic similarity.

```bash theme={null}
fastskill analyze cluster
fastskill analyze cluster -k 8 --min-size 2 --json
```

| Option                   | Description                         |
| ------------------------ | ----------------------------------- |
| `-k, --num-clusters <N>` | Number of clusters (default `5`)    |
| `--min-size <N>`         | Hide smaller clusters (default `1`) |
| `--format`, `--json`     | Output selection                    |

### analyze duplicates

Finds near-duplicate skills.

```bash theme={null}
fastskill analyze duplicates
fastskill analyze duplicates --threshold 0.92 --severity critical
```

| Option               | Description                            |
| -------------------- | -------------------------------------- |
| `--threshold <0..1>` | Minimum similarity (default `0.88`)    |
| `--limit <N>`        | Max pairs to show (default `20`)       |
| `--severity <LEVEL>` | `all`, `medium`, `high`, or `critical` |
| `--format`, `--json` | Output selection                       |

## fastskill doctor

Check environment readiness for fastskill. Reports the status of the skills directory, `skill-project.toml`, embedding provider, API key, and auth token. Exits 0 when no hard failures are found; exits 1 when the skills directory is inaccessible.

```bash theme={null}
fastskill doctor
fastskill doctor --json
```

| Option   | Description                                              |
| -------- | -------------------------------------------------------- |
| `--json` | Emit results as JSON array of `{check, status, message}` |

**Example output:**

```
[PASS] Skills directory accessible
[PASS] skill-project.toml present
[WARN] Embedding provider not configured (semantic search unavailable)
[WARN] No authenticated registry
```

## See also

* [Discovery commands](/cli-reference/discovery-commands) (search, reindex)
* [Repository command](/cli-reference/repository-command) (`repos`)