component-aesthetic-checker

Detect insufficient shadcn/ui component customization in Tanstack Start React apps.

3|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/hirefrank/claude-plugins --skill component-aesthetic-checker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: component-aesthetic-checker
Source: https://github.com/hirefrank/claude-plugins/tree/main/plugins/edge-stack/skills/component-aesthetic-checker
Command: npx skills add https://github.com/hirefrank/claude-plugins --skill component-aesthetic-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures shadcn/ui components are deeply customized and consistently themed, avoiding default prop usage and generic aesthetics.

Core Features & Use Cases

  • Default Props Detection: Flags components using only default props.
  • UI Prop Validation: Checks for deep customization via ui prop patterns.
  • Design System Consistency: Enforces cohesive spacing, icons, and tokens.

Quick Start

Audit a component library for consistent design customization and token usage.

Frequently Asked Questions about component-aesthetic-checker

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

FAQPage Schema
How do I validate that shadcn/ui components are properly customized in my React app?

Validate shadcn/ui component customization by checking for deep ui prop patterns, design token usage, and consistent Tailwind spacing rather than default props. This Skill detects insufficient customization in .react/.tsx files and flags components relying only on defaults.

What does it mean to deeply customize shadcn/ui components instead of using defaults?

Deep customization means applying design tokens, theming via ui props, consistent icon libraries, proper spacing scales, and loading states for async components. Shallow customization relies on default props and generic aesthetics without design-system alignment.

Can I use this to enforce design system consistency across a component library?

Yes. This Skill audits shadcn/ui components for consistent spacing, icon sizing, design tokens, and themed props across your Tanstack Start React codebase, triggering on modifications, refactors, and library updates.

How does this work with Tailwind and design tokens in shadcn/ui?

This Skill validates that components reference design tokens and use consistent Tailwind spacing values rather than defaults. It checks ui prop customization patterns and ensures token usage aligns across Button, Card, Input, and other shadcn/ui components.

When should I run customization checks on my shadcn/ui components?

Run checks when adding or modifying component props, customizing ui props, refactoring multiple components together, updating dependencies, or establishing design-system governance across your React app.

What happens if a component doesn't have loading states or consistent icon sizing?

This Skill flags async components missing loading states and inconsistent icon libraries or sizing as insufficient customization. It enforces these patterns to maintain design-system consistency and user experience across your UI.