shadcn is agent-read markdown (skill) from different-ai/openwork: 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"..
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_yuesodlcaljeghrf
GET https://markdownregistry.com/api/v1/resolve?ref=different-ai/openwork/shadcn
GET https://markdownregistry.com/api/v1/blob/c5a5c3a8e380ab7d49369c68a715b2da6b1bcc449898cfdf787bbab8cb13a5d9
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.
different-ai/openwork · .opencode/skills/browser-automation/SKILL.md · Local OpenWork Electron browser automation with CDP. Use when driving a local Electron dev app, browser_list…
different-ai/openwork · .opencode/skills/create-plugin/SKILL.md · Create an OpenCode plugin for OpenWork. Scaffolds the plugin file with the correct API shape, tool definitions, and…
different-ai/openwork · .opencode/skills/daytona-seeded-cloud-demo/SKILL.md · Daytona seeded cloud demo, demo credentials, Acme Robotics seed. Use when the user asks to spin up, keep running, seed…
different-ai/openwork · .opencode/skills/daytona-windows-cert/SKILL.md · test on Windows, enterprise CA, corporate certificate, GPO cert, TLS fetch failed, Windows sandbox, daytona windows…
different-ai/openwork · .opencode/skills/diagnose-a-red-run/SKILL.md · Test is red, typecheck failed, CI job failed, flaky, timed out, was this already broken. Use to classify any failing…
different-ai/openwork · .opencode/skills/get-env-var/SKILL.md · get an env var, fetch a secret, missing env var, missing token/API key, load secrets from Infisical, infisical. Fetch…
different-ai/openwork · .opencode/skills/hunt-a-prod-error/SKILL.md · A user saw internal_error, "Unexpected server error", a 500, or an opaque failure in a shipped OpenWork build. Find the…
different-ai/openwork · .opencode/skills/open-a-pr/SKILL.md · Open a PR, write or rewrite a PR description, "the PR body is too long", or check whether a PR description is readable…
different-ai/openwork · .opencode/skills/openwork-models/SKILL.md · Manage OpenWork inference model aliases, openwork model overlays, discounts, validation, and automated base model…
