diff --git a/.agents/skills/shadcn-ui/SKILL.md b/.agents/skills/shadcn-ui/SKILL.md index 8307cdc1..c106690d 100644 --- a/.agents/skills/shadcn-ui/SKILL.md +++ b/.agents/skills/shadcn-ui/SKILL.md @@ -72,8 +72,8 @@ Vendored: [`vendor/shadcn/mcp.md`](./vendor/shadcn/mcp.md). Live docs: [MCP Serv 1. **Project detection** — Applies when `components.json` exists (here: `web/default/components.json`). 2. **Context injection** — Use `shadcn info --json` as ground truth for imports and APIs. -3. **Pattern enforcement** — Follow rules in [`vendor/shadcn/SKILL.md`](./vendor/shadcn/SKILL.md) and [`vendor/shadcn/rules/`](./vendor/shadcn/rules/). -4. **Component discovery** — `shadcn docs`, `shadcn search`, MCP, or registries — see vendored SKILL + MCP doc. +3. **Pattern enforcement** — Use [`vendor/shadcn/rules/`](./vendor/shadcn/rules/) for concrete markup checks; the complete official workflow reference is listed below for deeper CLI, registry, and preset questions. +4. **Component discovery** — `shadcn docs`, `shadcn search`, MCP, or registries — see the official workflow reference and MCP doc when deeper context is needed. --- @@ -88,11 +88,11 @@ Vendored: [`vendor/shadcn/mcp.md`](./vendor/shadcn/mcp.md). Live docs: [MCP Serv ## Vendored upstream bundle (deep rules) -Snapshot from [shadcn-ui/ui `skills/shadcn`](https://github.com/shadcn-ui/ui/tree/main/skills/shadcn); revision note in [`vendor/shadcn/UPSTREAM.txt`](./vendor/shadcn/UPSTREAM.txt). +Snapshot from [shadcn-ui/ui `skills/shadcn`](https://github.com/shadcn-ui/ui/tree/main/skills/shadcn); revision note in [`vendor/shadcn/UPSTREAM.txt`](./vendor/shadcn/UPSTREAM.txt). The upstream workflow is stored as a reference file, with its original skill frontmatter removed, so the vendored copy is not discovered as a second local skill. | Doc | Path | | --- | --- | -| Full official skill body | [`vendor/shadcn/SKILL.md`](./vendor/shadcn/SKILL.md) | +| Official shadcn/ui workflow reference | [`vendor/shadcn/official-shadcn-ui-workflow.md`](./vendor/shadcn/official-shadcn-ui-workflow.md) | | CLI reference | [`vendor/shadcn/cli.md`](./vendor/shadcn/cli.md) | | Theming / customization | [`vendor/shadcn/customization.md`](./vendor/shadcn/customization.md) | | MCP | [`vendor/shadcn/mcp.md`](./vendor/shadcn/mcp.md) | @@ -102,4 +102,4 @@ Snapshot from [shadcn-ui/ui `skills/shadcn`](https://github.com/shadcn-ui/ui/tre | Styling | [`vendor/shadcn/rules/styling.md`](./vendor/shadcn/rules/styling.md) | | Base vs Radix | [`vendor/shadcn/rules/base-vs-radix.md`](./vendor/shadcn/rules/base-vs-radix.md) | -**Workflow:** Prefer this **root** `SKILL.md` for repo paths (`web/default`, Bun). Read **`vendor/shadcn/SKILL.md`** for the complete upstream workflow, patterns, and CLI quick reference. Use **`vendor/shadcn/rules/*.md`** when validating concrete markup. +**Workflow:** Prefer this **root** `SKILL.md` for repo paths (`web/default`, Bun). Read **`vendor/shadcn/official-shadcn-ui-workflow.md`** only when you need the complete official component, registry, or preset workflow. Use **`vendor/shadcn/rules/*.md`** when validating concrete markup. diff --git a/.agents/skills/shadcn-ui/vendor/shadcn/UPSTREAM.txt b/.agents/skills/shadcn-ui/vendor/shadcn/UPSTREAM.txt index c065d2e6..aab92e24 100644 --- a/.agents/skills/shadcn-ui/vendor/shadcn/UPSTREAM.txt +++ b/.agents/skills/shadcn-ui/vendor/shadcn/UPSTREAM.txt @@ -1,3 +1,4 @@ Source: https://github.com/shadcn-ui/ui/tree/56161142f1b83f612462772d18883807b5f0d601/skills/shadcn Branch: main Fetched: 2026-04-29 +Local file note: upstream SKILL.md is stored as official-shadcn-ui-workflow.md with its original frontmatter removed to avoid exposing the vendored copy as a separate local skill. diff --git a/.agents/skills/shadcn-ui/vendor/shadcn/cli.md b/.agents/skills/shadcn-ui/vendor/shadcn/cli.md index c3a0f0aa..7e389a17 100644 --- a/.agents/skills/shadcn-ui/vendor/shadcn/cli.md +++ b/.agents/skills/shadcn-ui/vendor/shadcn/cli.md @@ -121,7 +121,7 @@ npx shadcn@latest add button --diff globals.css #### Smart Merge from Upstream -See [Updating Components in SKILL.md](./SKILL.md#updating-components) for the full workflow. +See [Updating Components in official-shadcn-ui-workflow.md](./official-shadcn-ui-workflow.md#updating-components) for the full workflow. ### `search` — Search registries @@ -270,7 +270,7 @@ Three ways to specify a preset via `--preset`: Ask the user first: **overwrite**, **merge**, or **skip** existing components? - **Overwrite / Re-install** → `npx shadcn@latest apply --preset `. Overwrites all detected component files with the new preset styles. Use when the user hasn't customized components. -- **Merge** → `npx shadcn@latest init --preset --force --no-reinstall`, then run `npx shadcn@latest info` to get the list of installed components and use the [smart merge workflow](./SKILL.md#updating-components) to update them one by one, preserving local changes. Use when the user has customized components. +- **Merge** → `npx shadcn@latest init --preset --force --no-reinstall`, then run `npx shadcn@latest info` to get the list of installed components and use the [smart merge workflow](./official-shadcn-ui-workflow.md#updating-components) to update them one by one, preserving local changes. Use when the user has customized components. - **Skip** → `npx shadcn@latest init --preset --force --no-reinstall`. Only updates config and CSS variables, leaves existing components as-is. Always run preset commands inside the user's project directory. `apply` only works in an existing project with a `components.json` file. The CLI automatically preserves the current base (`base` vs `radix`) from `components.json`. If you must use a scratch/temp directory (e.g. for `--dry-run` comparisons), pass `--base ` explicitly — preset codes do not encode the base. diff --git a/.agents/skills/shadcn-ui/vendor/shadcn/customization.md b/.agents/skills/shadcn-ui/vendor/shadcn/customization.md index 16954f56..10843b9a 100644 --- a/.agents/skills/shadcn-ui/vendor/shadcn/customization.md +++ b/.agents/skills/shadcn-ui/vendor/shadcn/customization.md @@ -206,4 +206,4 @@ npx shadcn@latest add button --dry-run # see all affected files npx shadcn@latest add button --diff button.tsx # see the diff for a specific file ``` -See [Updating Components in SKILL.md](./SKILL.md#updating-components) for the full smart merge workflow. +See [Updating Components in official-shadcn-ui-workflow.md](./official-shadcn-ui-workflow.md#updating-components) for the full smart merge workflow. diff --git a/.agents/skills/shadcn-ui/vendor/shadcn/SKILL.md b/.agents/skills/shadcn-ui/vendor/shadcn/official-shadcn-ui-workflow.md similarity index 96% rename from .agents/skills/shadcn-ui/vendor/shadcn/SKILL.md rename to .agents/skills/shadcn-ui/vendor/shadcn/official-shadcn-ui-workflow.md index 016f824d..65289e73 100644 --- a/.agents/skills/shadcn-ui/vendor/shadcn/SKILL.md +++ b/.agents/skills/shadcn-ui/vendor/shadcn/official-shadcn-ui-workflow.md @@ -1,9 +1,6 @@ ---- -name: shadcn -description: 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". -user-invocable: false -allowed-tools: Bash(npx shadcn@latest *), Bash(pnpm dlx shadcn@latest *), Bash(bunx --bun shadcn@latest *) ---- +# Official shadcn/ui Workflow Reference + +Vendored from the upstream shadcn/ui skill. The original skill frontmatter is intentionally removed so this file stays a reference document instead of being discovered as a separate local skill. # shadcn/ui