- name
>
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add paperclipai/paperclip --skill design-guide -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add paperclipai/paperclip --skill design-guide -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add paperclipai/paperclip --skill design-guide -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add paperclipai/paperclip --skill design-guide -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/paperclipai/paperclip/tree/HEAD/.claude/skills/design-guideFrom the publisher
Paperclip's UI is a professional-grade control plane — dense, keyboard-driven, dark-themed by default. Every pixel earns its place.
Always use with: frontend-design (visual polish) and web-design-guidelines (web best practices).
cn() utilityConfig: ui/components.json (aliases: @/components, @/components/ui, @/lib, @/hooks)
All tokens defined as CSS variables in ui/src/index.css. Both light and dark themes use OKLCH.
Use semantic token names, never raw color values:
Single --radius variable (0.625rem) with derived sizes:
rounded-sm — small inputs, pillsrounded-md — buttons, inputs, small componentsrounded-lg — cards, dialogsrounded-xl — card containers, large componentsrounded-full — badges, avatars, status dotsMinimal shadows: shadow-xs (outline buttons), shadow-sm (cards). No heavy shadows.
Use these exact patterns — do not invent new ones:
Defined in StatusBadge.tsx and StatusIcon.tsx:
Defined in PriorityIcon.tsx: critical (red/AlertTriangle), high (orange/ArrowUp), medium (yellow/Minus), low (blue/ArrowDown).
Inline colored dots: running (cyan, animate-pulse), active (green), paused (yellow), error (red), offline (neutral).
Three tiers:
ui/src/components/ui/) — Button, Card, Input, Badge, Dialog, Tabs, etc. Do not modify these directly; extend via composition.ui/src/components/) — StatusBadge, EntityRow, MetricCard, etc. These capture Paperclip-specific design language.ui/src/pages/) — Compose primitives and composites into full views.See references/component-index.md for the complete component inventory with usage guidance.
Create a reusable component when:
Do NOT create a component for:
These patterns describe how components work together. They may not be their own component, but they must be used consistently across the app.
The standard list item for issues and similar entities:
<EntityRow
leading={<><StatusIcon status="in_progress" /><PriorityIcon priority="high" /></>}
identifier="PAP-001"
title="Implement authentication flow"
subtitle="Assigned to Agent Alpha"
trailing={<StatusBadge status="in_progress" />}
onClick={() => {}}
/>
Leading slot always: StatusIcon first, then PriorityIcon. Trailing slot: StatusBadge or timestamp.
Issues grouped by status header + entity rows:
<div className="flex items-center gap-2 px-4 py-2 bg-muted/50 rounded-t-md">
<StatusIcon status="in_progress" />
<span className="text-sm font-medium">In Progress</span>
<span className="text-xs text-muted-foreground ml-1">2</span>
</div>
<div className="border border-border rounded-b-md">
<EntityRow ... />
<EntityRow ... />
</div>
Key-value pairs in properties panels:
<div className="flex items-center justify-between py-1.5">
<span className="text-xs text-muted-foreground">Status</span>
<StatusBadge status="active" />
</div>
Label is always text-xs text-muted-foreground, value on the right. Wrap in a container with space-y-1.
Dashboard metrics in a responsive grid:
<div className="grid md:grid-cols-2 xl:grid-cols-4 gap-4">
<MetricCard icon={Bot} value={12} label="Active Agents" description="+3 this week" />
...
</div>
Color by threshold: green (<60%), yellow (60-85%), red (>85%):
<div className="w-full h-2 bg-muted rounded-full overflow-hidden">
<div className="h-full rounded-full bg-green-400" style={{ width: `${pct}%` }} />
</div>
Author header (name + timestamp) then body, in bordered cards with space-y-3. Add comment textarea + button below.
Standard <table> with text-xs, header row with bg-accent/20, font-mono for numeric values.
bg-neutral-950 rounded-lg p-3 font-mono text-xs container. Color lines by level: default (foreground), WARN (yellow-400), ERROR (red-400), SYS (blue-300). Include live indicator dot when streaming.
hover:bg-accent/50hover:bg-accent/50 hover:text-accent-foregroundbg-accent text-accent-foregroundfocus-visible:ring-ring focus-visible:ring-[3px] — standard Tailwind focus-visible ring.
disabled:opacity-50 disabled:pointer-events-none
Use InlineEditor component — click text to edit, Enter saves, Escape cancels.
StatusIcon and PriorityIcon use Radix Popover for inline selection. Follow this pattern for any clickable property that opens a picker.
Three-zone layout defined in Layout.tsx:
┌──────────┬──────────────────────────────┬──────────────────────┐
│ Sidebar │ Breadcrumb bar │ │
│ (w-60) ├──────────────────────────────┤ Properties panel │
│ │ Main content (flex-1) │ (w-80, optional) │
└──────────┴──────────────────────────────┴──────────────────────┘
w-60, collapsible, contains CompanySwitcher + SidebarSectionsw-80, shown on detail views, hidden on listsflex-1Location: ui/src/pages/DesignGuide.tsx
Route: /design-guide
This is the living showcase of every component and pattern in the app. It is the source of truth for how things look.
<Section title="..."> wrapper with <SubSection> for grouping.<Section title="My New Component">
<SubSection title="Variants">
{/* Show all variants */}
</SubSection>
<SubSection title="Sizes">
{/* Show all sizes */}
</SubSection>
<SubSection title="States">
{/* Show interactive/disabled states */}
</SubSection>
</Section>
See references/component-index.md for the full component inventory.
When you create a new reusable component:
ui/src/components/ui/{component}.tsx — lowercase, kebab-caseui/src/components/{ComponentName}.tsx — PascalCaseui/src/pages/{PageName}.tsx — PascalCaseui/src/lib/{name}.tsui/src/hooks/{useName}.tsui/src/api/{entity}.tsui/src/context/{Name}Context.tsxAll components use cn() from @/lib/utils for className merging. All components use CVA for variant definitions when they have multiple visual variants.
shadow-md or heavier — keep shadows minimal (xs, sm only)rounded-2xl or larger — max is rounded-xl (except rounded-full for pills)© 2026 Skills Rack.
---name: design-guidedescription: >---# .claude/skills/design-guide/SKILL.mdFAQ
Download .claude/skills/design-guide/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/paperclipai/paperclip.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.