shadcn-ui

Provides complete shadcn/ui component library patterns including installation, configuration, and implementation of accessible React components. Use when setting up shadcn/ui, installing components, building forms with React Hook Form and Zod, customizing themes with Tailwind CSS, or implementing UI patterns like buttons, dialogs, dropdowns, tables, and complex form layouts.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/shadcn-ui/SKILL.md

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with complete, executable examples but is bloated by duplicated config blocks and inlined content that belongs in the existing reference files. The setup workflow lacks validation checkpoints and the bundle files are orphaned.

Suggestions

Move the full tsconfig, tailwind.config.js, and globals.css blocks (and the duplicate CSS-variable section) into the references/ files and link to them from the body, keeping only a minimal Quick Start inline.

Reference the existing bundle files (learn.md, reference.md, ui-reference.md, official-ui-reference.md) from a clearly signaled section so they are discoverable instead of orphaned.

Add a validation checkpoint to the install/setup workflow (e.g., verify `components/ui/` populated and the app compiles after `npx shadcn@latest add`) to lift workflow clarity above 3.

Dimension	Reasoning	Score
Conciseness	Mostly efficient code-focused content, but the ~1660-line body inlines full tsconfig/tailwind.config/globals.css and duplicates the CSS-variable block, all of which could be trimmed or referenced rather than repeated.	3 / 5
Actionability	Abundant copy-paste-ready commands (`npx shadcn@latest add ...`) and complete component examples covering the common cases (button, input, form, dialog, sheet, select, table, toast).	5 / 5
Workflow Clarity	A 7-step Instructions list and Quick Start commands give a rough sequence, but batch operations like `npx shadcn@latest add --all` have no validation/verification checkpoints, capping this dimension at 3.	3 / 5
Progressive Disclosure	A Table of Contents and labeled sections provide structure, but bulk config dumps are inlined and the four bundle files in references/ are never linked or signaled from the body.	3 / 5
	Total	14 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is well-crafted: third-person voice, concrete actions, explicit 'Use when' triggers, and a clearly distinct niche. The only shortfall is trigger-term completeness, which could add a few synonyms/extensions but is already strong.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions — 'installation, configuration, and implementation of accessible React components' plus 'building forms with React Hook Form and Zod, customizing themes with Tailwind CSS' — with only minor coverage gaps.	4 / 5
Completeness	Explicitly states what the skill provides and follows with a clear 'Use when...' clause enumerating concrete triggers (setting up, installing components, building forms, customizing themes, implementing UI patterns).	5 / 5
Trigger Term Quality	Strong natural keyword coverage including shadcn/ui, components, React Hook Form, Zod, Tailwind CSS, buttons, dialogs, dropdowns, tables, and forms; a few common synonyms are absent.	4 / 5
Distinctiveness Conflict Risk	A clear niche (shadcn/ui with named Radix/Tailwind/RHF/Zod stack) with distinct triggers and minimal overlap with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (1659 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: shep-ai/shep
Path: .claude/skills/shadcn-ui/SKILL.md
Commit: e86d11c

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.