theme-check

Validates light and dark mode theme adaptation across UI components and states.

1.6k|221|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/ZeroDeng01/sublinkPro --skill theme-check-zerodeng01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: theme-check
Source: https://github.com/ZeroDeng01/sublinkPro/tree/main/.agents/skills/theme-check
Command: npx skills add https://github.com/ZeroDeng01/sublinkPro --skill theme-check-zerodeng01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Frontend theme changes often break in untested places: dialogs, mobile views, hover states, or nested panels end up unreadable in one of the light/dark modes. This Skill provides a structured checklist so theme adaptation work is verified systematically instead of only fixing the currently visible component. ## Core Features & Use Cases - Comprehensive Coverage Checklist: Ten sections covering mode coverage, device coverage, component structure, text hierarchy, interactive states, surface layering, form controls, mobile specifics, and code quality. - Reference Pattern Guidance: Points to established in-repo patterns (NodePreview, Chain proxy, Airport management clusters) so new changes reuse proven theme semantics instead of inventing new ones. - Delivery & Exit Criteria: Enforces explicit coverage statements, light/dark verification methods, and partial-coverage labeling when not all variants were checked. - Use Case: After updating a MUI dialog's colors in a React app, run this checklist to confirm the dialog, its mobile variant, hover/disabled states, and nested panels all render correctly in both light and dark modes before shipping. ## Quick Start Use the theme-check skill to verify my dialog color changes are fully adapted for both light and dark modes on desktop and mobile.

Frequently Asked Questions about theme-check

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

FAQPage Schema
How do I verify dark mode support for a React MUI component?

Verify dark mode by toggling the actual theme rather than relying on screenshots, then check the component in both modes across desktop and mobile. Confirm text hierarchy, borders, surfaces, and interactive states like hover, disabled, and focus-visible all remain readable.

What should a theme adaptation checklist include?

A theme checklist should cover mode coverage, device and breakpoint coverage, component structure (dialogs, drawers, popovers, tooltips), text hierarchy, interactive states, surface layering, and mobile-specific concerns like safe-area padding and sticky footers.

Why does my dialog look fine in light mode but broken in dark mode?

This usually happens when hardcoded colors like #fff or white are used for surfaces, or when nested panels lack semantic background tokens. Replace magic values with theme variables such as background.paper, divider, and alpha-based borders.

When should theme work be marked as partial coverage?

Mark partial coverage when you cannot check all component variants, such as desktop, mobile, dialogs, drawers, overlays, and detail panels. Claiming full theme adaptation without verifying these variants leads to unreadable states shipping unnoticed.

Does this checklist apply to simple text changes?

No, the checklist is intended for changes affecting colors, surfaces, dialogs, or theme infrastructure. Simple text-only edits that do not alter presentation semantics do not require the full verification process.