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 |
references/interface-typography.md
View on GitHub# Typography: legibility and resilient content
Keep the existing font family, hierarchy and density unless a concrete failure
or an authorized redesign justifies changing them. One font family, serif body
text, compact UI and fixed type steps can be deliberate. A mandatory font
pairing or scale ratio is not an accessibility standard.
## Trace what is actually rendered
Inspect font-face declarations, loaded files, available weights, fallback
stacks and computed font values. Do not identify a font from a screenshot as
fact without evidence. A requested weight absent from the loaded font can
produce synthesis; establish the actual result before proposing a new asset.
Map heading, body, label, help text and numeric roles to project tokens. Find
where the changed role is used. If one shared caption token makes multiple
forms unreadable, report that cause once and list confirmed consumers.
Check wrapping with real approved content and representative long strings.
Inspect line-height, measure, tracking, zoom and user text-size adaptation;
readability depends on the font and task, not one universal pixel floor. Rem
units and unitless line-height are useful tools, not proof of accessible reflow.
## Match the text to its job
- Hierarchy should make the primary task and supporting facts distinguishable.
Do not enlarge every heading in a dense professional tool to marketing scale.
- Numeric tables, timers and prices may benefit from tabular numerals when
alignment changes cause real scanning difficulty. Use supported font features
in the existing stack rather than loading a new font for one effect.
- Long labels and translated strings need room. Preserve approved words;
correct container sizing or wrapping within scope before trimming meaning.
- Truncation must not conceal a value needed to decide or act. Verify the route
to its full value with keyboard and touch, not only a desktop hover tooltip.
- Confirm language and direction metadata where relevant. Test mixed-direction
values with supported locale behavior instead of manually reordering digits.
- Keep useful content selectable. Any selection suppression needs a concrete
gesture interaction reason, not a site-wide stylistic preference.
For supported mobile browsers, inspect focus/zoom behavior on inputs. If small
text causes unwanted zoom or unreadability, test the smallest change in the
current component. Do not disable user zoom or transform text just to preserve
a small appearance.
## Verify and report
Render at matching desktop/mobile states, plus relevant text resize/reflow
checks. Record the loaded font and measured/computed values only when obtained.
A source `font-family` declaration does not prove that asset loaded, and a
screenshot alone does not prove locale or text-spacing behavior.
Separate standards (see the accessibility reference), project conventions and
optional optical tuning. No automatic punctuation substitution, letter-spacing
reset or font swap belongs in a scoped audit. For an authorized fix, recheck
line breaks, clipping, hierarchy and affected shared consumers after rendering.
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 |