suede-design

Designs, restyles, and audits interfaces using design tokens, OKLCH color, and rendered visual QA.

123|10|Updated May 24, 2026
One-click install
npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill suede-design-jasoncolapietro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: suede-design
Source: https://github.com/JasonColapietro/suede-creator-skills/tree/main/skills/suede-design
Command: npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill suede-design-jasoncolapietro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Interfaces built by AI agents often look templated and generic, and code that reads correctly frequently renders incorrectly. This Skill applies concrete design laws (color strategy, type scale, spacing, motion, component rules) and enforces screenshot-based visual QA so design work is verified against rendered output rather than assumed from code. ## Core Features & Use Cases - Design system work: define and audit design tokens, OKLCH color ramps, fluid type scales, dark mode rules, spacing, and component laws, with a 100-point scoring rubric for design-system audits. - Scoped bans and exceptions: an authoritative list of banned patterns (gradient text, decorative glass panels, icon-card grids, fake metrics) with allowed exceptions and required replacements. - Source-to-implementation visual QA: compare a mock, Figma frame, or reference screenshot against the rendered implementation using Playwright screenshots at desktop (1280px) and mobile (390px) widths, producing a visual-qa-report.md with P0-P3 findings. - Use Case: Ask the agent to restyle a dashboard page. It reads PRODUCT.md and DESIGN.md, states a preflight, applies the design laws, renders desktop and mobile screenshots, and ends with a ship gate verdict of ship, ship-with-caveats, or hold. ## Quick Start Use the suede-design skill to audit and restyle the settings page in this repo, then show me desktop and mobile screenshots of the result.

Frequently Asked Questions about suede-design

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

FAQPage Schema
How do I verify a UI redesign actually renders correctly?

Render the page and capture screenshots instead of trusting code inspection. The skill uses npx playwright screenshot with viewport sizes of 1280px for desktop and 390px for mobile, then compares the render against the intended design before reporting completion.

How to compare a Figma frame or mock against a live implementation?

Run a source-to-implementation visual QA pass: capture the rendered implementation at the same viewport as the source target and compare both in a single pass, never from memory. Save findings in visual-qa-report.md ordered by P0/P1/P2/P3 severity with a final passed or blocked result.

What design patterns does this skill ban by default?

It bans gradient text, decorative glass panels, generic gradient-mesh backgrounds, icon-card grids as page structure, first-order category palettes, and fake metrics or testimonials. The first five allow scoped exceptions for source fidelity, platform convention, accessibility, brand systems, or direct user requests; fake metrics allow none.

Does the skill support dark mode design rules?

Yes. It defines specific dark mode laws: surface lightness between 10-18 OKLCH, border-based elevation instead of shadows, 7:1 contrast for body text, and 15-25% chroma reduction for saturated colors. Semantic tokens must define both light and dark values at design time.

When should I not use this design skill?

Do not use it for full design-plus-copy builds or reference-to-target restyles (routed to johnny-suede-design), conversion funnel architecture (suede-site-alchemy), or writing copy itself (suede-copy). It focuses on visual design, tokens, and rendered QA only.

Can I import third-party components like shadcn/ui with this skill?

Yes, through a vetted registry table covering shadcn/ui, beUI, Rare UI, and Transitions.dev. Each import must pass an adoption checklist: local-first check, retokenization to local tokens, motion law compliance, license verification, and a rendered proof at desktop and mobile widths.