Index of every page on this site: llms.txt
All skills
vinkydev avatar

/shadcn

@c3beb5a
by Vinkyvinkydev/vibestart298 stars
14
Run it yourself

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", "switch to --preset", and for building a design system or applying a DESIGN.md or brand spec to shadcn/ui.

  • 21 files
  • 154.9 KB
  • Updated last month
  • GitHub
Use this Skill: https://skilld.dev/gh/vinkydev/vibestart/shadcn

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

mcp.md

≈878 tokens on demand. Your agent reads this file only when SKILL.md points to it.

shadcn MCP Server

The CLI includes an MCP server that lets AI assistants search, browse, view, and install items from registries.


Setup

shadcn mcp        # start the MCP server (stdio)
shadcn mcp init   # write config for your editor

Editor config files:

Editor Config file
Claude Code .mcp.json
Cursor .cursor/mcp.json
VS Code .vscode/mcp.json
OpenCode opencode.json
Codex ~/.codex/config.toml (manual)

Tools

Tip: MCP tools handle registry operations (search, view, install). For project configuration (aliases, framework, Tailwind version), use npx shadcn@latest info — there is no MCP equivalent.

shadcn:get_project_registries

Returns registry names from components.json. Errors if no components.json exists.

Input: none

shadcn:list_items_in_registries

Lists all items from one or more registries. Registries can be configured namespaces such as @acme, public GitHub sources such as owner/repo, or registry catalog URLs. Omit registries to list from every registry configured in components.json.

Input: registries (string[], optional — omit for all configured), types (string[], optional — e.g. ["ui", "block"]), limit (number, optional, defaults to 100), offset (number, optional)

shadcn:search_items_in_registries

Fuzzy search across registries. Registries can be configured namespaces, public GitHub sources, or registry catalog URLs. Omit registries to search every registry configured in components.json — e.g. "find me a hero" across all configured registries.

Input: registries (string[], optional — omit for all configured), query (string), types (string[], optional — e.g. ["ui", "block"]), limit (number, optional, defaults to 100), offset (number, optional)

shadcn:view_items_in_registries

View item details including full file contents.

Input: items (string[]) — e.g. ["@shadcn/button", "@shadcn/card", "owner/repo/item"]

shadcn:get_item_examples_from_registries

Find usage examples and demos with source code. Omit registries to search every registry configured in components.json.

Input: registries (string[], optional — omit for all configured), query (string) — e.g. "accordion-demo", "button example"

shadcn:get_add_command_for_items

Returns the CLI install command.

Input: items (string[]) — e.g. ["@shadcn/button"]

shadcn:get_audit_checklist

Returns a checklist for verifying components (imports, deps, lint, TypeScript).

Input: none


Configuring Registries

Namespaced and authenticated registries are set in components.json. The @shadcn registry is always built-in. Public GitHub registries can also be used directly as owner/repo registry sources when the repository has a root registry.json; they do not need components.json configuration.

{
  "registries": {
    "@acme": "https://acme.com/r/{name}.json",
    "@private": {
      "url": "https://private.com/r/{name}.json",
      "headers": { "Authorization": "Bearer ${MY_TOKEN}" }
    }
  }
}
  • Names must start with @.
  • URLs must contain {name}.
  • ${VAR} references are resolved from environment variables.

Community registry index: https://ui.shadcn.com/r/registries.json

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at c3beb5a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated last month
What it can do
Runs commands
user-invocable
false
All 3 allowed tools
Bash(npx shadcn@latest *)Bash(pnpm dlx shadcn@latest *)Bash(bunx --bun shadcn@latest *)

README badge

README badge for vinkydev/vibestart/shadcn