JasonColapietro/suede-creator-skills / skills/suede-design
suede-design
VerifiedUse when asked "review this UI diff" or "audit this flow"; to design interface hierarchy, tokens, color, type, accessibility or a design system; run a whole-flow review; restyle a dashboard; or verify a visual build. NOT FOR: component state workbenches or live variants (use suede-component-lab), source-backed effect explanations (use suede-interface-explain), sales copy (use suede-copy), funnel architecture (use suede-site-alchemy), or general code/security review (use suede-code).
| File | Kind | Size |
|---|---|---|
| CARD.md | markdown | 5.3 KB |
| LICENSE.jakubkrehel-skills-MIT.txt | markdown | 1.0 KB |
| SKILL.md | skill md | 20.8 KB |
| agents/openai.yaml | config | 580 B |
| references/build-delivery.md | markdown | 4.1 KB |
| references/design-laws.md | markdown | 3.8 KB |
| references/interface-accessibility.md | markdown | 3.4 KB |
| references/interface-behavior.md | markdown | 3.4 KB |
| references/interface-color.md | markdown | 2.8 KB |
| references/interface-layout.md | markdown | 3.3 KB |
| references/interface-review.md | markdown | 8.4 KB |
| references/interface-typography.md | markdown | 3.1 KB |
| references/interface-writing.md | markdown | 3.4 KB |
| references/restyle-playbook.md | markdown | 6.0 KB |
| references/scoped-bans.md | markdown | 5.7 KB |
| references/surface-lenses.md | markdown | 3.0 KB |
| references/ui-component-sources.md | markdown | 5.1 KB |
| references/usage-contract.md | markdown | 2.6 KB |
CARD.md
View on GitHub# Skill Card — Suede Design Skills
<!-- Generated by scripts/build-skill-cards.mjs — do not hand-edit. -->
<!-- Regenerate with: npm run build:cards -->
Release record for the `suede-design` skill, following the NVIDIA skill-card template (<https://docs.nvidia.com/skills/skill-cards>). It tells a reviewer what the skill does, who owns it, what it needs, what could go wrong, and what evidence backs the release — without requiring them to open the source first.
## Description
Use when asked \"review this UI diff\" or \"audit this flow\"; to design interface hierarchy, tokens, color, type, accessibility or a design system; run a whole-flow review; restyle a dashboard; or verify a visual build.
Status: production. Ships in the `suede-skills` plugin (the full pack) at release 0.19.4; loads as a Claude Code / Codex agent skill from this directory's [SKILL.md](./SKILL.md).
## Owner
Jason Colapietro, Suede (<https://github.com/JasonColapietro>). Security contact: `info@suedeai.ai` per [SECURITY.md](../../SECURITY.md).
## License / Terms of Use
Pack license: MIT ([LICENSE](../../LICENSE)). This skill additionally bundles third-party licensed material — see [`LICENSE.jakubkrehel-skills-MIT.txt`](./LICENSE.jakubkrehel-skills-MIT.txt) in this directory. The pack's combined license expression is `MIT AND BSD-3-Clause`.
## Use Case
Target users: developers and creators running the skill inside a Claude Code or Codex CLI session.
Use when asked \"review this UI diff\" or \"audit this flow\"; to design interface hierarchy, tokens, color, type, accessibility or a design system; run a whole-flow review; restyle a dashboard; or verify a visual build.
Out of scope — component state workbenches or live variants (use suede-component-lab), source-backed effect explanations (use suede-interface-explain), sales copy (use suede-copy), funnel architecture (use suede-site-alchemy), or general code/security review (use suede-code).
## Deployment Geography
Global. The skill is a prompt-and-script package that runs locally inside the invoking agent session; it pins no region-specific service of its own.
## Requirements / Dependencies
- A Claude Code or Codex CLI session with the `suede-skills` plugin installed (install options: <https://skills.suedeai.ai/>).
- Bundled files loaded relative to this directory: `agents/` (1 file), `references/` (14 files).
- Credentials: none are bundled or required by the skill files. Any tool or API credentials come from the host session; never paste credentials into skill files, prompts, or outputs.
## Known Risks and Mitigations
- Risk: an agent treats a quality gate as autonomous authority. Mitigation: every gate in the pack is advisory — it changes what is reported, never what the user decided; only extreme-risk findings (data loss, credential exposure, legal/rights violations, payment mistakes, irreversible public damage) pause for the user's explicit choice.
- Risk: a skill instruction is used to act outside its mandate. Mitigation: the hard limits in the skill body's "Boundaries" section, quoted below.
From "Boundaries":
- Preserve WIP. Audit requests are read-only; fixes stay within the named scope.
- Use local, synthetic state data and non-mutating seams. No live payments, bookings, leads, analytics, email, credentials or customer records in fixtures.
- Keep fixture routes dev-only and excluded from production artifacts; remove only owned harness files when their purpose ends. Use suede-component-lab.
- Optional visual-kit lane: only a user-selected authoritative kit for an applicable marketing asset. Inspect its original pixels before deriving an image-specific contract. Do not impose a kit on unrelated UI, copy surrounding social-platform chrome, transfer certification/safety claims, or publish private kit identifiers and originals. If originals are inaccessible, report that gap and continue independent work without guessing.
- Never copy protected site assets, exact copy, proprietary code, or trademarked identity during a restyle.
- Never invent metrics, pricing, partners, testimonials, legal clearance, or release outcomes.
- Never call work done until the done signal has been checked or the remaining gap is named.
## References
- Skill source: [`skills/suede-design/SKILL.md`](./SKILL.md)
- Rendered reference page: <https://skills.suedeai.ai/skills/suede-design.html>
- Security policy and reviewed scanner exceptions: [SECURITY.md](../../SECURITY.md) and [`.plugin-scanner.toml`](../../.plugin-scanner.toml) at the repo root
## Skill Output
Structured Markdown returned in the agent's response, shaped by the output contract defined in the skill body: "Output". The skill publishes, posts, and sends nothing without the user's explicit authorization; delivery decisions stay with the user.
## Skill Version
0.19.4 — the pack is single-versioned, so every skill releases together; see [VERSION](../../VERSION) and [CITATION.cff](../../CITATION.cff) for the release identifier this card describes.
## Ethical Considerations
- The skill produces recommendations for a human decision-maker. Publishing, sending, payment, and rights decisions stay with the user.
- Its gates require verifiable claims and honest reporting; do not use the skill to fabricate claims, evidence, metrics, or attribution.
- Report suspected misuse or a security concern privately per [SECURITY.md](../../SECURITY.md); do not open a public issue for it.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |