# Agent skills

Give your agent the instructions for a specific Recala task.

## Install where your agent reads skills

Skills run under your sign-in and role, or a scoped key where organization-key access is enabled. Human-only actions still require a person.

For a Codex project:

```
recala skills install --dir .agents/skills
```

For a Claude Code project:

```
recala skills install
```

Codex and other agents that read SKILL.md files: pass the folder that agent reads to --dir. The skills are plain files, so nothing else is needed.

## Choose a skill for the task

```
recala skills list
```

- `recala-onboard`: Sets up a company in a conversation, one question and one action at a time, from sign-in to auto-run with a named signer. It never buys a plan or publishes.

- `recala-onboard-brand`: The earlier name of recala-onboard, kept so agents that already installed it run the same setup.

- `recala-plan-month`: Proposes a month of articles from the topic queue, with the reason for each, and leaves the choice to a person.

- `recala-article-signoff`: Writes one article from a chosen topic and brings it to the point where a named person reviews and signs it.

- `recala-apply-revision-notes`: Applies a client's revision notes with the AI edit, keeps only the changes that are right and sends the article back for review.

- `recala-schedule-approved`: Schedules articles a person already approved, at times you agree, after checking that each one is ready.

- `recala-connect-search-console`: Connects Search Console without OAuth: the owner adds Recala's service account, then the connection is checked.

- `recala-weekly-authority-report`: Writes a read-only weekly report: articles published and scheduled, topics waiting and articles left in the plan, each number traced to its command.

The install includes the shared CLI contract. Read the task’s instructions before acting, and follow the [confirmation rules](https://recala.co/developers/agents/#guarded).

## Update after installing a newer CLI

Existing skill files are preserved unless you pass --force. Review local customizations before replacing them.

```
recala skills install --dir .agents/skills --force
```

For a different agent, use its skills directory with --dir. This copies local instructions; it does not run the task or grant access.
