shadcn is agent-read markdown (skill) from kunolu/640-skills: Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. 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"..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# shadcn/ui
A framework for building ui, components and design systems. Components are added as source code to the user's project via the CLI.
> **IMPORTANT:** Run all CLI commands using the project's package runner: `npx shadcn@latest`, `pnpm dlx shadcn@latest`, or `bunx --bun shadcn@latest` — based on the project's `packageManager`. Examples below use `npx shadcn@latest` but substitute the correct runner for the project.
## Current Project Context
```json
!`npx shadcn@latest info --json`
```
The JSON above contains the project config and installed components. Use `npx shadcn@latest docs <component>` to get documentation and example URLs for any component.
## Principles
1. **Use existing components first.** Use `npx shadcn@latest search` to check registries before writing custom UI. Check community registries too.
2. **Compose, don't reinvent.** Settings page = Tabs + Card + form controls. Dashboard = Sidebar + Card + Chart + Table.
3. **Use built-in variants before custom styles.** `variant="outline"`, `size="sm"`, etc.
4. **Use semantic colors.** `bg-primary`, `text-muted-foreground` — never raw values like `bg-blue-500`.
## Critical Rules
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_7wtc3xkmeglh4xzx
GET https://markdownregistry.com/api/v1/resolve?ref=kunolu/640-skills/shadcn
GET https://markdownregistry.com/api/v1/blob/deba6c5152d9835892fa7dffeb1fedbb689ddac7e59e14e57ec5eaf9463309e4
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/diagnosing-bugs/SKILL.md · Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports…
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/domain-modeling/SKILL.md · Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md…
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/grill-with-docs/SKILL.md · A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/grilling/SKILL.md · Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or…
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/handoff/SKILL.md · Compact the current conversation into a handoff document for another agent to pick up.
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/i-have-adhd/SKILL.md · Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns…
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/impeccable/SKILL.md · Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt…
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/ponytail-audit/SKILL.md · Whole-repo audit for over-engineering. Like ponytail-review, but scans the entire codebase instead of a diff: a ranked…
kunolu/640-skills · sbtd-workflow-onboard/assets/external-skills/stable/skills/ponytail-debt/SKILL.md · Harvest every `ponytail:` comment in the codebase into a debt ledger, so the deliberate shortcuts and deferrals…
