shadcn-agents-cva-validator

Official

Audit cva variant APIs with PASS/FAIL

AuthorImpertio-Studio
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Prevents shadcn-ui cva-driven components from silently shipping incorrect variant APIs by providing a deterministic, checklist-based validator that returns PASS or FAIL.

Core Features & Use Cases

  • 7-Point cva Variant API Validator: Verifies the canonical cva structure (base classes, variants shape, compoundVariants order, defaultVariants completeness, VariantProps export, cn() className merging, asChild Slot usage).
  • Code-Review / Pre-Commit Guardrails: Stops at the first failure and emits an exact verdict block with a line reference and the canonical fix pointer.
  • Debugs AI-generated or hand-edited cva mistakes: Catches frequent regressions like nested cn inside cva, compoundVariants before variants, defaultVariants typos, VariantProps drift, raw className concatenation, and missing Slot branching.

Quick Start

Use this validator to audit the diff of a shadcn component that uses class-variance-authority (cva) and quickly confirm the variant API matches shadcn conventions before accepting the change.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: shadcn-agents-cva-validator
Download link: https://github.com/Impertio-Studio/shadcn-ui-Claude-Skill-Package/archive/main.zip#shadcn-agents-cva-validator

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.