# Skills commands

Signatures, flags and examples for recala skills.

## Use these commands

The agent skills that ship with the CLI.

Examples assume you have signed in and selected the intended organization. Set shell variables such as `ARTICLE_ID` to ids from the corresponding list command. Set `PUBLICATION_TIME` to a future local time in YYYY-MM-DDTHH:MM format.

Badges describe the command’s strongest effect; a preview or read-only option may do less. [Guarded writes can require confirmation even without --yes](https://recala.co/developers/agents/#guarded). “Needs a person” covers identity, consent and credentials.

### [`recala skills install`](https://recala.co/developers/cli/skills/#cmd-skills-install)

Copy every skill (with the CLI contract as a reference) into --dir.

writes

```
recala skills install [OPTIONS]
```

Replace [OPTIONS] with the flags you need, or omit it.

| Flag | Required | Description |
| --- | --- | --- |
| `--json` | No | Print one JSON document (errors as JSON on stderr). |
| `--dir` | No | Where the agent reads skills (a project's .claude/skills, or ~/.claude/skills). |
| `--force` | No | Replace skills already installed there. |

#### Examples

Copy every skill, with the CLI contract as a reference, into .claude/skills in the current folder, where Claude Code reads project skills.

```
recala skills install
```

Install them for every project of the current user.

```
recala skills install --dir ~/.claude/skills
```

**Exit codes:** [`0` OK](https://recala.co/developers/reference/#exit-0), [`1` ERROR](https://recala.co/developers/reference/#exit-1), [`2` USAGE](https://recala.co/developers/reference/#exit-2).

API commands share the CLI’s HTTP error mapping. [Read human and JSON output rules](https://recala.co/developers/reference/#json-output).

### [`recala skills list`](https://recala.co/developers/cli/skills/#cmd-skills-list)

The skills this CLI ships.

read

```
recala skills list [OPTIONS]
```

Replace [OPTIONS] with the flags you need, or omit it.

| Flag | Required | Description |
| --- | --- | --- |
| `--json` | No | Print one JSON document (errors as JSON on stderr). |

#### Examples

The skills this CLI ships, with their versions.

```
recala skills list
```

**Exit codes:** [`0` OK](https://recala.co/developers/reference/#exit-0), [`1` ERROR](https://recala.co/developers/reference/#exit-1), [`2` USAGE](https://recala.co/developers/reference/#exit-2).

API commands share the CLI’s HTTP error mapping. [Read human and JSON output rules](https://recala.co/developers/reference/#json-output).