Install the "browser-replay" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-browser/skills/browser-replay into .claude/skills/browser-replay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser-replay", then confirm the skill loads.
Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
skills CLI
$ npx skills add ruvnet/ruflo --skill browser-replay -a codex
Project install goes to .agents/skills/; add -g for ~/.codex/skills/.
Install the "browser-replay" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-browser/skills/browser-replay into .agents/skills/browser-replay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser-replay", then confirm the skill loads.
Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add ruvnet/ruflo --skill browser-replay -a cursor
Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.
Install the "browser-replay" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-browser/skills/browser-replay into .cursor/skills/browser-replay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser-replay", then confirm the skill loads.
Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
skills CLI
$ npx skills add ruvnet/ruflo --skill browser-replay -a gemini-cli
Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.
Install the "browser-replay" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-browser/skills/browser-replay into .gemini/skills/browser-replay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser-replay", then confirm the skill loads.
Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
GitHub CLI
$ gh skill install ruvnet/ruflo browser-replay
Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
skills CLI
$ npx skills add ruvnet/ruflo --skill browser-replay -a github-copilot
Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.
Install the "browser-replay" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-browser/skills/browser-replay into .github/skills/browser-replay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser-replay", then confirm the skill loads.
GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skills CLI
$ npx skills add ruvnet/ruflo --skill browser-replay -a opencode
OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
Install the "browser-replay" agent skill from https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-browser/skills/browser-replay into .opencode/skills/browser-replay/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "browser-replay", then confirm the skill loads.
OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
Skill name
browser-replay
GitHub stars
74k
Token cost
~856 tokens
SKILL.md length
299 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT
At a glance
Replay a recorded session trajectory against the same URL or a mutated variant; uses browser-selectors embedding similarity to recover from DOM drift
Works in 7 steps: Locate the source session → Load the trajectory → Open a fresh browser via… → …
Tasks that involve Embeddings
SKILL.md covers When to use, Steps and Caveats
Calls npx
What it does
Browser Replay is an agent skill from ruvnet/ruflo. Replay a recorded session trajectory against the same URL or a mutated variant; uses browser-selectors embedding similarity to recover from DOM drift
Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in AI & LLM Engineering, covering Embeddings. The repository describes itself as: 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory…. The licence is MIT.
7 steps, taken from the first numbered list in SKILL.md.
1Locate the source session
2Load the trajectory
3Open a fresh browser via mcpplugin_ruflo-core_ruflobrowser_open (target URL = original or --url override).
4For each trajectory step, dispatch the matching MCP tool (browser_click, browser_fill, browser_eval, etc.) with the recorded args.
5On selector miss, do not fail immediately — query the browser-selectors namespace for an embedding-similar selector for the same : and…
6Record a new trajectory for the replay run (allocate a fresh RVF container, lineage-tracked via rvf derive).
7Verdict: tally matched-step / total-step ratio. Default tolerance threshold is 0.85 (configurable via --tolerance). Verdict goes into…
What it can do on your machine
Read from SKILL.md and the folder at commit 58e0ae7. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
mcp__plugin_ruflo-core_ruflo__browser_open
mcp__plugin_ruflo-core_ruflo__browser_close
mcp__plugin_ruflo-core_ruflo__browser_click
mcp__plugin_ruflo-core_ruflo__browser_fill
mcp__plugin_ruflo-core_ruflo__browser_type
mcp__plugin_ruflo-core_ruflo__browser_press
mcp__plugin_ruflo-core_ruflo__browser_select
mcp__plugin_ruflo-core_ruflo__browser_check
mcp__plugin_ruflo-core_ruflo__browser_uncheck
mcp__plugin_ruflo-core_ruflo__browser_hover
…and 6 more on the same allowed-tools line.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Browser Replay loads about 856 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 299 words of instructions outside code blocks.
Always· name and description, kept in context so the agent knows when to use it
~41
When it runs· the whole SKILL.md, loaded when a task matches
~856
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
Re-drive a recorded session trajectory. Used for regression testing, deterministic re-runs, and as the verification path that browser-record plus browser-selectors actually produces something replayable.
This skill is the load-bearing assumption of the v0.2.0 architecture. ADR-0001 Verification §4 requires ≥80% replay success across 10 distinct sites of varying drift profiles before the proposal moves from Proposed → Accepted. If you find replay unreliable, capture the failure modes in findings.md and report them up the ADR.
When to use
Regression-testing a UI flow after a deploy.
Reproducing a bug captured in a prior session.
Comparing two runs of the same flow for browser-screenshot-diff.
Forking a session (/ruflo-browser fork) and replaying the parent before mutating.
Steps
Locate the source session:bash
npx -y ruvector@0.2.25 rvf status <session-id>.rvf
Load the trajectory:bash
Read .../trajectory.ndjson
Each line is {ts, action, args, selector, result}.
Open a fresh browser via mcp__plugin_ruflo-core_ruflo__browser_open (target URL = original or --url override).
For each trajectory step, dispatch the matching MCP tool (browser_click, browser_fill, browser_eval, etc.) with the recorded args.
On selector miss, do not fail immediately — query the browser-selectors namespace for an embedding-similar selector for the same <host>:<intent> and retry once:bash
Record a new trajectory for the replay run (allocate a fresh RVF container, lineage-tracked via rvf derive).
Verdict: tally matched-step / total-step ratio. Default tolerance threshold is 0.85 (configurable via --tolerance). Verdict goes into findings.md.
Caveats
Browserbase explicitly does not offer replay (rrweb session replay was deprecated). We're betting on selector-embedding recovery; expect noise on heavily drifted sites.
Network nondeterminism (timing, content variation) can produce false-fail verdicts. Use --mutate to inject expected variation or pin to a fixture.
For visual diff, chain into browser-screenshot-diff against the parent session id.
If selector recovery requires more than one retry per step, log it. That's the signal that the site needs a re-record, not a replay.
Browser Replay next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
Shows how to store documents and embeddings in Chroma, query them by similarity with metadata filters, and persist them to disk for RAG and semantic search projects.
Chooses the right serving container and current image URI for deploying a Hugging Face model to a SageMaker endpoint, preferring Hugging Face images over generic ones.
Explains OpenAI's CLIP model for zero-shot image classification, image-text similarity, semantic image search and content moderation, with install steps and code patterns.
Routes a sentence-transformers training task to the right model type and required reference docs and example scripts, covering bi-encoders, rerankers, sparse and multi-vector models.
Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.
Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.
Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.
Replay a recorded session trajectory against the same URL or a mutated variant; uses browser-selectors embedding similarity to recover from DOM drift. Browser Replay is an agent skill from ruvnet/ruflo.
When should I use Browser Replay?
Browser Replay fits situations like: tasks that involve Embeddings.
How do I install Browser Replay in Claude Code?
Run `npx skills add ruvnet/ruflo --skill browser-replay -a claude-code`. Or copy the skill folder (plugins/ruflo-browser/skills/browser-replay in ruvnet/ruflo) into .claude/skills/browser-replay in your project. Claude Code loads it when a task matches its description.
How do I install Browser Replay in Codex?
Run `npx skills add ruvnet/ruflo --skill browser-replay -a codex`. Or copy the skill folder (plugins/ruflo-browser/skills/browser-replay in ruvnet/ruflo) into .agents/skills/browser-replay in your project. Codex loads it when a task matches its description.
Can I use Browser Replay in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ruvnet/ruflo --skill browser-replay -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/browser-replay, .gemini/skills/browser-replay, .github/skills/browser-replay and .opencode/skills/browser-replay in your project.
What does Browser Replay need to run?
Going by SKILL.md and its folder, Browser Replay needs the command-line tools its instructions call (npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: mcp__plugin_ruflo-core_ruflo__browser_open, mcp__plugin_ruflo-core_ruflo__browser_close, mcp__plugin_ruflo-core_ruflo__browser_click, mcp__plugin_ruflo-core_ruflo__browser_fill, mcp__plugin_ruflo-core_ruflo__browser_type, mcp__plugin_ruflo-core_ruflo__browser_press, mcp__plugin_ruflo-core_ruflo__browser_select, mcp__plugin_ruflo-core_ruflo__browser_check, mcp__plugin_ruflo-core_ruflo__browser_uncheck, mcp__plugin_ruflo-core_ruflo__browser_hover, mcp__plugin_ruflo-core_ruflo__browser_wait, mcp__plugin_ruflo-core_ruflo__browser_screenshot, mcp__plugin_ruflo-core_ruflo__browser_snapshot, mcp__plugin_ruflo-core_ruflo__browser_eval, Bash, Read.
Does Browser Replay access the network?
SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Browser Replay safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Browser Replay use?
Browser Replay is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Browser Replay use?
About 856 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Browser Replay?
Skills that share tags, products or a category with Browser Replay: Chroma Vector Database (Orchestra-Research/AI-Research-SKILLs, 13k stars), SageMaker Serving Image Selection (huggingface/skills, 11k stars), Codebase Management (giancarloerra/SocratiCode, 3.3k stars) and CLIP Image-Text Matching (Orchestra-Research/AI-Research-SKILLs, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Browser Replay?
ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,159 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 9, 2026.
Source: ruvnet/ruflo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.
