w-shadcn — Claude Code skill: what it does, how to install
The w-shadcn Claude Code skill adds shadcn primitives to a shared UI package or extends existing ones. It handles component-level work; screen redesigns go through /w-ui.
MIT 647 installs ★ 1 updated 2026-10-02
npx skills add blockmatic-icebox/basilic-skills --skill w-shadcn -a claude-codeWhat w-shadcn does
The skill installs a shadcn primitive in a monorepo’s shared UI package, or extends one already there. It finds the package from components.json; the Basilic example points to packages/w-ui/src/components/.
Use @repo/w-ui/components/* for imports and take cn from that package. Less common primitives come from @repo/w-ui/base. The components.json style must be base-vega; composition uses render with data-slot or data-open. The skill runs lint on changed files. It calls shadcn MCP only when component variants are unclear or installation fails. If behavior or commands change, documentation is handled with /w-docs.
What it helps with
- add a shadcn primitive to the shared UI package
- extend an existing interface component
- import a primitive through the monorepo package path
- lint the files changed by the update
Example prompts for the agent
- Add a shadcn date-picker primitive to the shared UI package.
- Extend this primitive and import it through
@repo/w-ui/components/*. - Update the component, then lint the changed files.
How to install w-shadcn
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-shadcn -a claude-code2Manually: put the files in place
~/.claude/skills/w-shadcn/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-shadcn/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-shadcn -a codex2Manually: put the files in place
.agents/skills/w-shadcn/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-shadcn -a cursor2Manually: put the files in place
.cursor/skills/w-shadcn/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-shadcn2Manually: put the files in place
.github/skills/w-shadcn/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-shadcn -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-shadcnManually: put the files in place
.devin/skills/w-shadcn/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-shadcn -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about w-shadcn
How do I install w-shadcn in Claude Code?
Run npx skills add blockmatic-icebox/basilic-skills --skill w-shadcn -a claude-code. The skill file is at ~/.claude/skills/w-shadcn/SKILL.md.
What does w-shadcn do?
It installs or extends shadcn primitives in a shared monorepo UI package, then runs lint on changed files.
Which import conventions does w-shadcn follow?
Regular primitives use @repo/w-ui/components/*; less common ones use @repo/w-ui/base. The components.json style is base-vega.
Source text
SKILL.md · MIT
--- name: w-shadcn description: Install shadcn/w-ui primitives in the shared UI package using monorepo import paths. disable-model-invocation: true --- Install or extend a shadcn primitive. Reshaping a screen stays on `/w-ui`. Follow `shadcn-v3`. 1. Use shadcn MCP only when unsure about variants or when hitting an install error. 2. Install in the shared UI package from `components.json` (Basilic example: `packages/w-ui/src/components/`). 3. Import `@repo/w-ui/components/*` and that package’s `cn`. Rare primitives: `@repo/w-ui/base` (not `@base-ui/react`, not `@radix-ui/*`, not deleted `@repo/w-ui/radix`). Keep `components.json` `"style": "base-vega"`. Compose with `render` + `data-slot` / `data-open` (not `asChild` / `data-state`). 4. After the primitive exists, reshape screens with `/w-ui` if the job is a surface, not only a component. Run lint on the changed files. 5. Docs: `/w-docs` if behavior or commands changed.
© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills