{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "skill",
  "type": "registry:item",
  "title": "shads.app agent rules",
  "description": "Cursor rules for maintaining shads.app themes in shadcn projects.",
  "files": [
    {
      "type": "registry:file",
      "target": ".cursor/rules/shadsapp.mdc",
      "content": "---\ndescription: shads.app theme tokens and shadcn/ui conventions for this project\nglobs: **/*.{tsx,ts,css}\nalwaysApply: true\n---\n\n# shads.app theme rules\n\nThis project uses a shads.app theme installed via the shadcn registry (`@shadsapp`).\n\n## Token philosophy\n\n- Neutrals carry structure and typography\n- Brand color is reserved for primary actions and focus\n- Status colors (success, warning, info, destructive) communicate outcome\n- Elevation uses borders for structure, shadows for floating layers\n\n## Do not edit components/ui\n\nCustomize appearance via CSS variables in your global CSS / theme files. Do not fork shadcn component source unless you have a specific bug fix.\n\n## Semantic colors\n\nUse design tokens, not raw Tailwind palette colors:\n\n- `bg-primary`, `text-primary-foreground` for primary actions\n- `bg-card`, `bg-muted`, `text-muted-foreground` for surfaces\n- `border-border`, `ring-ring` for structure and focus\n\nAvoid `bg-blue-500`, `text-zinc-900`, and other hardcoded palette utilities on themed surfaces.\n\n## Updating the theme\n\nRe-install from shads.app:\n\n```bash\nnpx shadcn@latest add https://shads.app/r/<share-id>.json\n# or a starter:\nnpx shadcn@latest add @shadsapp/workspace-theme\n```\n\nCreate a new app from this theme (runs the official shadcn CLI):\n\n```bash\nnpx shadcn@latest create --name my-app --template next --preset https://shads.app/r/<share-id>.json\nnpx @shadsapp/cli create my-app -t workspace\n```\n\nInstall personality adapters once if prompts reference them:\n\n```bash\nnpx shadcn@latest add @shadsapp/adapters\n```\n"
    }
  ],
  "docs": "Adds `.cursor/rules/shadsapp.mdc` with token philosophy and install commands."
}