Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From designkit
Launches browser-based UI companion with Comment, Inspect, and Tune tools for prototyping HTML/CSS designs, annotating elements, tuning properties, and iterating with Claude feedback.
npx claudepluginhub leroybbad/designkit --plugin designkitHow this skill is triggered — by the user, by Claude, or both
Slash command
/designkit:designkitThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
A browser-based design refinement tool. Launches a local server that renders prototypes and gives designers hands-on tools to annotate, inspect, and tune visual properties — then sends structured feedback to Claude for the next iteration.
Guides technical evaluation of code review feedback: read fully, restate for understanding, verify against codebase, respond with reasoning or pushback before implementing.
Share bugs, ideas, or general feedback.
A browser-based design refinement tool. Launches a local server that renders prototypes and gives designers hands-on tools to annotate, inspect, and tune visual properties — then sends structured feedback to Claude for the next iteration.
skills/designkit/scripts/start-server.sh --project-dir /path/to/project
Returns JSON with screen_dir, state_dir, and url. Save all three.
Tell the user to open the URL. Remind them of the keyboard shortcuts:
Write HTML files to screen_dir. The server serves the newest file by modification time.
Content fragments (no <!DOCTYPE or <html>) are automatically wrapped in the companion frame template. Use for simple mockups.
Full documents are extracted — their <style> and <body> content are pulled into the frame. The companion chrome (toolbar, menus) always appears. Use for complete page designs.
Every prototype MUST follow these rules:
Use CSS classes, not inline styles. Elements need semantic classes like .metric-card, .nav-link, .chart-section. The Tune panel's "Apply to all matching" finds siblings by class. Inline styles make every element unique and break this.
Use CSS custom properties (tokens) for design values. The Tune panel detects tokens and adjusts them on :root so changes cascade globally. Hardcoded values only affect one element.
Semantic class names. Classes describe what the element IS (.metric-card) not what it looks like (.p-4.bg-white). This makes annotation selectors meaningful.
These are the most common tells of AI-generated UI. Avoid all of them:
No emoji icons. Never use 📊 📋 🔍 or any emoji as UI icons. Use Lucide icons instead. Include this in the <head>:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/lucide-static@latest/font/lucide.min.css">
Then use: <i class="lucide-chart-bar"></i>, <i class="lucide-search"></i>, etc.
Tight page headers. Don't waste 1/3 of the screen on a page title with massive padding. The page heading, action buttons, and any breadcrumbs should sit in a compact row with minimal vertical padding. padding: 0.75rem 0 max on the header row.
No orphaned whitespace. Every section should feel intentionally spaced. If there's a gap between a heading and content, or between the nav and the page body, it should be a deliberate rhythm (e.g. --space-md everywhere), not random large gaps.
Body text at 16px (1rem). Use --font-base: 1rem for body/table content. Reserve --font-sm: 0.875rem for secondary labels and metadata. Never set --font-base below 0.875rem.
Consistent text hierarchy. Navigation text, body text, and metadata should each have a clearly distinct size. Don't put tiny 11px text next to 16px text — it looks accidental. Use the token scale: --font-xs for labels, --font-sm for secondary, --font-base for body, --font-lg for headings.
Dense layouts earn their density. If you're building a table or dashboard, make it genuinely information-dense — not just a few items with lots of padding. Either fill the space with useful content or tighten the layout to fit its content.
Token block template — include at the top of every prototype's <style>:
:root {
/* Colors */
--color-primary: #4f46e5;
--color-primary-hover: #4338ca;
--color-bg: #f4f5f7;
--color-surface: #ffffff;
--color-border: #e5e7eb;
--color-text: #1a1a2e;
--color-text-secondary: #6b7280;
--color-text-tertiary: #9ca3af;
--color-success: #059669;
--color-warning: #d97706;
--color-danger: #dc2626;
/* Spacing */
--space-xs: 0.25rem;
--space-sm: 0.5rem;
--space-md: 1rem;
--space-lg: 1.5rem;
--space-xl: 2rem;
/* Typography */
--font-xs: 0.75rem;
--font-sm: 0.875rem;
--font-base: 1rem;
--font-lg: 1.25rem;
--font-xl: 1.5rem;
/* Shape */
--radius-sm: 6px;
--radius-md: 10px;
--shadow-sm: 0 1px 3px rgba(0,0,0,0.08);
--shadow-md: 0 4px 12px rgba(0,0,0,0.08);
}
Adjust token values to match the design direction. The token names should stay consistent so the Tune panel can find and adjust them.
Example — correct:
<style>
:root { --space-md: 1rem; --radius-md: 10px; --color-surface: #fff; }
.metric-card {
padding: var(--space-md);
border-radius: var(--radius-md);
background: var(--color-surface);
}
</style>
<div class="metric-card">
<h3 class="metric-label">Revenue</h3>
<p class="metric-value">$48,250</p>
</div>
Example — wrong (breaks tools):
<div style="padding: 1rem; border-radius: 10px; background: #fff;">
<h3 style="font-size: 0.7rem;">Revenue</h3>
<p style="font-size: 1.75rem;">$48,250</p>
</div>
dashboard.html, client-detail.html, settings-page.htmldashboard-v2.html, dashboard-v3.htmlAfter the user sends changes (via the Send button or Shift+Cmd+Enter), read the events file:
$STATE_DIR/events
The file contains JSONL — one JSON object per line. Two types:
{"type":"annotation","id":"ann-123","selector":".metric-card:nth-of-type(2) > .metric-value","tag":"p","text":"$48,250","note":"too large, try 1.5rem","status":"new","timestamp":1749000001}
selector — CSS path to the element from #claude-contenttag + text — human-readable element identitynote — the designer's feedback{"type":"tune","selector":".metric-card","tag":"div","text":"Revenue...","changes":{"padding":"12px","borderRadius":"8px"},"tokenChanges":{"--space-md":"0.75rem","--radius-md":"8px"},"timestamp":1749000002}
changes — inline style changes applied to the elementtokenChanges — CSS custom property changes applied to :root (these cascade globally)Processing feedback:
tokenChanges to the :root token block, apply changes as inline overrides where neededdashboard-v2.html)screen_dir following authoring standards$STATE_DIR/eventsEach iteration is a clean slate. The events file is cleared when a new screen is pushed. Don't persist annotation state across iterations.
skills/designkit/scripts/stop-server.sh $SESSION_DIR
Mockup files persist in .designkit/sessions/ under the project directory for later reference.