check-theme

Audit React/Next.js frontend code for hardcoded theme token violations.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/SumitRajpal/nextjs-claude-architecture --skill check-theme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-theme
Source: https://github.com/SumitRajpal/nextjs-claude-architecture/tree/main/.claude/skills/check-theme
Command: npx skills add https://github.com/SumitRajpal/nextjs-claude-architecture --skill check-theme

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit frontend code for theme token violations and ensure design consistency.

Core Features & Use Cases

  • Theme audit: scans code for hardcoded colors, spacing, and non-token usage.
  • Enforce design tokens: checks for tokens in class names (e.g., text-primary, bg-surface) vs arbitrary values.
  • Reporting: groups results by violation type with file paths and line numbers.

Quick Start

Run the theme audit across the codebase to produce a report of violations.

Frequently Asked Questions about check-theme

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

FAQPage Schema
How do I audit my React codebase for hardcoded colors and spacing?

To audit for hardcoded colors and spacing, run a theme token audit that scans source files for non-token usage and reports violations grouped by type with file paths and line numbers.

How does a theme token violation report work in frontend projects?

A theme token violation report works by scanning source files to detect hardcoded colors, fonts, and spacing, then grouping violations by type with file paths and line numbers for code review remediation.

Can I enforce design tokens in Next.js projects during CI pipelines?

Yes, you can enforce design tokens in Next.js projects during CI pipelines by running an audit that checks class names for valid tokens like text-primary or bg-surface instead of arbitrary values.

What's the best way to detect non-token CSS usage in large frontend projects?

The best way to detect non-token CSS usage in large frontend projects is to run an automated theme audit that scans for hardcoded values and enforces design tokens within class names for consistency.

Does the theme audit work with existing design tokens in React code reviews?

Yes, the theme audit works with existing design tokens in React code reviews by checking class names for valid token usage such as bg-surface and flagging arbitrary values as violations.

Why does my frontend design break when hardcoded colors override theme tokens?

Frontend design breaks when hardcoded colors override theme tokens because the hardcoded values bypass the centralized design system, causing CSS compatibility issues and visual inconsistencies across components.