Tailwind Shadcn
Designtailwind-shadcnTailwind Shadcn is an Agent Skill for design published in the BlackBeltTechnology/pi-agent-dashboard repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Tailwind CSS utility patterns with shadcn/ui component usage, theming via CSS variables, and responsive design. Use when styling components, installing shadcn components, implementing dark mode, or creating consistent design systems.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/BlackBeltTechnology/pi-agent-dashboard/blob/HEAD/.pi/skills/tailwind-shadcn/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/tailwind-shadcn, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Tailwind CSS + shadcn/ui
shadcn/ui Installation
Components live in your codebase, not as dependencies:
# Initialize shadcn
npx shadcn@latest init
# Add individual components
npx shadcn@latest add button
npx shadcn@latest add card
npx shadcn@latest add form
npx shadcn@latest add input
npx shadcn@latest add accordion
npx shadcn@latest add dialog
npx shadcn@latest add dropdown-menu
npx shadcn@latest add tabs
Component Usage
import { Button } from '@/components/ui/button';
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
import {
Accordion,
AccordionContent,
AccordionItem,
AccordionTrigger,
} from '@/components/ui/accordion';
// Button variants
<Button>Default</Button>
<Button variant="secondary">Secondary</Button>
<Button variant="outline">Outline</Button>
<Button variant="ghost">Ghost</Button>
<Button variant="destructive">Destructive</Button>
<Button size="sm">Small</Button>
<Button size="lg">Large</Button>
// Card composition
<Card>
<CardHeader>
<CardTitle>Title</CardTitle>
</CardHeader>
<CardContent>Content here</CardContent>
</Card>
CSS Variables Theming
/* globals.css */
@tailwind base;
@tailwind components;
@tailwind utilities;
@layer base {
:root {
--background: 0 0% 100%;
--foreground: 0 0% 3.9%;
--primary: 0 0% 9%;
--primary-foreground: 0 0% 98%;
--secondary: 0 0% 96.1%;
--muted: 0 0% 96.1%;
--accent: 0 0% 96.1%;
--border: 0 0% 89.8%;
--ring: 0 0% 3.9%;
--radius: 0.5rem;
}
[data-theme="earth"] {
--background: 40 20% 98%;
--foreground: 30 10% 15%;
--primary: 30 30% 35%;
--accent: 35 25% 90%;
}
}
Responsive Design
// Mobile-first approach
<div className="
px-4 md:px-6 lg:px-8 // Padding scales up
text-sm md:text-base lg:text-lg // Font size scales
grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 // Grid columns
flex flex-col md:flex-row // Stack to row
hidden md:block // Show on md+
md:hidden // Hide on md+
">
// Container pattern
<div className="container mx-auto px-4 md:px-6">
{children}
</div>
Common Utility Patterns
// Flexbox centering
<div className="flex items-center justify-center">
// Grid with gap
<div className="grid grid-cols-1 md:grid-cols-3 gap-4 md:gap-6">
// Spacing
<div className="space-y-4"> // Vertical spacing between children
<div className="space-x-4"> // Horizontal spacing
// Typography
<h1 className="text-3xl md:text-4xl lg:text-5xl font-bold tracking-tight">
<p className="text-muted-foreground text-sm leading-relaxed">
// Hover/Focus states
<button className="
hover:bg-primary/90
focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2
transition-colors
">
// Aspect ratio
<div className="aspect-video relative overflow-hidden rounded-lg">
<Image fill className="object-cover" />
</div>
Form with shadcn/ui
import { zodResolver } from '@hookform/resolvers/zod';
import { useForm } from 'react-hook-form';
import {
Form,
FormControl,
FormField,
FormItem,
FormLabel,
FormMessage,
} from '@/components/ui/form';
import { Input } from '@/components/ui/input';
<Form {...form}>
<form onSubmit={form.handleSubmit(onSubmit)} className="space-y-4">
<FormField
control={form.control}
name="email"
render={({ field }) => (
<FormItem>
<FormLabel>Email</FormLabel>
<FormControl>
<Input placeholder="[email protected]" {...field} />
</FormControl>
<FormMessage />
</FormItem>
)}
/>
<Button type="submit">Submit</Button>
</form>
</Form>
cn() Utility
// lib/utils.ts
import { type ClassValue, clsx } from 'clsx';
import { twMerge } from 'tailwind-merge';
export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs));
}
// Usage - merge classes conditionally
<div className={cn(
'base-classes',
isActive && 'active-classes',
className // Allow override from props
)}>
Animation Classes
// Built-in transitions
<div className="transition-all duration-300 ease-in-out">
<div className="transition-colors duration-200">
<div className="transition-transform hover:scale-105">
// Tailwind animations
<div className="animate-pulse"> // Loading skeleton
<div className="animate-spin"> // Spinner
<div className="animate-bounce"> // Bounce effect
Dark Mode
// Toggle dark class on html element
<html className="dark">
// Use dark: prefix
<div className="bg-white dark:bg-gray-900">
<p className="text-gray-900 dark:text-gray-100">