agentleFS
MelvynxMelvynx/ai-maxxing-skills/skills/dev-browser/SKILL.md

dev-browser

Skill32 starsChanged 23 days agoMITView on GitHub

Drive the user's dedicated Chrome AI window with the dev-browser CLI to open sites, click, fill forms, read pages, take screenshots and check a live app while signed in. Use when the user says browse, open a site, click, fill a form, screenshot, scrape, test my site, or check something on the web.

13 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use prd, web-design-guidelines and 1 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • GitHubSkill

    prd

    Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis.

    Also in 3 projects that use this

  • VercelSkill

    web-design-guidelines

    Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

    Also in 3 projects that use this

  • SentrySkill

    commit

    Create commit messages following Sentry conventions. Use when committing code changes, writing commit messages, or formatting git history. Follows conventional commits with Sentry-specific issue references.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 3 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Do every browser task in Chrome AI, the user's dedicated Chrome window (profile ~/.chrome-ai-profile, port 9333) where they are already …

    line 9
  2. Very specific:

    If chrome-ai or dev-browser is missing, stop and tell the user to run /setup-dev-browser.

    line 22
  3. Very specific:

    Write small scripts that do one thing and end by logging the state as JSON (url, title, what you found).

    line 25
  4. Very specific:

    Before clicking, read the page with await page.snapshotForAI() and target elements with page.getByRole, getByText or getByLabel.

    line 26
  5. Distinctive:

    If a site asks to sign in, stop and ask the user to sign in in the Chrome AI window, then continue.

    line 28
  6. Distinctive:

    Ask the user before any click that sends, publishes, pays, deletes or accepts terms.

    line 29
  7. Distinctive:

    When a script fails, the page stays where it was: reconnect, take a screenshot, log the url and title, then continue from there.

    line 31

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Do every browser task in Chrome AI, the user's dedicated Chrome window (profile ~/.chrome-ai-profile, port 9333) where they are already signed in to their tools. Start it first (it does nothing if it is already open), then connect to it on every run:

If you got this skill from a link instead of a local folder, install nothing else from the repo: download a file it links only when a step needs it, with curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/dev-browser/<path> -o <scratch>/<file> (for example references/api-reference.md), and read another skill it names only when you reach it, from https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/<skill-name>/SKILL.md.

chrome-ai start
dev-browser --connect http://127.0.0.1:9333 <<'JS'
const page = await browser.getPage("stripe-sales");
await page.goto("https://dashboard.stripe.com");
console.log(JSON.stringify({ title: await page.title(), url: page.url() }));
JS

If chrome-ai or dev-browser is missing, stop and tell the user to run /setup-dev-browser; never fall back to a standalone Playwright script or the user's own Chrome. If CHROME_AI_PORT is set, connect to that port instead of 9333 (chrome-ai url prints the address).

  • Give each task its own page name (browser.getPage("lumail-campaign")) so parallel agents never share a tab, reuse that name across runs to keep the page state, and close it with browser.closePage(name) when the task is done. Never close or navigate a tab you did not open.
  • Write small scripts that do one thing and end by logging the state as JSON (url, title, what you found). Scripts run in a sandbox, not Node: no require, fs, fetch or process.
  • Before clicking, read the page with await page.snapshotForAI() and target elements with page.getByRole, getByText or getByLabel. Open references/api-reference.md before using a method you are not sure exists.
  • Files only go to ~/.dev-browser/tmp/: pass a bare file name to saveScreenshot or writeFile and use the path it returns. Look at the screenshot before saying a page looks right.
  • If a site asks to sign in, stop and ask the user to sign in in the Chrome AI window, then continue; the session stays saved. Never type passwords, codes or card numbers, and never solve a captcha.
  • Ask the user before any click that sends, publishes, pays, deletes or accepts terms.
  • For a clean signed-out check (how a visitor sees the site), run without --connect and with --headless, and say so.
  • When a script fails, the page stays where it was: reconnect, take a screenshot, log the url and title, then continue from there.

Reply with what you saw or did, the final URL, and the screenshot path when it helps.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.