Shadcn Baseui

What it does

This skill guides AI agents to correctly use Shadcn BaseUI components within React projects, preventing them from suggesting patterns associated with Radix UI. It focuses on ensuring code adheres to Base UI's specific conventions, particularly regarding slot patterns and prop usage. The skill is designed for rapid prototyping and building accessible web applications using the pre-designed components provided by Shadcn BaseUI.

When to use it

• When working on a project that utilizes Shadcn BaseUI components.
• To ensure generated code uses the correct rendering patterns (render props instead of asChild).
• When implementing Accordion components, especially when dealing with single or multiple selection modes.
• When wrapping non-button elements like links within a Button component.

Key capabilities

• Slot Pattern Enforcement: Prioritizes render prop usage over the asChild pattern for trigger/wrapper components (DialogTrigger, PopoverTrigger, etc.).
• Accordion Prop Guidance: Provides correct examples and guidance on using Accordion props, including handling defaultValue in single and multi-mode scenarios.
• Button Native Behavior: Instructs agents to use nativeButton={false} when rendering a Button as a non-button element (e.g., wrapping a <Link>).
• Project Verification: Requires verification that the project is using Base UI by checking for components with a style field starting with "base-" in components.json.

Example prompts

• "Generate a DialogTrigger component wrapped in a Button."
• "Create an Accordion component with multiple open items, initialized to 'item-1' and 'item-2'."
• "Show me how to wrap a Next.js Link inside a Button using Shadcn BaseUI."

Tips & gotchas

• Critical Verification: Before generating any code, the AI agent must verify that it is working with a Base UI project by inspecting components.json and confirming the style field starts with "base-". If not, this skill will produce incorrect results.
• Dependency Requirement: Ensure the @base-ui/react package is installed in your project.
• Render Prop Focus: Always prioritize using render props instead of asChild for trigger components.