CtrlK
BlogDocsLog inGet started
Tessl Logo

shadcn

Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", or "switch to --preset".

76

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

92%

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

The body is excellent on conciseness, actionability, and workflow clarity — dense, executable, and gated with explicit validation and user-confirmation checkpoints for batch/destructive operations. The one real weakness is progressive disclosure: the skill advertises a set of detailed reference files (rules/*.md, cli.md, customization.md) that are not present in the bundle, leaving the navigation structure pointing at dead links.

Suggestions

Add the missing referenced files (rules/styling.md, rules/forms.md, rules/composition.md, rules/base-vs-radix.md, rules/icons.md, cli.md, customization.md) so the Critical Rules and Detailed References links resolve, or remove the dead links and inline the essential rule content.

If the referenced files are intentionally omitted from this bundle, replace the broken 'See [file].md' references with a note that the details are inline or summarize each rule's Incorrect/Correct pair directly in SKILL.md.

Either reference the existing assets/ PNGs (shadcn.png, shadcn-small.png) where they add value, or remove them so the bundle contains only files the body actually uses.

DimensionReasoningScore

Conciseness

The body is lean and operational — terse imperative bullets, a compact quick-reference, and concrete code/CLI snippets with no padded explanation of basic concepts — matching the score-3 anchor for lean, efficient content that assumes Claude's competence. It is not score-2 because there is no unnecessary explanation; the longer passages (e.g. step 6 on third-party imports) are concrete operational instructions rather than fluff.

3 / 3

Actionability

Provides fully executable commands (e.g. 'npx shadcn@latest add button --diff button.tsx', 'npx shadcn@latest docs button dialog select'), copy-paste-ready JSX in the Key Patterns block with correct/wrong comparisons, and a needs-to-component selection table — matching the score-3 anchor for fully executable code/commands and specific examples.

3 / 3

Workflow Clarity

The Workflow section is a clearly numbered 9-step sequence with explicit validation checkpoints (step 2 always check installed components, step 7 'always read the added files and verify they are correct... Fix all issues before moving on', step 8 ask before guessing a registry, step 9 confirm reinstall/merge/skip) and an Updating Components feedback loop with a 'never --overwrite without approval' gate — matching the score-3 anchor for clear sequencing with validation steps and feedback loops.

3 / 3

Progressive Disclosure

The body is well-structured and signals one-level-deep references (Critical Rules → linked files, a Detailed References section), but scoring against the actual bundle per the rubric guideline reveals that all 7 referenced files (rules/styling.md, rules/forms.md, rules/composition.md, rules/base-vs-radix.md, rules/icons.md, cli.md, customization.md) do not exist — the rules/ directory is absent and the 'Each links to a file with Incorrect/Correct code pairs' promise is unfulfilled, while the only real bundle files (two PNGs in assets/) are never referenced. It is not score-3 because the navigation is broken (referenced files absent); it is not score-1 because the body is well-organized and not a monolithic wall or deeply nested.

2 / 3

Total

11

/

12

Passed

Description

100%

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 exemplary: it names concrete capabilities, includes natural trigger terms users would actually say, explicitly covers both what and when, and carves out a distinct niche unlikely to conflict with other skills. It is concise without padding and uses correct third-person voice.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'adding, searching, fixing, debugging, styling, and composing UI' plus 'Provides project context, component docs, and usage examples' — matching the score-3 anchor for multiple specific concrete actions.

3 / 3

Completeness

Explicitly answers both what ('Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI') and when ('Applies when working with shadcn/ui, component registries, presets...' and 'Also triggers for...'), matching the score-3 anchor for clear what AND when with explicit triggers.

3 / 3

Trigger Term Quality

Covers natural terms a user would say — 'shadcn/ui', 'component registries', 'presets', '--preset codes', 'components.json file', 'shadcn init', 'create an app with --preset', 'switch to --preset' — matching the score-3 anchor for good coverage of natural terms.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche (shadcn specifically) with distinct triggers like 'components.json file' and '--preset codes', making it unlikely to fire for unrelated skills, matching the score-3 anchor for a clear niche with distinct triggers.

3 / 3

Total

12

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 14 missing

Warning

Total

15

/

16

Passed

Repository
MODSetter/SurfSense
Reviewed

Table of Contents

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.