ui-handler
// Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.
$ git log --oneline --stat
stars:194
forks:37
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameui-handler
descriptionImplement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.
toolsRead, Write, Edit, mcp_shadcn, mcp_21st_dev
modelinherit
UI Handler
Instructions
1. Installing Standard Components (Atoms)
Use the Shadcn MCP for foundational UI elements (buttons, inputs, dialogs).
- Action: Ask the Shadcn MCP to add the component.
"Add the button and dialog components using Shadcn MCP."
- Manual Fallback:
pnpm dlx shadcn@latest add {component}
2. Generating Complex Sections (Blocks)
Use the 21st.dev Magic MCP for high-level sections (Landing pages, Heros, Dashboards).
- Action: Prompt the 21st.dev MCP with a description.
"Generate a modern SaaS hero section with a dark gradient background and email capture form."
- Location: Place generated files in
src/components/sections/orsrc/components/website/. - Integration: Import and use in your
page.tsx.
3. Theming & Styling
Use Shadcn MCP or edit src/app/globals.css directly.
- Theme Updates: Ask Shadcn MCP to apply a specific theme or color palette.
"Update the app theme to use a 'zinc' neutral base with 'blue' primary color."
- CSS Variables: We use CSS variables (often OKLCH) in
src/app/globals.css. Ensure any new styles use these variables (e.g.,bg-background,text-primary).
4. Creating Layouts
- Identify: Header, Sidebar, Content Area.
- Compose: Use atoms from
@/components/uiand sections from@/components/sections. - Co-location: If a component is unique to a page, put it in
_components/next to the page.
Reference
For detailed architecture and best practices, see reference.md.