Agent skill

Browser Record

by ruvnet in ruvnet/ruflo

Open a named, traced browser session into an RVF cognitive container with a ruvector trajectory recording every action

MITAuto-check: notesAgent Workflows

Install Browser Record

skills CLI
$ npx skills add ruvnet/ruflo --skill browser-record -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ruvnet/ruflo browser-record --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ruvnet/ruflo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ruflo-browser/skills/browser-record .claude/skills/browser-record && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
browser-record
GitHub stars
74k
Token cost
~735 tokens
SKILL.md length
216 words
Files
1
Skills in repo
264
Repo updated
First seen
Licence
MIT

At a glance

Open a named, traced browser session into an RVF cognitive container with a ruvector trajectory recording every action

  • Works in 6 steps: Allocate session id and RVF container → Open the browser via… → Snapshot the initial state:… → …
  • Agent Workflows work in your project
  • SKILL.md covers When to use, Steps and Caveats
  • Calls npx

What it does

Browser Record is an agent skill from ruvnet/ruflo. Open a named, traced browser session into an RVF cognitive container with a ruvector trajectory recording every action

Its SKILL.md is about 740 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 Agent Workflows. 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.

When your agent uses it

  • Agent Workflows work in your project

Example prompts

  • “/browser-record”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): mcp__plugin_ruflo-core_ruflo__browser_open, mcp__plugin_ruflo-core_ruflo__browser_close, mcp__plugin_ruflo-core_ruflo__browser_session-list, mcp__plugin_ruflo-core_ruflo__browser_screenshot, mcp__plugin_ruflo-core_ruflo__browser_snapshot, mcp__plugin_ruflo-core_ruflo__browser_wait, mcp__plugin_ruflo-core_ruflo__aidefence_has_pii, mcp__plugin_ruflo-core_ruflo__aidefence_scan, Bash, Read, Write

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Allocate session id and RVF container
  2. Open the browser via mcpplugin_ruflo-core_ruflobrowser_open with the URL.
  3. Snapshot the initial state: browser_snapshot for the accessibility tree, browser_screenshot for a baseline image.
  4. For each interaction, record a trajectory step before and after
  5. End cleanly
  6. Index in AgentDB under browser-sessions

What it can do on your machine

Read from SKILL.md and the folder at commit de590e1. 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_session-list
    • mcp__plugin_ruflo-core_ruflo__browser_screenshot
    • mcp__plugin_ruflo-core_ruflo__browser_snapshot
    • mcp__plugin_ruflo-core_ruflo__browser_wait
    • mcp__plugin_ruflo-core_ruflo__aidefence_has_pii
    • mcp__plugin_ruflo-core_ruflo__aidefence_scan
    • Bash
    • Read

    …and 1 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 Record loads about 735 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 216 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~735

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
    allowed-tools: mcp__plugin_ruflo-core_ruflo__browser_open, mcp__plugin_ruflo-core_ruflo__browser_close, mcp__plugin

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.

SKILL.md

The full file from ruvnet/ruflo at commit de590e1, republished under its MIT licence (© ruvnet). 216 words, ~735 tokens.

Download SKILL.mdSave it as .claude/skills/browser-record/SKILL.md (or your agent's skills folder).
name
browser-record
description
Open a named, traced browser session into an RVF cognitive container with a ruvector trajectory recording every action
allowed-tools
mcp__plugin_ruflo-core_ruflo__browser_open, mcp__plugin_ruflo-core_ruflo__browser_close, mcp__plugin_ruflo-core_ruflo__browser_session-list, mcp__plugin_ruflo-core_ruflo__browser_screenshot, mcp__plugin_ruflo-core_ruflo__browser_snapshot, mcp__plugin_ruflo-core_ruflo__browser_wait, mcp__plugin_ruflo-core_ruflo__aidefence_has_pii, mcp__plugin_ruflo-core_ruflo__aidefence_scan, Bash, Read, Write
argument-hint
<url-or-task> [--with-dom] [--viewport WxH]

Browser Record

Primitive on which every other browser skill composes. Opens a named browser session, allocates an RVF container for it, and binds every action to a ruvector trajectory step. You do not run a browser session in this plugin without invoking this skill (or one that wraps it).

When to use

  • Starting any browser interaction that is not a one-off throwaway probe.
  • Exploring a site interactively while preserving the trace for later replay or analysis.
  • Establishing a reusable session that downstream skills (browser-extract, browser-form-fill, browser-test) will compose.

Steps

  1. Allocate session id and RVF container:
    bash
    SID="$(date +%Y%m%d-%H%M%S)-${TASK_SLUG:-record}"
    npx -y ruvector@0.2.25 rvf create "$SID.rvf" --dimension 384
    npx -y ruvector@0.2.25 hooks trajectory-begin --session-id "$SID" --task "$1"
  2. Open the browser via mcp__plugin_ruflo-core_ruflo__browser_open with the URL.
  3. Snapshot the initial state: browser_snapshot for the accessibility tree, browser_screenshot for a baseline image.
  4. For each interaction, record a trajectory step before and after:
    bash
    npx -y ruvector@0.2.25 hooks trajectory-step \
      --session-id "$SID" --action click --args '{"selector":"#login"}' --result ok
  5. End cleanly:
    bash
    npx -y ruvector@0.2.25 hooks trajectory-end --session-id "$SID" --verdict pass
    npx -y ruvector@0.2.25 rvf compact "$SID.rvf"
  6. Index in AgentDB under browser-sessions:
    bash
    npx -y @claude-flow/cli@latest memory store --namespace browser-sessions \
      --key "$SID" --value "{rvf_id:$SID,host:...,task:...,verdict:pass}"

Caveats

  • Until the browser_session_record MCP tool ships (ADR-0001 §7), this skill drives the lifecycle from inside its own bash steps. Do not call mcp__plugin_ruflo-core_ruflo__browser_open directly without these wrappers.
  • The session id format is fixed: <YYYYMMDD-HHMMSS>-<task-slug>. Downstream /ruflo-browser ls parses this.
  • --with-dom is expensive (full HTML dump per nav). Off by default.
  • AIDefence gates apply at extraction time, not at navigation time. browser-record is a primitive; redaction is the responsibility of skills that read content (browser-extract, browser-test).

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/ruflo-browser/skills/browser-record of ruvnet/ruflo.

Open the folder on GitHubat commit de590e1

Compare with similar skills

Browser Record 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.

Browser Record compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Browser Record this skillruvnet/ruflo74k—~735Automated safety check: NotesMIT
MCP Server Builderanthropics/skills180k62 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official37k11 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k34 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers296k2 repos~5.1kAutomated safety check: PassMIT
Claude Code Agent Developmentanthropics/claude-plugins-official37k8 repos~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 62 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    37k GitHub starsUsed in 11 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 34 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    296k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    37k GitHub starsUsed in 8 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    794 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed

More from ruvnet/ruflo

All 264 skills in this repo
  • Stores, searches, and retrieves successful patterns with HNSW-indexed semantic search so agents can reuse past solutions instead of relearning them.

    74k GitHub starsUsed in 2 repos~830 tokens
    Auto-check passed
  • Runs claude-flow CLI security scans for input validation, path traversal, SQL injection, XSS, hardcoded secrets and known CVEs, and writes an audit report.

    74k GitHub starsUsed in 2 repos~823 tokens
    Auto-check passed
  • Applies the SPARC method (specification, pseudocode, architecture, refinement, completion) with 17 specialized modes and multi-agent orchestration, from research to deployment.

    74k GitHub starsUsed in 2 repos~829 tokens
    Auto-check passed
  • Coordinates a hierarchical swarm of specialized agents through the claude-flow CLI for work that spans several files or modules at once.

    74k GitHub starsUsed in 2 repos~779 tokens
    Auto-check passed
  • Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.

    74k GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Agent Coordination

    ruvnet/ruflo

    Reference for spawning, listing, monitoring and stopping agents with claude-flow commands, with agent type families, routing codes and coordination tips.

    74k GitHub starsUsed in 2 repos~519 tokens
    Auto-check passed

Categories

Questions about Browser Record

What does Browser Record do?

Open a named, traced browser session into an RVF cognitive container with a ruvector trajectory recording every action. Browser Record is an agent skill from ruvnet/ruflo.

When should I use Browser Record?

Browser Record fits situations like: agent Workflows work in your project.

How do I install Browser Record in Claude Code?

Run `npx skills add ruvnet/ruflo --skill browser-record -a claude-code`. Or copy the skill folder (plugins/ruflo-browser/skills/browser-record in ruvnet/ruflo) into .claude/skills/browser-record in your project. Claude Code loads it when a task matches its description.

How do I install Browser Record in Codex?

Run `npx skills add ruvnet/ruflo --skill browser-record -a codex`. Or copy the skill folder (plugins/ruflo-browser/skills/browser-record in ruvnet/ruflo) into .agents/skills/browser-record in your project. Codex loads it when a task matches its description.

Can I use Browser Record 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-record -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-record, .gemini/skills/browser-record, .github/skills/browser-record and .opencode/skills/browser-record in your project.

What does Browser Record need to run?

Going by SKILL.md and its folder, Browser Record 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_session-list, mcp__plugin_ruflo-core_ruflo__browser_screenshot, mcp__plugin_ruflo-core_ruflo__browser_snapshot, mcp__plugin_ruflo-core_ruflo__browser_wait, mcp__plugin_ruflo-core_ruflo__aidefence_has_pii, mcp__plugin_ruflo-core_ruflo__aidefence_scan, Bash, Read, Write.

Does Browser Record 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 Record 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 Record use?

Browser Record 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 Record use?

About 735 tokens (SKILL.md is roughly 2.9k 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 Record?

Skills that share tags, products or a category with Browser Record: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 37k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 296k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Browser Record?

ruvnet (a GitHub user) maintains it in ruvnet/ruflo, which has 74,012 GitHub stars. The repository holds 264 skills in this directory. The repository was last updated on October 7, 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.