css-layout-debugger

Diagnose CSS layout issues in Next.js applications through a 6-phase pipeline.

1|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/dtsong/claude-code-windows-setup --skill css-layout-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: css-layout-debugger
Source: https://github.com/dtsong/claude-code-windows-setup/tree/main/skills/frontend-qa/css-layout-debugger
Command: npx skills add https://github.com/dtsong/claude-code-windows-setup --skill css-layout-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers diagnose and fix visual bugs related to CSS layout, styling, and responsiveness in Next.js applications, ensuring a consistent and correct user interface.

Core Features & Use Cases

  • Comprehensive Diagnosis: Analyzes CSS issues through a 6-phase pipeline mirroring browser rendering.
  • Multi-Framework Support: Handles Tailwind CSS, CSS Modules, styled-components, and vanilla CSS.
  • Use Case: A user reports that a button is misaligned on mobile devices and its background color isn't changing in dark mode. This Skill can pinpoint whether the issue stems from incorrect Tailwind classes, CSS specificity conflicts, or viewport-related styling.

Quick Start

Use the css-layout-debugger skill to diagnose a styling issue on the '/dashboard' route, providing the symptom 'elements are overlapping' and a screenshot.

Frequently Asked Questions about css-layout-debugger

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

FAQPage Schema
How do I debug CSS layout and styling issues in a Next.js application?

Debug CSS layout and styling issues in Next.js by executing a diagnostic pipeline that mirrors browser evaluation order to pinpoint problems across token resolution, cascade conflicts, and layout models.

Does this CSS debugging approach work with Tailwind and styled-components?

Yes, this CSS debugging approach works with Tailwind, CSS Modules, styled-components, and vanilla CSS by analyzing source files to identify specificity conflicts and incorrect styling rules.

Why are my Next.js elements overlapping on mobile viewports?

Overlapping elements on mobile viewports are often caused by viewport responsiveness issues or stacking context conflicts, which can be diagnosed by analyzing layout models and responsive styling rules.

How do I find CSS specificity conflicts causing incorrect dark mode styling?

Find CSS specificity conflicts causing incorrect dark mode styling by diagnosing cascade conflicts through a structured pipeline that evaluates token resolution and styling rule precedence in your source files.

What do I need to diagnose Next.js frontend styling bugs?

To diagnose Next.js frontend styling bugs, you need read-only access to your application source files and write access to a specific QA cache directory for persisting diagnostic reports.

What is the best way to troubleshoot misaligned UI components in frontend development?

The best way to troubleshoot misaligned UI components is to execute a 6-phase diagnostic pipeline that evaluates token resolution, layout models, and stacking contexts to isolate the root cause.