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.
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
fiThese 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.
mkdir -p .claude/skills/rill
if [ -e .claude/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 .claude/skills/rill/SKILL.md
fiThese shell commands are for macOS, Linux or a compatible shell. You can also download skill.md and save it as .claude/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.
npm install --global @runalabs/rill-cli@latest
rill --human doctorFollow 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.
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.
rill --human skill checkThe 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 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.