shadcn-code-review

Review React components using shadcn/ui, Radix primitives, and Tailwind CSS for best practices.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/bluebricks-nl/blue-bricks-template --skill shadcn-code-review-bluebricks-nl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shadcn-code-review
Source: https://github.com/bluebricks-nl/blue-bricks-template/tree/main/.claude/skills/shadcn-code-review
Command: npx skills add https://github.com/bluebricks-nl/blue-bricks-template --skill shadcn-code-review-bluebricks-nl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses common pitfalls in using shadcn/ui components, ensuring better code quality, accessibility, and maintainability.

Core Features & Use Cases

  • CVA Pattern Enforcement: Checks for correct usage of class-variance-authority, including className handling and VariantProps.
  • Accessibility Audits: Verifies proper implementation of focus states, ARIA attributes, and disabled states.
  • Composition Best Practices: Reviews the use of asChild with Slot and context-based component composition.
  • Use Case: When reviewing a new React component that utilizes shadcn/ui, this Skill will automatically flag potential issues related to CVA implementation, accessibility, and component composition, guiding the developer towards best practices.

Quick Start

Review the provided React component code for adherence to shadcn/ui best practices.

Frequently Asked Questions about shadcn-code-review

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

FAQPage Schema
How do I review React components for shadcn/ui best practices?

To review React components for shadcn/ui best practices, analyze CVA patterns, component composition using asChild and Slot, accessibility states like focus-visible and ARIA attributes, and data-slot usage for targeted styling to ensure maintainability.

What is the correct way to handle className and VariantProps with CVA in shadcn/ui?

Correct CVA implementation in shadcn/ui requires proper className handling and VariantProps usage to manage class variations, ensuring that styles are applied predictably and component variants remain maintainable.

How does component composition with asChild and Slot work in Radix primitives?

Component composition with asChild and Slot in Radix primitives works by passing props and behaviors to a child element instead of rendering an extra DOM node, enabling flexible component composition without breaking accessibility states.

Does this code review check accessibility states like focus-visible and ARIA attributes?

Yes, this code review checks accessibility states by verifying proper implementation of focus-visible states, ARIA attributes, and disabled states to ensure your shadcn/ui components meet accessibility standards.

Can I use this to audit Tailwind CSS styling logic in shadcn/ui components?

Yes, you can use this to audit Tailwind CSS styling logic by reviewing data-slot usage for targeted styling and validating CVA class-variance-authority patterns to maintain code quality in your React components.

Why should I use data-slot attributes for targeted styling in React components?

You should use data-slot attributes for targeted styling because they provide a stable hook for applying Tailwind CSS styles to specific internal parts of shadcn/ui components without breaking component composition or accessibility.