web-design-reviewer

Inspects websites via browser automation to detect and fix layout, responsive, and accessibility issues in source code.

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill web-design-reviewer-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-design-reviewer
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/web-design-reviewer
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill web-design-reviewer-tamagusko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Visual design defects like element overflow, broken responsive layouts, poor contrast, and inconsistent spacing are hard to catch without manually testing every page at multiple screen sizes. This Skill automates visual inspection of running websites and applies fixes directly at the source code level. ## Core Features & Use Cases - Automated Visual Inspection: Navigates pages, captures screenshots, and checks layout, typography, contrast, and responsive behavior across mobile, tablet, and desktop viewports. - Source-Level Fixes: Locates the responsible CSS, Tailwind classes, styled-components, or framework components and applies minimal, style-consistent fixes. - Iterative Verification: Re-captures screenshots after each fix, runs regression checks, and produces a prioritized report (P1/P2/P3) of detected and resolved issues. - Use Case: Point it at a local Next.js dev server, and it will detect a horizontal overflow on mobile, trace it to a missing overflow-x: hidden rule in the layout component, fix it, and verify the result at 375px width. ## Quick Start Review the design of my website running at http://localhost:3000 and fix any layout or accessibility issues you find.

Frequently Asked Questions about web-design-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review a website's design automatically?

Provide the URL of a running website, and the skill navigates pages, captures screenshots at multiple viewports, and checks layout, contrast, and responsiveness. Detected issues are then fixed directly in the source code and re-verified with before/after screenshots.

What browser automation tools work for visual design inspection?

Playwright MCP is the recommended reference implementation, offering navigation, screenshots, DOM snapshots, and viewport resizing. Selenium, Puppeteer, Cypress, and WebDriver BiDi also work if they provide navigation, screenshot, and DOM retrieval capabilities.

Does it support Tailwind CSS and styled-components projects?

Yes, it detects the styling method from project files like tailwind.config, package.json dependencies, and CSS module patterns. Fixes are applied in the appropriate location, whether utility classes in JSX, styled-component definitions, SCSS files, or global CSS.

Can it review a production website without source code access?

It can perform read-only visual reviews of production or staging sites, identifying layout, contrast, and responsive issues. However, applying fixes requires the project source code to exist within the workspace.

Why are my style fixes not showing up after being applied?

Common causes include the dev server's HMR not refreshing, browser cache, a required rebuild step, or CSS specificity conflicts. The skill's troubleshooting section covers clearing cache, rebuilding, and using more specific selectors.

What are the limitations of automated visual design review?

It requires a running website and browser automation support, and fixes are limited to issues detectable via screenshots and DOM inspection. If a single issue needs more than three fix attempts, the skill stops and consults the user instead of looping.