
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:


