agentleFS
roundpilotroundpilot/superpowers-antigravity/skills/browser-testing/SKILL.md

browser-testing

Skill80 starsChanged 7 days agoMITView on GitHub

Use when completing frontend or UI work that needs visual verification, before claiming the UI is correct

11 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 11 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Never claim UI work is correct without visual evidence.

    line 10
  2. Distinctive:

    When to use: After implementing any UI or frontend changes, before claiming the work is correct.

    line 14
  3. Distinctive:

    Evidence classification in artifacts: Use GitHub-style alerts:

    line 43

“Common” is measured: kept by at least 6 in 10 of the 11 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

Browser Testing

Overview

Never claim UI work is correct without visual evidence. Browser automation makes verification fast and produces artifacts the user can review.

Core principle: Evidence before assertions. Screenshots and DOM inspection prove correctness; text descriptions don't.

When to use: After implementing any UI or frontend changes, before claiming the work is correct.

The Process

  1. Navigate to the page under test using browser automation
  2. Screenshot the current state — embed in walkthrough artifact
  3. Inspect DOM to verify structure matches expectations (correct elements, classes, attributes)
  4. Record a walkthrough of the key user flow (if multi-step interaction)
  5. Embed evidence in a walkthrough artifact with screenshots and recordings

Quick Reference

What to verifyToolOutput
Visual appearanceScreenshot![description](/path/to/screenshot.png)
DOM structureInspect elementsElement presence, attributes, classes
User flowRecordingEmbedded video in artifact
Responsive layoutScreenshot at viewportMultiple screenshots at different widths

Common Mistakes

MistakeFix
Not waiting for page load before screenshotWait for key elements to be visible
Checking only one viewport sizeTest at desktop (1280px) and mobile (375px) minimum
Visual-only verification (no DOM check)Always inspect DOM structure — visual can hide broken markup
Forgetting to embed evidenceEvery claim needs a screenshot or recording in the artifact
Saying "looks correct" without proofTake the screenshot. Embed it. Let the user judge.

Evidence classification in artifacts: Use GitHub-style alerts:

  • > [!TIP] for passing checks
  • > [!CAUTION] for failing checks
  • > [!NOTE] for observations that need human judgment

Integration

  • superpowers:verification-before-completion — browser-testing is specialized verification for UI work
  • superpowers:test-driven-development — browser tests complement unit tests, they don't replace them

Slash Command

Recommend /browser to the user when UI verification is needed. /browser is the exclusive entry point to the built-in sandboxed browser subagent — it is not available via invoke_subagent and does not add browser tools to the calling agent's session. The subagent performs the testing (navigation, screenshots, recordings) and returns evidence for the walkthrough artifact.

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.