---
title: "Agent skills"
description: "`systhema skills install`, `list` and `refresh`."
url: https://docs.systhema.app/next/cli/skills
version: unreleased (main)
docs_index: https://docs.systhema.app/next/llms.txt
---

Manage the bundled Systhema agent skills.

> [!NOTE]
> The `skills/` folder inside the published `@systhemaui/cli` package is **generated at build time** from the `skills/` directory at the Systhema repository root — that root directory is the single hand-edited source. The two are byte-identical by construction; the bundled copy is a build artifact and is not tracked in git.

```bash
systhema skills list
systhema skills install
systhema skills install --agent claude --scope user
systhema skills refresh
```

## `systhema skills refresh`

Re-copy the bundled version of every skill that is already installed, into exactly the scope and agent locations where it is present. This is the by-hand twin of the upgrade's "Refresh skills" step and never adds a skill: `install --all-agents` is not a substitute, since it installs every agent into the chosen scope. `--dry-run` lists the targets, `--json` prints them.

<!-- generated:cli-flags skills refresh -->

| Flag        | Description                                  | Default |
| ----------- | -------------------------------------------- | ------- |
| `--dry-run` | List what would be refreshed without writing |         |
| `--json`    | Output as JSON                               |         |

<!-- /generated -->

## `systhema skills list`

List bundled skills and their install status.

Options:

<!-- generated:cli-flags skills list -->

| Flag               | Description                           | Default |
| ------------------ | ------------------------------------- | ------- |
| `--agent <agents>` | Filter by agent(s): claude,cursor,... |         |
| `--json`           | Output as JSON                        |         |
| `--name <name>`    | Filter to a single skill              |         |
| `--scope <scopes>` | Filter by scope(s): project,user      |         |

<!-- /generated -->

## `systhema skills install`

Install bundled skills to agent skill directories. Skills go into per-user (`~/.agents/skills/`) or per-project (`.agents/skills/`) directories, depending on scope.

Options:

<!-- generated:cli-flags skills install -->

| Flag               | Description                                   | Default |
| ------------------ | --------------------------------------------- | ------- |
| `--agent <agents>` | Agent(s): claude,cursor,... (comma-separated) |         |
| `--all-agents`     | Install for all supported agents              |         |
| `--json`           | Output as JSON                                |         |
| `--mcp`            | Also connect the systhema-docs MCP server     |         |
| `--name <name>`    | Install only the named skill                  |         |
| `--scope <scopes>` | Scope(s): project,user (comma-separated)      |         |

<!-- /generated -->

Once a skill is installed, [`systhema upgrade`](https://docs.systhema.app/next/cli/upgrade.md) keeps it current automatically — its **Refresh skills** step re-copies the now-bundled version into the locations where you already have it (skip with `--no-skills`). You only re-run `skills install` to add a skill to a _new_ scope or agent.

## Bundled skills

The bundled skills (subject to additions over time):

- `systhema:building-sites` — building full Systhema-based sites.
- `systhema:configuring-projects` — config file authoring and customization.
- `systhema:frontend-development` — design-time guidance.
- `systhema:from-figma-to-code` — exporting Figma tokens.
- `systhema` — high-level Systhema orientation.
- `systhema:cli` — using the CLI.
- `systhema:using-react-components` — choosing the right component.
- `systhema:payload-as-backend` — Payload-specific patterns.
- `systhema:understanding-tokens` — picking the right token / utility class.
- `systhema:creating-wireframes` — layout patterns.
- `systhema:discovering-runtime-cookies` — runtime-only cookie discovery (third-party scripts the static `cookies scan` can't see).

- `systhema:design` — generating and editing a design system with `systhema design`.

To connect agents to the version-correct docs as well, see [systhema mcp](https://docs.systhema.app/next/cli/mcp.md).