> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joystream.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# jstm skills

> Browse the skills catalog, check whether a skill can run, and manage skill source repositories.

## Browsing the catalog

```bash theme={null}
jstm skills list
jstm skills list --category productivity --featured --limit 50
jstm skills search calendar
jstm skills show 9b74e2a1-33cd-4f80-a5e6-1d20b8f7c4aa
jstm skills stats
```

| Command           | Options                                                                |
| ----------------- | ---------------------------------------------------------------------- |
| `list`            | `--category`, `-c`; `--featured`, `-f`; `--limit`, `-l` (20); `--json` |
| `search <query>`  | `--json`                                                               |
| `show <skill-id>` | `--json`                                                               |
| `stats`           | `--json`                                                               |

## `skills check`

Report whether a skill needs an MCP server, and which one it resolved to.

```bash theme={null}
jstm skills check google-calendar-read
jstm skills check google-calendar-read --json
```

The result tells you `needs_mcp`, the resolver's verdict, and the bound MCP server. This is the fastest way to answer "will this skill actually run in my workspace?" before you build an agent around it.

A skill that needs no external tool executes through the model directly rather than failing.

## Source repositories

Sync a GitHub repository of skills into the catalog.

### `skills repo add`

```bash theme={null}
jstm skills repo add https://github.com/acme-corp/internal-skills --scope personal

jstm skills repo add https://github.com/acme-corp/internal-skills \
  --scope selected --workspace acme-corp/finance
```

| Option         | Description                                           |
| -------------- | ----------------------------------------------------- |
| `--scope`      | Required. `all`, `selected`, or `personal`            |
| `--workspace`  | Workspace ids for `--scope selected`. Repeatable      |
| `--name`, `-n` | Display name. Defaults to the URL's last path segment |
| `--no-sync`    | Register without importing. For scripted flows        |
| `--json`       | Emit as JSON                                          |

Adding auto-imports the repository's skills unless you pass `--no-sync`.

Only GitHub URLs are accepted. Private repositories work using your own connected GitHub credential.

### The rest of the repo commands

```bash theme={null}
jstm skills repo list
jstm skills repo list --scope personal
jstm skills repo sync 9b74e2a1-33cd-4f80-a5e6-1d20b8f7c4aa
jstm skills repo scope 9b74e2a1-33cd-4f80-a5e6-1d20b8f7c4aa --scope all
jstm skills repo remove 9b74e2a1-33cd-4f80-a5e6-1d20b8f7c4aa
```

`repo scope` takes the same `--scope` and repeatable `--workspace` options as `repo add`.

## See also

* [Skills and MCP servers](/concepts/skills-and-mcp) — the model.
* [Add skill and MCP repositories](/guides/add-skill-and-mcp-repositories) — walkthrough.
* [`jstm session`](/cli/session) — pin a skill to a builder session.