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

# Assistant skill

> Install Sovara guidance for Codex and Claude Code.

The Sovara skill teaches coding assistants how to set up an agent repository,
record and inspect runs, rerun LLM steps, annotate examples, and manage
lessons. Its **Repository Setup** workflow is the source of truth used by the
guided launcher.

## Guided repository setup

Run the zero-option launcher from the repository that contains the agent:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
cd agent-dir
sovara setup
```

The CLI:

1. detects Codex and Claude Code;
2. asks which assistant to use when both are installed;
3. globally installs or refreshes the skill for the selected assistant; and
4. launches that assistant in the current directory with the setup prompt.

The assistant then inspects the repository, installs the matching SDK, adds a
project-owned run and useful trace boundaries, and verifies a representative
run. It asks before a paid provider call and finishes with an explanation and
exact next command.

`sovara setup` accepts no options. Run it from the directory you want the
assistant to modify.

## Install the skill without launching setup

Use `install-skill` for manual, multi-target, or project-local installation:

| Target                | Command                                |
| --------------------- | -------------------------------------- |
| Codex and Claude Code | `sovara install-skill --target both`   |
| Codex only            | `sovara install-skill --target codex`  |
| Claude Code only      | `sovara install-skill --target claude` |

By default, the skill is installed globally. For a project-local install:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
sovara install-skill \
  --target codex \
  --level project \
  --project-dir /path/to/project
```

## Useful prompts after setup

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Use the Sovara CLI to inspect why the latest run failed.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Find the LLM step that produced the wrong answer and rerun it with a lower temperature.
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Queue this run for annotation and create a lesson only if the failure is reusable.
```

## Refresh the skill

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
sovara install-skill --target both
```