# Install the skill — Rill Docs

Source: https://userill.dev/docs/install-skill

For coding agents

# Install the Rill skill

Your agent runs the tests. Rill records what happened.

## Start with the quickstart

The [agent quickstart](https://userill.dev/docs/agent-quickstart) installs the skill and starts your first recording in one conversation. Use the instructions below for manual setup.

## Prerequisites

Use a coding agent inside your project on macOS or Linux, with shell access, Node.js 22 or newer, and Chrome or Chromium.

## Install for this project

The canonical skill is [userill.dev/skill.md](https://userill.dev/skill.md). Choose the directory your agent reads: `.agents/skills/rill` for Codex, or `.claude/skills/rill` for Claude Code. For other agents, use their documented project skill directory. Run one installation method and preserve any existing customized skill.

```
mkdir -p .agents/skills/rill
curl --fail --show-error --location https://userill.dev/skill.md -o .agents/skills/rill/SKILL.md
```

For Claude Code, substitute `.claude` for `.agents`. Ask your agent to read the installed file immediately; automatic skill discovery may require a new session. Installation applies to this project and does not authorize recording future sessions automatically.

## Install the CLI and check setup

```
npm install --global @runalabs/rill-cli@latest
rill doctor
```

Follow failed-check recovery instructions. No Rill sign-in is needed for your first anonymous local recording. Existing account credentials continue to work.

## Keep the skill up to date

Updating the CLI does not update your installed skill. After a relevant CLI or recording-workflow change, fetch the current [skill file](https://userill.dev/skill.md), compare it with your project copy, preserve any customizations, and ask your agent to read the refreshed file.

## Verify the skill loaded

Ask: “Read the installed Rill skill. Explain how you will attach to Rill’s browser, record this project, and verify the result.” Expect a plan that uses remote encoding without installing FFmpeg, attaches to the returned `cdpUrl`, stops the recording, waits for `ready`, inspects the link, and reports anonymous expiry. Then use the [quickstart prompt](https://userill.dev/docs/agent-quickstart).