Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add frane/vibesurfer --skill vs-cligit clone --depth 1 https://github.com/frane/vibesurferWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/frane/vibesurfer/vs-cli)<a href="https://agentmods.dev/skills/frane/vibesurfer/vs-cli"><img src="https://agentmods.dev/badge/skills/frane/vibesurfer/vs-cli/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/frane/vibesurfer/vs-cli"><img src="https://agentmods.dev/badge/skills/frane/vibesurfer/vs-cli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 3 findings, up to medium
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- medium MCP Rug Pull · line 10 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
- medium Rogue Agent · line 39 Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
- medium Rogue Agent · line 135 Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00081 | $0.06650 |
| Opus 5.5 | $0.00032 | $0.02660 |
| Sonnet 5.5 | $0.00016 | $0.01330 |
| Haiku 4.5 | $0.00008 | $0.00665 |
Grade A, and why
vibesurfer scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 25d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
- One-shot HTTP fetches with no DOM (use `curl`). Copies of this mod
1 near-identical copy found in the catalogue:
- vibesurfer — 100% identical, 0 lines differ
How it starts
The opening of the file, as written. The whole thing — 235 lines — stays where its author put it; the contents beside it link to each section on GitHub.
vibesurfer (binary: vs)
vs is a stateless CLI that talks to a daemon (vs serve, auto-spawned on first call) over a Unix socket. Not installed? npx vibesurfer <args> runs the same binary (downloaded and cached on first use); vs skill install wires it into every detected agent. The daemon owns one long-lived browser engine on the OS main thread and a SQLite store at ~/.vibesurfer/state.db. Every primitive writes one audit row before returning — there's no opt-out, no untracked operation.
Short forms are the default in agent contexts
Every primitive has a short alias. Long forms exist for human-readable documentation; agent invocations should use the shorter form to save tokens. vs o https://... is the canonical shape for vs open https://..., not the other way around. The 19-primitive tables below lead with the short form and show the long form in parens; both work identically.
Frequent flags also have short forms: -S (--session), -j (--json), -F (--full), -s (--since), -n (--limit), -P (--page). The --token flag stays verbose because it's never typed by hand — you paste it from the previous read.
Use this tool when
- You need to drive a real browser to read or interact with a web app (login, scrape behind auth, click through SPA state).
- You need stable refs across snapshots so you can plan a multi-step interaction without scraping coordinates.
- You want persistent auth (cookies + storage) that survives across sessions, encrypted at rest.
- You want every action audited automatically — for replay, debugging, or compliance.
Don't use this tool for
- One-shot HTTP fetches with no DOM (use
curl). - Anything where you'd be parsing the rendered HTML by string matching —
vs_viewalready gives you a typed accessibility tree with stable refs. - Headless screenshots of fixed URLs with no interaction (overkill — though you can; see
vs capture).
The 26 primitives
Wire form is vs_<name> (over the socket); CLI subcommand is <name> with hyphens. Each call returns a state envelope (@<token> success, ! CODE error, ? warning lines before the envelope).
What ships with it
40 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- build.rs 1.7 KB
- Cargo.toml 2.1 KB
- README.md 20 KB
- src/active_session.rs 2.3 KB
- src/caller.rs 7.3 KB
- src/client.rs 5.1 KB
- src/commands/dispatch.rs 25 KB
- src/commands/mod.rs 40 KB
- src/commands/render.rs 1.5 KB
- src/flow.rs 5.8 KB
- src/lib.rs 752 B
- src/main.rs 3.4 KB
- src/mcp/content.rs 4.4 KB
- src/mcp/live-panel.html 2.8 KB
- src/mcp/mod.rs 14 KB
- src/mcp/tools.rs 34 KB
- src/paths.rs 2.2 KB
- src/serve.rs 36 KB
- src/skill_install.rs 22 KB
- src/spawn.rs 2.3 KB
- tests/alias_parity.rs 7.2 KB
- tests/auto_spawn.rs 4.6 KB
- tests/e2e_cli.rs 12 KB
- tests/m6_smoke.rs 1.2 KB
- tests/m6/act.rs 21 KB
- tests/m6/auth.rs 17 KB
- tests/m6/challenge.rs 3.3 KB
- tests/m6/download.rs 5.7 KB
- tests/m6/extract.rs 3.8 KB
- tests/m6/fingerprint.rs 2.0 KB
- tests/m6/helpers.rs 2.7 KB
- tests/m6/inspect.rs 12 KB
- tests/m6/lifecycle.rs 17 KB
- tests/m6/main.rs 1.1 KB
- tests/m6/memory.rs 6.3 KB
- tests/m6/visual.rs 6.1 KB
- tests/m6/wait.rs 6.0 KB
- tests/m6/webentry.rs 19 KB
- tests/support/fixture_server.rs 10 KB
- tests/support/mod.rs 11 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 25d ago Changed ff5da73499c2
- 27d ago Changed d6648ff675c9
- 1mo ago Changed acb5d7594aea
- 1mo ago Changed · +39 lines 00827b900c94
- 1mo ago First seen · 196 lines · 81 tokens per session scan A ba363196d9c5
vibesurfer is a skill published in the GitHub repository frane/vibesurfer (16 stars, last pushed 26d ago), licensed Apache-2.0. It adds 81 tokens to every session and 6,650 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
checking-a-page
Check that a web page you wrote or changed actually works, by opening it in a browser and driving every control on it. Use after creating or editing an HTML page, or the JavaScript or CSS that a page loads.
kane-cli
End-to-end (E2E) test generation and execution with KaneCLI. Generate tests from a PRD, specification, or user-provided description via the assurance commands (use-cases, acceptance criteria, scenarios, runnable test.md tests; never write test cases by hand). Execute them on desktop web (Chrome, the default), Android…
opencli-autofix
Automatically fix broken OpenCLI adapters when commands fail. Load this skill when an opencli command fails — it guides you through collecting a trace artifact, patching the adapter, retrying, and filing an upstream GitHub issue after a verified fix. Works with any AI agent.
opencli-adapter-author
Build or improve an OpenCLI JS adapter using observed site behavior, existing adapters and browser API evidence. For ad-hoc browser interaction, see opencli-browser.
opencli-browser
Drive Chrome with OpenCLI to inspect pages, interact with logged-in sites, capture API evidence, and manage native tabs, groups and windows. For reusable adapters, see opencli-adapter-author.
webcmd-browser
Use when a live browser task requires Playwright interaction, authenticated handoff, visible UI verification, or ad-hoc page inspection.