Skills

Replay User Flows

Turn a user journey you just clicked through into a saved regression check that re-runs...

Install

npx skills add reticlehq/reticle --skill replay-user-flows -g -a claude-code -y
Repository
reticlehq/reticle1.3k
Category
Testing
Updated
3d ago
License
Apache-2.0
Context cost
Lightabout 1,338 tokens
Runs scripts
No, instructions only

What it does

Turn a user journey you just clicked through into a saved regression check that re-runs deterministically, with no model in the loop and no test code to write. Use when you have driven the same flow twice, when the user wants regression coverage without a Playwright suite, when a refactor needs proving against every existing journey, or when re-verifying by hand is costing a full drive every time.

Record a journey once, re-verify it forever

Exploring an app to find a journey is the expensive part, and re-driving it with a model pays that cost again on every change. Reticle flows pay it once: the journey is saved with semantic anchors and replayed deterministically afterwards.

Needs Reticle wired in the project. Not set up? Follow the reticle skill: it installs Reticle, asks the user before init changes the app's files, and proves one flow.

Record

You do not have to ask. A drive is saved as a flow automatically when the session ends, written to .reticle/flows/. Commit it: any agent on the repo can then replay it.

What decides whether it is worth committing is how you drove it. A step keeps a consequence only when you declared one, so drive the golden path like this:

reticle_act_and_wait({ sessionId, ref, action: "click", until: { kind: "signal", name: "task:created" } })

That step replays as a test. A bare reticle_act saves a click with nothing to prove, and replays green through any regression.

To name a flow deliberately rather than take the automatic one, reticle_record and reticle_flow_save do it through reticle_run { tool, args }. Neither is advertised, and neither needs to be: reticle_run is on the default surface and dispatches to any registered tool by name. RETICLE_ADVERTISE_ALL_TOOLS=1 advertises them outright, under older, unmerged tool names. Do not set it for an agent: the calls in this skill use the default names.

Annotate the business outcome, not just the clicks, so a replay proves the journey achieved something. Extended surface, like the two above:

Read the whole SKILL.md on GitHub

More in Testing