johnny-suede-design

Builds landing pages, product UI, and brand surfaces with integrated design, copy, and visual QA.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Designing and shipping a web surface usually splits into disconnected passes: a designer picks tokens, a copywriter fills in words later, and QA happens after the fact, producing generic layouts, placeholder copy, and unverified renders. This Skill runs design, copy, and visual QA as one coordinated pass so a surface ships with layout, words, and rendered evidence together. ## Core Features & Use Cases - Lane routing and surface classification: Routes work into Design, Suedify (reference-to-target restyle), Copy, or multi-agent team lanes, and classifies the surface register (brand, product, docs, campaign, mobile) before any design decision. - Design laws and token systems: Applies dark-mode token values, fluid type scales, component laws, motion timing specs, and scoped bans on generic patterns, with a 100-point design-system audit score. - Copy with proof discipline: Writes headlines, CTAs, email, and social copy using formula banks and persona modes, with hard rules against invented metrics, testimonials, or partner claims. - Visual QA and ship gates: Captures Playwright screenshots at desktop and mobile widths, compares source targets against implementations, and produces visual-qa-report.md plus ship/ship-with-caveats/hold verdicts. - Use Case: Ask it to restyle your landing page to match a reference site's look: it captures both sites, extracts a token map into DESIGN.md, rewrites the hero and copy in your brand voice, renders the result, and reports remaining mismatches. ## Quick Start Use $johnny-suede-design to redesign my landing page at this repo path, running the design, copy, and visual QA lanes and showing me rendered screenshots before shipping.

Frequently Asked Questions about johnny-suede-design

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

FAQPage Schema
How do I make my website look like another site's design?

Use the Suedify lane with a reference URL and target URL. It captures screenshots of both sites, extracts the reference's design tokens into a DESIGN.md file, reimplements the visual grammar with your own brand and assets, then renders and compares the result before shipping.

How do I run visual QA on a web page implementation?

Capture screenshots with npx playwright screenshot at 1280px desktop and 390px mobile widths, then compare the source target and implementation in the same pass. The skill saves a visual-qa-report.md with P0-P3 severity findings and a passed or blocked verdict.

Can this skill write landing page copy as well as design it?

Yes, writing mode is on by default and a surface is not considered finished until the copy carries it. It uses headline formulas, CTA formulas, persona modes, and word substitution rules, and refuses to invent metrics, testimonials, or partner claims.

Does it copy code or assets from a reference website?

No. The Suedify lane recreates layout proportions, type rhythm, color roles, and motion character, but never copies logos, exact marketing copy, proprietary source code, private assets, or the reference's claims and pricing.

When should I use a smaller skill instead of this full stack?

Drop down for single-lane jobs: use suede-design for a token or single-component decision, johnny-suede-write or suede-copy for copy with no layout work, and suede-site-alchemy for conversion funnel architecture. Running the full stack on a one-lane job wastes tokens.

Will the skill block my work if a quality gate fails?

No. Every gate is advisory: it changes what gets reported, never what gets done. The only exception is extreme-risk findings like data loss, credential exposure, or legal violations, where it pauses and lets you decide.