.claude/skills/browser-test/SKILL.md
Browser testing using Chrome DevTools MCP and Playwright for visual verification. Start dev server, navigate, screenshot, Lighthouse audit, console errors, network check. Use when: (1) verifying frontend changes, (2) accessibility auditing, (3) performance testing, (4) visual regression. Triggers: /browser-test, 'test in browser', 'visual test', 'lighthouse audit'.
npx skillsauth add alfredolopez80/multi-agent-ralph-loop browser-testInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Visual verification using Chrome DevTools MCP and Playwright.
/browser-test http://localhost:3000
/browser-test http://localhost:3000 --a11y
/browser-test http://localhost:3000 --perf
# Auto-detect package manager and start
npm run dev & # or yarn dev, bun dev
# Wait for server to be ready
Using Playwright MCP or Chrome DevTools:
.claude/quality-results/screenshots/Run via Chrome DevTools MCP:
Browser Test Report — http://localhost:3000
=============================================
Screenshot: .claude/quality-results/screenshots/2026-04-04-home.png
Console: 0 errors, 2 warnings
Lighthouse: Perf 94 | A11y 98 | BP 100 | SEO 92
Network: 23 requests, 0 failed, largest: 145KB
---------------------------------------------
RESULT: PASS (0 blocking, 2 advisory)
| Skill | How | |---|---| | /gates Stage 5 | BROWSER validation (advisory for frontend) | | Orchestrator Step 7 | Include browser testing for frontend tasks | | ralph-frontend | Invoke via skill, not via MCP directly |
--a11y) (v3.0 — Item 13)/browser-test http://localhost:3000 --a11y
Runs axe-core via Lighthouse accessibility audit:
Output blocked in ralph-frontend quality gate when score < 90.
Reference: docs/reference/accessibility-checklist.md
Screenshots saved to .claude/quality-results/screenshots/ with timestamp.
For visual comparison between runs:
# Compare current vs previous screenshot
mcp__zai-mcp-server__ui_diff_check(before_image, after_image)
Screenshots are gitignored (.claude/quality-results in .gitignore).
| Excuse | Rebuttal | |---|---| | "It looks fine in the code" | Visual bugs are invisible in code review. Test in browser. | | "Lighthouse is too strict" | Lighthouse catches real user experience issues. | | "Console warnings don't matter" | Warnings become errors in strict mode and for users. | | "Accessibility is for later" | WCAG 2.1 AA is mandatory, not optional. |
development
Living knowledge base management. Actions: search (query vault), save (store learning), index (update indices), compile (raw->wiki->rules graduation), init (create vault structure). Follows Karpathy pipeline: ingest->compile->query. Use when: (1) searching accumulated knowledge, (2) saving learnings, (3) compiling raw notes into wiki, (4) initializing a new vault. Triggers: /vault, 'vault search', 'knowledge base', 'save learning'.
testing
Produce a verifiable technical specification before coding. 6 mandatory sections: Interfaces, Behaviors, Invariants (from Aristotle Phase 2), File Plan, Test Plan, Exit Criteria (executable bash commands + expected results). Use when: (1) before implementing features with complexity > 4, (2) as Step 1.5 in orchestrator workflow, (3) when requirements need formalization. Triggers: /spec, 'create spec', 'write specification', 'technical spec'.
testing
Pre-launch shipping checklist orchestrating /gates, /security, /browser-test, /perf. Ensures nothing ships without passing all quality checks. Use when: (1) before deploying, (2) before merging to main, (3) before release. Triggers: /ship, 'ship it', 'ready to deploy', 'pre-launch check'.
development
Performance optimization skill. Core Web Vitals via Lighthouse, bundle size analysis, metrics tracking over time. Use when: (1) optimizing frontend performance, (2) analyzing bundle size, (3) tracking metrics regression. Triggers: /perf, 'performance audit', 'core web vitals', 'bundle size'.