RillDocs
Skip to guide

Reference and help

Install the Rill skill.

A skill gives your coding agent the instructions for recording with Rill. Install it in the project where you want to use it.

Before you install

If this is your first recording, start with the agent quickstart. Its prompt asks your agent to read the skill and check setup for you. Use this page when you want to install the file yourself.

Your agent needs shell access, Node.js 22 or newer, Chrome or Chromium and browser tools that can connect to an existing browser. Check the environment where its commands run; it may differ from your desktop.

Install for your agent

Choose your agent and run the commands from your project folder. If the skill already exists, compare it with the current version and keep your customizations.

Install skill for Codex
mkdir -p .agents/skills/rill
if [ -e .agents/skills/rill/SKILL.md ]; then
  echo "A Rill skill already exists. Review it before updating."
else
  curl --fail --show-error --location https://userill.dev/skill.md -o .agents/skills/rill/SKILL.md
fi

These shell commands are for macOS, Linux or a compatible shell. You can also download skill.md and save it as .agents/skills/rill/SKILL.md in your project.

For other agents, use their supported project skill directory.

The current skill is always at userill.dev/skill.md. Installation applies to this project. It does not authorize automatic recording of future sessions.

Check the CLI

Run rill --version first. Reuse a compatible installation. If it is missing, follow the skill’s connectivity checks before installing; do not keep retrying when the environment cannot reach npm or Rill.

Install or update the CLI
npm install --global @runalabs/rill-cli@latest
rill --human doctor

Follow any failed check’s recovery instructions. Use rill whoami to see the current account. No Rill sign-in is needed for your first anonymous agent recording. See authentication for connected and headless environments.

Check the skill loaded

Ask your agent to read the file now. Automatic skill discovery may need a new session.

Check the installed skill
Read the installed Rill skill in this project. Explain how you will connect to Rill’s browser, record one flow, and verify the playable result before you begin.

Expect it to check setup, attach to the returned browser address (cdpUrl), stop the same recording and wait for ready. It should report what was observed, what was not checked and when an anonymous recording expires. Continue with the quickstart prompt.

Keep it up to date

Run this from your project to compare your installed skill with the published version. Use --file <path> to check a copy installed elsewhere.

Check for a skill update
rill --human skill check

The CLI also checks project copies in rill doctor and rill record start. Older copies may have no version number. If your CLI lacks the check command, update the CLI or compare your copy with the published skill directly.

When an update is available, give this prompt to your agent in the project where the skill is installed.

Update the installed skill
Update the installed Rill SKILL.md in this project from https://userill.dev/skill.md. Compare the files first, merge the changes while keeping my project customizations, then read the refreshed file.