Skip to main content
SKILL.md is one short document written for a coding agent. Its home is this docs site:
Paste that URL into the agent and say “read this and set up Reticle”. It is the canonical file with Agent Skill frontmatter (name, description) added. The repository copy, https://raw.githubusercontent.com/reticlehq/reticle/main/SKILL.md, has the same body without the frontmatter, and a test fails if the two ever differ. To install it as a skill instead, run npx skills add reticlehq/reticle --skill reticle. It installs one file with the same body. Without --skill, the command lists the task skills too. The same file ships inside the package, so an agent with no network can read it from disk:
The docs/ folder beside it is a copy of this site.

​
What it tells the agent

It is the critical path and nothing else. Read SKILL.md itself to get the rules exactly right; in short:
  • Three steps, in order: install once per machine, wire the app once per project, then prove one flow.
  • Install: if the reticle_* tools are not visible, hand the user the installer line and stop.
  • Wire only with consent. reticle_session { action: "list" } changes no file. On an unwired project it asks before init. When an app is running, it also names the zero-install lease, which checks the app with nothing installed. init changes files, so run it only when the user agrees. A request to set up Reticle is that agreement. A dev server that was already running must be restarted once.
  • Done means a verdict. A session listed means the SDK reached the page. Setup is finished when the first run returns a verdict.
  • Only verified: "yes" is a pass. unknown means Reticle could not tell. Never weaken a check to make it pass.
  • Replay before you drive. reticle_verify { action: "change" } or { action: "flows" } re-verifies saved journeys in one call.
  • Report problems with Reticle through reticle_session { action: "feedback" }, or reticle feedback --agent from the shell.

​
Do you need it?

Often not. The installer registers the MCP server with your agents, and reticle init writes agent rule files and a /reticle command for Claude Code. The SKILL file is for agents init cannot configure, for a from-scratch install, or for an agent you want to hold the rules in context.

Agentic install

What reticle init does, with real output.

Agent cheat sheet

The one-screen version of the drive loop.
Last modified on October 25, 2026