use-shadcn
Skill68 starsChanged 2 days agoMITView on GitHub
WHEN the foreign `shadcn` skill may be used here, and what our law says louder than it. Load it before adding a shadcn component, before building a new SECTION KIND for the catalogue, before building a WIDGET, and the moment the shadcn skill tells you to compose a Dialog, pick a toast, or place markup on a page. The shadcn skill owns HOW its components compose; this one owns WHERE the result is allowed to live — and in this project there are only two places, a catalogue section and a route widget. Four of its rules collide with ours; each collision below is resolved in our favour and says why, so you can follow the foreign skill everywhere else with a clear head.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- Fractera/web4-node-starter-kitword for word, first seen Nov 15, 2026
- Fractera/Agentic-Engineering-Infrastructureword for word, first seen Nov 8, 2026
Other versions2 projects use a version of this.
Word for word · 2
- Fractera/Agentic-Engineering-Infrastructure★ 68100% same
- Fractera/web4-node-starter-kit★ 68100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository91 other files it gives its agents.
- app/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- adopt-suggested-skillSkill
- ai-elementsSkill
- ai-sdkSkill
- answer-elementSkill
- ask-elementSkill
- audit-broken-charactersSkill
- build-product-with-ownerSkill
- content-factorySkill
- core-build-returnSkill
- core-scheduleSkill
- create-elementSkill
- create-multilingual-content-entrySkill
- dedicated-serverSkill
- design-and-settings-of-elementsSkill
- element-permissionSkill
- element-powerSkill
- expand-site-languageSkill
- explain-this-projectSkill
- find-skillsSkill
- fractera-vs-anthropicSkill
- handle-needSkill
- helpful-linksSkill
- help-in-browserSkill
- humanizerSkill
- integratorSkill
- interface-designSkill
- know-the-architectSkill
- manage-app-settingsSkill
- money-and-resourcesSkill
- node-typeSkill
- own-agentsSkill
- persist-env-var-with-rebuildSkill
- place-page-in-menuSkill
- provider-rulesSkill
- release-templateSkill
- researchSkill
- review-pageSkill
- route-to-elementSkill
- self-reviewSkill
- shadcnSkill
- shape-the-needSkill
- skill-creatorSkill
- study-for-elementSkill
- supervise-elementSkill
- translate-pendingSkill
- ultracode-sessionSkill
- use-agentic-ragSkill
- use-ai-generationSkill
- use-aioSkill
- use-app-configSkill
- use-auth-providersSkill
- use-authSkill
- use-browserSkill
- use-channelsSkill
- use-chatSkill
- use-code-shapeSkill
- use-databaseSkill
- use-dataSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 26
Every interface element shadcn has comes from shadcn, installed or not yet installed (npx shadcn@latest add <name>).
- Distinctive: line 32
Before a single component is added: what am I building?
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
use-shadcn
Informational, not binding. Know a better way for the case in front of you — do it your way and say so. You are trusted with the creative work on this project.
The shadcn skill (vendored, .claude/skills/shadcn/, provenance in its SOURCE.md) is genuinely
good and mostly agrees with us: semantic colours over literals, existing components over custom
markup, compose instead of reinvent. Use it. It has one blind spot, and it is not its fault — it
knows shadcn, it does not know that in this project a page is not a place where you may put
things.
0. 🔒 Step 730 — the catalogue is the law, outside a design skill's territory
Every interface element shadcn has comes from shadcn, installed or not yet installed (npx shadcn@latest add <name>); the guard
check:shadcn-parts and the hook shadcn-skills hold it, and a touched file leaves clean (use-primitives §0). Own markup belongs only
to a design skill in its territory, marked @design <mark>.
1. The question that comes first, always
Before a single component is added: what am I building? → CLAUDE.md, What goes on a page.
A page here is a LIST OF SECTIONS in a language cell. Whatever appears on it is a catalogue section,
a route widget, or a platform primitive. There is no fourth source, and check:page-composition
refuses the build for a page that invents its own layout. The shadcn skill will never stop you from
writing a beautiful hand-laid page — this line is the only thing that does.
2. Two legal entries, in this order
Entry one — a NEW SECTION KIND. This is the main one. In this project one does not work without
sections: whatever the owner wants to create, he creates it as a section, so it is reusable by any page
of his site. The shadcn skill is at its best exactly here — composing the inside of
sections/kinds/<kind>.server.tsx out of components that already exist. The kind then lives in the
six places use-sections names, and its interactive part lives in an island under components/.
Entry two — a WIDGET. A widget belongs to ONE route and is allowed an arbitrary look, so foreign
design knowledge has the widest room here — _widgets/{static|dynamic}/<name>/. Read the nearest
existing widget before you start (use-widgets); isolation forbids sharing code, it does not license
building something that looks foreign to the product.
Deciding between them is not this skill's job — the trigger table in CLAUDE.md decides, and
use-sections explains the boundary. In one line: reuse decides. A kind must fit any page of the
project; a widget need fit nobody but its route.
3. Four places where the foreign skill is overruled — and why
| It says | Here | Why |
compose Dialog + DialogTitle yourself | AppDialog only — components/dialog/app-dialog.client.tsx | one owner per genus of thing. A bare DialogContent has no height limit and no scrolling body, and a long form grows past the bottom of the screen together with its submit button. check:dialogs refuses a direct import; the visible standard is the design settings (DESIGN-CONFIG) |
toast from toast for Base UI projects | sonner | this project carries both base libraries at once, and its toaster is mounted once. A second toast system means two toasters and doubled messages |
| components go wherever you compose them | nothing under sections/ is a client component | the section layer is server-only, whole; interactivity is the island it mounts. check:static refuses it |
semantic colours (bg-primary) | same rule, one step further: the token is the only colour | the owner repaints his whole project from the design panel. A literal colour does not break — it silently leaves that system. check:contrast measures it |
Everywhere else, follow it as written: cn(), gap-* over space-*, size-*, Field/FieldGroup
for forms, Empty, Skeleton, Separator, icons via data-icon.
4. Adding a component is ordinary work; changing the base is not
npx shadcn@latest add <component> into components/ui/ is a normal act — but check the folder
first: a genus that already has an owner keeps it, and a second implementation of the same thing is a
fork of the product's look (use-primitives).
Changing the base library, migrating Radix to Base UI, swapping the icon set — the owner's
decision, not yours. The migration skill that ships in the same repository was deliberately not
installed; SOURCE.md says how to bring it back if he ever asks for it.
Never hand-edit anything under .claude/skills/shadcn/. It is foreign, vendored, and the next
npx skills update overwrites it silently. What we have to say lives here.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

