One-click install
npx skills add https://github.com/telegraphic-dev/paperclip-deploy --skill design-guide-telegraphic-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-guide
Source: https://github.com/telegraphic-dev/paperclip-deploy/tree/main/.claude/skills/design-guide
Command: npx skills add https://github.com/telegraphic-dev/paperclip-deploy --skill design-guide-telegraphic-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves inconsistent UI styling and component fragmentation by providing a single source of truth for Paperclip’s design system, component hierarchy, and interaction patterns.

Core Features & Use Cases

  • Design system alignment: Use semantic tokens, typography scale, spacing, radius, and shadows so new UI matches Paperclip’s look and behavior.
  • Reusable component guidance: Follow rules for when to create composites vs. when to compose existing primitives (and keep shadcn/ui untouched).
  • Consistent interaction and layout patterns: Apply established status/priority systems, entity-row composition, and the app’s three-zone layout so features feel native.
  • Use Case: When adding a new page or feature in the control plane (e.g., agent/issue details or a list view), use this guide to implement it with correct tokens, components, and conventions rather than inventing one-off styles.

Quick Start

Ask your AI to apply the Paperclip UI design guide when implementing a new frontend UI component for the control plane, and ensure it follows the established tokens, typography patterns, component tiers, and status/priority composition rules.

Frequently Asked Questions about design-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain UI design consistency when building new React components?

Maintain UI design consistency by applying a centralized design system that defines semantic CSS-variable tokens, typography scales, and standardized component hierarchy rules for React. This ensures every new component matches established visual patterns and interaction behaviors without inventing one-off styles.

How do I standardize status badges and priority levels in a React UI?

Standardize status badges and priority levels by implementing semantic status rendering rules and entity-row composition patterns. This approach ensures consistent visual representation of priority-driven lists and panels across the entire application interface.

Can I use shadcn/ui primitives directly when creating composite UI components?

Yes, you can compose existing shadcn/ui primitives, but you should keep the base shadcn/ui components untouched. The guide establishes clear rules for when to create composites versus composing existing primitives to prevent component fragmentation.

How do I apply design tokens and Tailwind tokens for frontend component styling?

Apply design tokens and Tailwind tokens by using CSS-variable token usage conventions for spacing, radius, and shadows. This enforces design system alignment and ensures new UI matches the application's look and behavior.

Why does my new frontend page layout feel inconsistent with the rest of the control plane?

Your layout feels inconsistent if it ignores the app's established three-zone layout rules and component tier conventions. Apply the standardized layout patterns to ensure features feel native to the control plane interface.

Do I need Radix and CVA conventions to build consistent TypeScript UI components?

Yes, you need Radix, CVA, and classname utility conventions to build consistent TypeScript UI components. The design system requires adherence to these specific utility conventions to maintain proper component composition and styling standards.