svelte-shadcn

Claude Code plugin that biases Svelte / SvelteKit development toward shadcn-svelte, Svelte 5 runes, Bun, Tailwind v4, and TypeScript strict.

What it does

• Skill — teaches Claude when and how to install shadcn-svelte primitives instead of hand-rolling UI.
• Agent — svelte-shadcn-builder (sonnet) — invoked automatically for Svelte UI work.
• Commands — slash commands wrap the shadcn-svelte CLI and add project-local tooling:
  • /svelte-shadcn:init — shadcn-svelte init with sensible defaults + deps sanity check.
  • /svelte-shadcn:add <component>... — install primitives + autofix. Validates names against the registry llms.txt for unknowns.
  • /svelte-shadcn:block <name> — install a composed block (dashboard-01, sidebar-07, login-03, …).
  • /svelte-shadcn:remove <component>... — usage check, prompt, delete ui/<name>/.
  • /svelte-shadcn:update <component>... | --all — re-install with --overwrite to sync upstream.
  • /svelte-shadcn:theme <preset|custom> — apply slate / gray / zinc / neutral / stone, or custom HSL.
  • /svelte-shadcn:page <route> [primitives...] — scaffold a SvelteKit route.
  • /svelte-shadcn:form <route> <schema> — Formsnap + superforms + Zod scaffold.
  • /svelte-shadcn:data-table <model> <route> — TanStack data-table + columns + route wiring.
  • /svelte-shadcn:audit — scan project for Svelte 4 syntax, raw bits-ui imports, hand-rolled primitives, missing deps, wrong Tailwind version, non-Bun lockfiles.
• Hook — SessionStart detects Svelte projects and reminds Claude of the stack rules.

Install

/plugin marketplace add sling86/svelte-shadcn-plugin
/plugin install svelte-shadcn
/reload-plugins

Or from a local clone:

/plugin marketplace add <path-to-clone>
/plugin install svelte-shadcn

The repo doubles as a single-plugin marketplace — .claude-plugin/marketplace.json at the root references plugins/svelte-shadcn.

Conventions enforced

Stack baseline

• Svelte 5 + SvelteKit 2
• Bun ≥ 1.1
• Tailwind v4
• Bits UI (via shadcn-svelte wrappers)
• Formsnap + sveltekit-superforms + Zod (forms)
• TanStack Table (via shadcn-svelte data-table)

Companion plugin

Enable the svelte plugin alongside this one. This plugin delegates every .svelte / .svelte.ts write to the svelte:svelte-file-editor agent, which:

• Loads svelte-core-bestpractices (runes, snippets, keyed each, styling).
• Runs svelte-autofixer (catches Svelte 4 syntax, missing $derived, missing keys, etc.).
• Retries until clean.

Without the svelte plugin enabled, the agent falls back to the svelte-code-writer skill or npx @sveltejs/mcp@latest. Strongly recommended to install both.

Structure

.claude-plugin/marketplace.json
plugins/svelte-shadcn/
├── .claude-plugin/plugin.json
├── agents/svelte-shadcn-builder.md
├── commands/{init,add,block,remove,update,theme,page,form,data-table,audit}.md
├── hooks/hooks.json
├── hooks/scripts/session-start.sh
└── skills/shadcn-svelte-usage/SKILL.md

Development

This plugin is markdown + JSON only — no build step. Validate after edits:

/plugin                                # plugin-dev validator

Or run the plugin-validator agent from the plugin-dev plugin.

Source of truth

shadcn-svelte registry index: https://www.shadcn-svelte.com/llms.txt