$npx -y skills add JasonColapietro/suede-creator-skills --skill suede-designMake Suede interfaces feel intentional: tokens, color, components, type, motion, dark mode, and visual QA for shipped screens.
| 1 | # Suede Design |
| 2 | |
| 3 | ## When to use this skill instead of related skills |
| 4 | - **suede-design** (this skill): design system tokens, color ramps, type scale, component-level polish, brand identity decisions |
| 5 | - Visual iteration with the local script harness (craft, shape, audit sub-commands): (private Suede Labs companion, not in this pack: suede-visual-qa) |
| 6 | - UX critique, accessibility audit, information architecture, design handoff docs: (private Suede Labs companion, not in this pack: suede-ui) |
| 7 | - Broad UI/UX pattern lookup, framework examples, palette/font/chart searches, or non-Suede implementation heuristics: (private Suede Labs companion, not in this pack: ui-ux-pro-max) |
| 8 | - Deck-only or HTML presentation generation: (private Suede Labs companion, not in this pack: power-design) |
| 9 | - **johnny-suede-design**: full-stack build combining design + copy + visual QA for a launch or redesign |
| 10 | |
| 11 | Use this skill to make Suede interfaces feel intentional, premium, legible, and |
| 12 | alive without drifting into generic AI output. It covers product UI, brand |
| 13 | surfaces, landing pages, dashboards, component systems, responsive polish, and |
| 14 | visual QA. |
| 15 | |
| 16 | **Core principle:** strip the logo and the surface must still be unmistakably this product, and render the result before claiming it works. |
| 17 | |
| 18 | ## Operating Stance |
| 19 | |
| 20 | - Work from current source and a rendered screen. Do not design from memory when a repo, live URL, screenshot, or local preview can be checked. |
| 21 | - For Suede branding, use only `docs/assets/suede-ai-logo-transparent.png` from `JasonColapietro/suede-creator-skills` (SHA-256 `83a7ee0317e4debe2e7b076c20ba067feb76a587f9e829dc6310ae4be4b44dfa`). Never redraw, trace, approximate, typeset, recolor, distort, or generate a replacement Suede S. `suede-skill-icon.png` is a Passport icon, not the Suede brand mark. If the approved file is unavailable or its checksum differs, stop and request it; omit the mark rather than improvise. |
| 22 | - Keep Suede public copy anchored in creator ownership, programmable IP, rights, provenance, registry-backed media, royalty routing, and agent commerce. Do not reduce Suede to a generic AI music app. |
| 23 | - Prefer the existing app framework, tokens, components, icon library, and routing patterns. Add a new abstraction only when it removes real complexity or matches an established local pattern. |
| 24 | - For visual work, render the result. Screenshots beat code inspection. Minimum: desktop at 1280px width, mobile at 390px width. For App Store submissions: 1290×2796px (6.7-inch), 1488×2266px (iPad Pro 13-inch). |
| 25 | - To capture the render: `npx playwright screenshot <url> --viewport-size=1280,900 desktop.png` (swap the viewport for mobile/App Store dimensions above; one-time setup: `npx playwright install chromium`), or your environment's built-in preview/screenshot tool if one is available. |
| 26 | |
| 27 | Before any design work, read the surface context: |
| 28 | - Local `PRODUCT.md`: users, brand, tone, anti-references, strategic principles |
| 29 | - Local `DESIGN.md`: color tokens, type scale, component inventory, spacing |
| 30 | - `AGENTS.md`, `AI_HANDOFF.md`, or `README.md`: agent guidance and surface context |
| 31 | |
| 32 | If PRODUCT.md or DESIGN.md is missing on a major surface, note it and proceed with available context. Offer to create them after completing the task. |
| 33 | |
| 34 | Then state this preflight in the working update: |
| 35 | |
| 36 | ```text |
| 37 | SUEDE_DESIGN_PREFLIGHT: target=<repo-or-folder> surface=<route-or-url> register=<brand|product> context=<pass|partial|none> design_system=<loaded|not_found> git=<pass|skipped:reason> render=<pass|pending|skipped:reason> mutation=open |
| 38 | ``` |
| 39 | |
| 40 | For major design work, reusable systems, reference visual matching, App Store |
| 41 | assets, or public launch surfaces, keep `mutation=open` only after these are |
| 42 | known: |
| 43 | |
| 44 | - `PRODUCT.md` or product context status; |
| 45 | - `DESIGN.md` or design-system context status; |
| 46 | - shape brief status for net-new or large redesigns; |
| 47 | - source visual target status when a mock, screenshot, Figma frame, or |
| 48 | reference URL exists; |
| 49 | - rendered implementation status; |
| 50 | - ship blocker status. |
| 51 | |
| 52 | Also apply the shared no-missed gate at |
| 53 | `~/.claude/skills/suede-workflow-skills/references/no-missed-quality-gates.md` |
| 54 | when the work touches copy, design-system, visual QA, Suedify, visibility, or |
| 55 | public launch quality. |
| 56 | (Requires suede-workflow-skills installed from this pack. If not installed, run the Copy Gate, Visual QA Gate, SEO/AEO/AI EO Gate, Design System Gate, and Launch Gate checklists using the criteria in the Implementation Workflow, Ship Gate, and Visual QA Report sections of this skill.) |
| 57 | |
| 58 | ## Task Router |
| 59 | |
| 60 | Choose the smallest path that fits the request. |
| 61 | |
| 62 | - **Clear small fix:** inspect current UI, make the narrow edit, verify render, |
| 63 | and report what changed. |
| 64 | - **Ambiguous or net-new design:** gather context, propose 2-3 approaches with |
| 65 | tradeoffs, recommend one, and get approval before implementation. |