Skip to content

lidge-jun/codexclaw / plugins/codexclaw/skills/dev-frontend

cxc-dev-frontend

Unverified

Use for frontend code and UI fixes. Triggers: CSS, responsive, animation, React, Vue, Svelte, Tailwind, redesign, anti-slop, 프론트엔드, UI 작업, 반응형, 디자인 수정.

FileKindSize
SKILL.mdskill md4.1 KB
agents/openai.yamlconfig169 B
examples/README.mdmarkdown2.6 KB
references/core/a11y-patterns.mdmarkdown5.9 KB
references/core/aesthetics.mdmarkdown16.9 KB
references/core/anti-slop-enforcement.mdmarkdown6.1 KB
references/core/anti-slop.mdmarkdown27.1 KB
references/core/asset-requirements.mdmarkdown24.3 KB
references/core/backend-contracts.mdmarkdown1.9 KB
references/core/brand-asset-sourcing.mdmarkdown4.0 KB
references/core/color-system.mdmarkdown5.7 KB
references/core/consistency-locks.mdmarkdown850 B
references/core/content-surface-pipeline.mdmarkdown7.2 KB
references/core/crud-ui.mdmarkdown2.5 KB
references/core/design-intake.mdmarkdown4.4 KB
references/core/dropdown-layer.mdmarkdown5.8 KB
references/core/i18n-global.mdmarkdown3.1 KB
references/core/implementation.mdmarkdown4.1 KB
references/core/iterative-design.mdmarkdown4.4 KB
references/core/korea-2026.mdmarkdown8.8 KB
references/core/layout-discipline.mdmarkdown10.6 KB
references/core/liquid-glass.mdmarkdown8.5 KB
references/core/logo-sections.mdmarkdown5.5 KB
references/core/mobile-ux.mdmarkdown6.1 KB
references/core/motion.mdmarkdown41.4 KB
references/core/performance-budget.mdmarkdown4.4 KB
references/core/platform-runtime.mdmarkdown5.0 KB
references/core/preflight-full.mdmarkdown4.0 KB
references/core/product-density.mdmarkdown1.9 KB
references/core/prototype-variants.mdmarkdown2.2 KB
references/core/reference-capture.mdmarkdown5.5 KB
references/core/render-grounding.mdmarkdown494 B
references/core/responsive-viewport.mdmarkdown5.4 KB
references/core/role-boundaries.mdmarkdown1.3 KB
references/core/routing-defaults.mdmarkdown943 B
references/core/section-level-sourcing.mdmarkdown8.7 KB
references/core/seo-baseline.mdmarkdown4.4 KB
references/core/soft-3d-asset-gates.mdmarkdown2.1 KB
references/core/theme-switching.mdmarkdown2.1 KB
references/core/token-source-divergence.mdmarkdown5.2 KB
references/core/top-bar.mdmarkdown5.5 KB
references/core/topic-index.mdmarkdown7.6 KB
references/core/typography-wrapping.mdmarkdown9.3 KB
references/core/ux-writing-ko.mdmarkdown2.3 KB
references/core/visual-audit-loop.mdmarkdown5.8 KB
references/core/visual-verification.mdmarkdown7.5 KB
references/core/wcag22-aa.mdmarkdown12.6 KB
references/stack-index.mdmarkdown1.3 KB
references/stacks/astro.mdmarkdown8.1 KB
references/stacks/mobile-native.mdmarkdown10.9 KB
references/stacks/nextjs.mdmarkdown5.7 KB
references/stacks/react.mdmarkdown8.6 KB
references/stacks/svelte.mdmarkdown8.4 KB
references/stacks/vanilla.mdmarkdown5.1 KB
scripts/README.mdmarkdown1.7 KB
scripts/bundle-artifact.shexecutablescript1.5 KB
scripts/init-artifact.shexecutablescript6.8 KB
scripts/shadcn-components.tar.gzbinary19.5 KB

references/core/aesthetics.md

View on GitHub
# Aesthetics — Domain-Correct Design Engineering Guide

Comprehensive design rules for building distinctive frontends. The SKILL.md references this file — read it before any frontend work.

---

## Domain First

Do not start from "make it bold." Start from the surface:

- Landing/campaign: expressive typography and strong media can be appropriate.
- Product tools/dashboards/admin: task clarity, density, and repeatability matter more than spectacle.
- Fintech/public/B2B: trust, predictability, and low anxiety matter more than novelty.
- Education/community: warmth and guided visuals can help when they clarify the task.
- Korean-first UI: read `korea-2026.md` before choosing type scale, copy, spacing, or assets.

Hero-scale typography belongs to true hero surfaces. It is usually slop inside working tools.

## Typography

### Font Selection
- **Campaign/landing display**: `clamp(2.5rem, 6vw, 5rem)` when the first viewport is truly a hero.
- **Product/tool page title**: `clamp(1.5rem, 2vw, 2.25rem)`.
- **Dashboard/panel heading**: `0.875rem-1.125rem`, clear weight, compact rhythm.
- **Body**: `text-base text-gray-600 leading-relaxed max-w-[65ch]`
- **Serif**: BANNED for Dashboard/Software UIs. OK for editorial/creative only.

### Serif Discipline (verified 2026-07-09)
Serif is a DOMAIN-GATED direction, not a default and not a blanket ban.
"It feels creative/premium" is still NOT a reason — but the 2024-2026 serif
renaissance in AI/tech branding is real and measurable, and direction work
must be able to speak it.

**The actual grammar is a three-role system** (never "make everything serif"):
display serif at LIGHT weights + sans UI + mono technical accent. Measured
live 2026-07-09: claude.ai display `Anthropic Serif` 56px / weight **330**;
anthropic.com editorial H2 ~68px/400; medium.com `GT Super` 120px/400 with
Sohne sans UI; manus.im Libre Baskerville 36px/400 over system-sans UI;
Perplexity's Comet leads with Editorial New (Studio Freight, Fonts In Use
2025-10-23). Note the weights: 330-400. Heavy bold display serif is NOT the
pattern.

**Serif direction is legitimate when:**
- Brand brief literally names a serif font, OR
- Aesthetic is genuinely editorial/luxury/publication AND you can articulate why, OR
- The surface is an AI-product / research / trust brand deliberately signaling
  human warmth and scholarship (the Anthropic / Comet / Manus lane) — serif
  display must then come WITH editorial structure (long-form typography,
  page-like surfaces, restrained palette), never pasted onto a SaaS layout.

**Still banned:**
- Serif in dashboards, dense tools, admin, and Software UIs (unchanged).
- Fraunces, Instrument_Serif as defaults (the two LLM-favorite display serifs).
- "tasteslop": a display serif as a generic AI-premium shortcut without
  editorial content structure — the backlash already has a name (WIRED
  2026-06-05).

**Do not overclaim the trend:** Runway loads JHA Times Now but renders its
hero in a grotesk (abcNormal 48px/400); Attio loads Tiempos Text but leads
with Inter Display 64px/600; Mistral is sans/mono (ALTMistral 96px/500).
Loading a serif file is not being serif-led.

**Emphasis Rule:**
- Never inject serif word into sans headline (or vice versa) for visual interest
- Use italic or bold of the SAME font family

**If serif display is chosen, rotate from:**
Tiempos Headline, Editorial New / PP Editorial New, GT Super, GT Sectra
Display, Reckless Neue, Libre Baskerville, Recoleta, Cormorant Garamond,
Playfair Display, EB Garamond, IvyPresto, Migra — at weights 330-500,
generous size, line-height 1.1-1.25 for Latin display.

**Italic Descender Clearance:**
When italic has descender letters (y g j p q): `line-height: 1.1` min + `padding-bottom: 0.25rem` reserve

### Recommended Fonts (rotate — never converge on one)
| Category         | Options                                                     |
| ---------------- | ----------------------------------------------------------- |
| Modern Sans      | Geist, Outfit, Cabinet Grotesk, Satoshi, Clash Display      |
| Premium Sans     | GT America, Neue Machina, Obviously, Reckless               |
| Mono (data/code) | Geist Mono, JetBrains Mono, Fira Code                       |
| CJK/Korean       | Pretendard, SUIT, Noto Sans KR, Apple SD Gothic Neo |

For Korean-first UI, choose CJK-safe fonts before Latin display fonts. Do not apply negative letter-spacing to Hangul by default.

### Variable Font Pairing
Always pair a distinctive display font with a refined body font:
- `Clash Display` (display) + `Satoshi` (body)
- `Cabinet Grotesk` (display) + `Geist` (body)
- `Outfit` (display) + `Geist Mono` (code)

### Fluid Typography
Use `clamp()` for responsive sizing:
```css
--fluid-h1: clamp(2rem, 1rem + 3.6vw, 4rem);
--fluid-h2: clamp(1.75rem, 1rem + 2.3vw, 3rem);
--fluid-h3: clamp(1.5rem, 1rem + 1.4vw, 2.25rem);
--fluid-body: clamp(1rem, 0.95rem + 0.2vw, 1.125rem);
```

For CSS text wrapping implementation (`text-wrap`, `ch` units), see `typography-wrapping.md`.

---

## Color & Theme

### Rules
- **Max 1 accent color.** Saturation < 80%.
- **THE LILA BAN**: "AI Purple/Blue" aesthetic is BANNED. No purple button glows, no neon gradients.
- **Neutral bases**: Zinc, Slate, Stone. Not plain gray.
- **High-contrast singular accents**: Emerald, Electric Blue, Deep Rose, Amber.
- **Consistency**: ONE palette for entire project. No warm/cool gray mixing.
- **CSS Variables**: All colors defined as `--color-*` variables.
- **Never pure black (#000000)**: Use off-black (Zinc-950, Charcoal, `#0a0a0a`).

### Color Scale
| Step    | Brightness | Use Case              |
| ------- | ---------- | --------------------- |
| 50      | Very light | Subtle backgrounds    |
| 100-200 | Light      | Hover states, borders |
| 300-400 | Mid-light  | Disabled states       |
| 500     | Base       | Default color         |
| 600-700 | Dark       | Hover (dark), active  |
| 800-900 | Very dark  | Text, headings        |

### Alternative Palettes (use instead of banned warm-beige)

| Name | Background | Accent | Text |
|------|-----------|--------|------|
| Cold Luxury | silver-grey `#e8e8e8` | chrome `#c0c0c0` | smoke `#2d2d2d` |
| Forest | deep green `#1a3a2a` | bone `#f0ede5` | amber `#d4a017` |
| Black and Tan | off-black `#1a1a1a` | warm tan `#c9a96e` | white `#f5f5f5` |
| Cobalt + Cream | cream `#fafaf5` | cobalt `#0047ab` | near-black `#1a1a2e` |
| Terracotta + Slate | slate `#e2e0dc` | terracotta `#c75b39` | charcoal `#2f2f2f` |
| Olive + Brick + Paper | paper `#f2f0e8` | olive `#6b7c3e`, brick `#8b3a2a` | dark grey `#333` |
| Pure Monochrome | white `#fff` | single saturated pop | black `#111` |

Rotate: never the same palette twice in consecutive projects.

---

## Spatial Composition

### Layout Diversification
- **ANTI-CENTER BIAS**: When DESIGN_VARIANCE > 4, centered Hero/H1 is BANNED.
  Carve-out: FE-HERO-LIGHT-CENTER-01 (canonical in `layout-discipline.md`) is
  the sanctioned named exception at any variance when its conditions hold:
  headline weight <= 400 plus a full-width authored real-media backdrop. Bold
  centered heroes remain banned above variance 4.
  A second sanctioned variant also passes at any variance (canonical in
  `layout-discipline.md` FE-HERO-LIGHT-CENTER-01, Authored-Field Centered
  Statement): the background or proof object is the primary authored content,
  the centered overlay carries <= 3 semantic elements, line breaks are
  deliberate, and no equal-card row follows. Evidence: Vectr, Fin, Michael
  Pumo (2026-07-14 award crawl).
- **ANTI-HERO-IN-TOOLS**: Apps, dashboards, admin, finance flows, and developer tools should not start with landing-page hero composition.
- Force: "Split Screen" (50/50), "Left-aligned content / Right asset", "Asymmetric white-space"
- **Grid over Flex-Math**: NEVER `w-[calc(33%-1rem)]`. ALWAYS CSS Grid.
- **NO 3-Column Card Layouts**: Generic "3 equal cards" is BANNED. Use 2-column zig-zag, asymmetric grid, or horizontal scroll.

### DESIGN_VARIANCE Definitions
| Level | Style                                                                                          |
| :---: | ---------------------------------------------------------------------------------------------- |
|  1-3  | Flexbox centered, strict 12-column symmetry, equal paddings                                    |
|  4-7  | `margin-top: -2rem` overlapping, varied aspect ratios, left-aligned headers over centered data |
| 8-10  | Masonry, CSS Grid fractional (`2fr 1fr 1fr`), massive empty zones (`padding-left: 20vw`)       |

**MOBILE OVERRIDE**: Levels 4-10 MUST fall back to strict single-column (`w-full`, `px-4`, `py-8`) on `< 768px`.

---

## Backgrounds & Visual Depth

Don't default to empty decorative atmosphere. First decide whether the surface needs concrete assets:
- Product/object/person/place pages need real or generated subject imagery.
- Tools/dashboards need state previews, charts, tables, workflow screenshots, or diagrams.
- Fintech/public/B2B can use restrained semantic visuals; decoration must not reduce trust.

Atmospheric techniques are secondary:
- **Gradient meshes**: Organic, lava-lamp-like animated color blobs
- **Noise textures**: Subtle grain overlays on fixed pseudo-elements
- **Geometric patterns**: SVG-based repeating patterns
- **Layered transparencies**: Frosted glass with inner refraction borders
- **Dramatic shadows**: Tinted to background hue, not generic black

### Expressive vs Functional Layers (verified 2026-07-09)

The strongest 2025-2026 announcement/hero grammar (OpenAI model cards, Apple
capsule UI) splits every surface into two layers that must never mix:

- **Expressive layer**: soft-focus organic photography, AI-generated texture,
  grain, natural palettes — carries emotion, sits in the background, contains
  NO functional text.
- **Functional layer**: opaque capsule/pill or card labels, buttons, and copy
  floating ABOVE the expressive layer — full contrast, clean geometry, no
  transparency tricks needed (the OpenAI pill is opaque white, not glass).

Rules: never set functional text directly on a busy expressive background
without its own opaque (or heavily scrimmed) container; never decorate the
functional layer with the expressive layer's texture; one expressive field per
viewport. This is the same layer logic as Apple's WWDC25 capsule system
(controls as a distinct functional layer over content) executed with opaque
surfaces.

Carve-out (FE-TOPBAR-STATE-01, canonical in `top-bar.md`): a scroll-adaptive
top bar may run a lighter at-top material (~70-80% opacity) ONLY when the hero
is authored with a calm bar zone (the expressive field deliberately leaves the
bar area quiet); once content scrolls beneath, the bar returns to near-opaque
(85-95%). All other functional-layer text keeps the opaque-container rule.
Emphasis inside pill chrome is carried by FILLS and tints, not by nested
capsule borders — child capsule borders/outlines at rest are banned
(FE-PILL-NEST-01, canonical in `liquid-glass.md`).

### Glassmorphism / Liquid Glass (when used)
Glass recipes, layer discipline, perf and a11y gates are owned by
`liquid-glass.md` — read it before shipping any translucent material.
Short version: functional layer only, 1px inner border + inner shadow for
edge refraction, and consider the blur-free pill-over-imagery alternative.

---

## Visual Density (VISUAL_DENSITY dial)

| Level | Style                                                                            |
| :---: | -------------------------------------------------------------------------------- |
|  1-3  | Art Gallery: lots of white space, huge section gaps, expensive/clean feel        |
|  4-7  | Daily App: normal spacing for standard web apps                                  |
| 8-10  | Cockpit: tiny paddings, 1px separators instead of cards, `font-mono` for numbers |

---

## UI States (Mandatory)

LLMs generate "static successul states." You MUST implement full interaction cycles:
- **Loading**: Skeletal loaders matching layout sizes. No generic circular spinners.
- **Empty**: Beautifully composed empty states indicating how to populate.
- **Error**: Clear inline error reporting.
- **Tactile Feedback**: On `:active`, use `-translate-y-[1px]` or `scale-[0.98]`.

---

## Image Rules

Use assets in this priority order:

1. **Existing repo/design-system assets** → strongest fit for brand and provenance
2. **User-provided or approved brand assets** → preserve original meaning and legal use
3. **Generated local bitmap, SVG, diagram, chart, or screenshot** → create concrete visual evidence when no asset exists
4. **Approved external CDN assets configured in the framework** → use only when allowed by project config
5. **Temporary stock URLs** → prototypes only; label them as temporary and replace before production

Asset quality gates:
- Every meaningful image needs alt text that describes purpose, not file appearance.
- Set intrinsic dimensions, aspect-ratio, or layout constraints before rendering.
- Verify desktop, mobile, and narrow crops; the subject must not be clipped or hidden behind text.
- Use framework image optimization when available (`next/image`, responsive `srcset`, lazy loading).
- Track licensing/provenance for stock, generated, and third-party visuals.
- Never invent fake image URLs or ship generic egg/Lucide user icons as real avatars.

---

## Aesthetic Archetypes (Inspiration Library)

When choosing a direction, select from these. Each has distinct rules:

| Archetype                  | Color Vibe                         | Signature Effects                                 |
| -------------------------- | ---------------------------------- | ------------------------------------------------- |
| Minimalism / Swiss         | Monochrome + 1 accent              | Razor-sharp hierarchy, micro hover lifts          |
| Glassmorphism              | Aurora/sunset + translucent whites | Frosted panels, glowing borders                   |
| Brutalism                  | Harsh primaries, black/white       | Sharp corners, huge bold text, "broken" aesthetic |
| Dark OLED Luxury           | #0a0a0a + vibrant accent           | Velvet textures, cinematic entrance animations    |
| Aurora / Mesh Gradient     | Teal→purple→pink                   | Animated mesh gradients, color breathing          |
| Retro-Futurism / Cyberpunk | Neon cyan/magenta on black         | Scanlines, glitch transitions, chrome accents     |
| Organic / Biomorphic       | Earthy or muted pastels            | SVG morphing, blob shapes, irregular borders      |
| Editorial / Magazine       | Warm neutrals, serif display       | Column layouts, pull quotes, dramatic whitespace  |

Vary between these. NEVER converge on the same archetype across generations.

---

### AI-Brand Grammar Vocabulary (verified 2026-07-09)

Direction shorthand for AI/tech surfaces, grounded in who actually designed what:

| Grammar | Signature | Provenance |
| --- | --- | --- |
| OpenAI: warm-sans organic | proprietary warm geometric sans + huge whitespace + soft natural photography/film grain + opaque capsule labels | In-house (Feb 2025 rebrand, led by Veit Moeller/Shannon Jager) + ABC Dinamo (OpenAI Sans) + Studio Dumbar/DEPT (motion/sound) |
| Anthropic: serif bookish | display serif at light weights + warm off-white page metaphor + editorial layout | Geist (Styrene + Tiempos system) |
| DeepMind: scientific dimensional | serif/sans duality (DM Serif/DM Sans by Colophon) + conceptual 3D systems | MultiAdaptor + someform |

Use these as direction vocabulary ("OpenAI-grammar hero", "Anthropic-grammar
editorial"), not as skins to copy verbatim; each pairs with the Expressive vs
Functional Layers rule above and the Serif Discipline gates.

## Icon System

```
Sizing system:
  --icon-xs: 12px   (inline metadata, tight spaces)
  --icon-sm: 16px   (inline with body text)
  --icon-md: 20px   (buttons, form elements)
  --icon-lg: 24px   (navigation, section icons)
  --icon-xl: 32px   (feature highlights, empty states)
  --icon-2xl: 48px  (hero icons, illustrations)
```

- Icons inherit `currentColor` — never hardcode fill/stroke colors
- Stroke width consistent within a page (1.5px for Lucide, 2px for Heroicons)
- Icon + text alignment: `vertical-align: -0.125em` or flexbox `align-items: center`
- Touch target: icon buttons min 44x44px touch area (icon can be 24px, padding adds the rest)
- Never use icons without labels for critical actions (tooltip minimum, visible label preferred)
- Icon-only buttons require `aria-label`

---

## Print Styles

```css
@media print {
  nav, footer, .no-print, button, .cookie-banner { display: none; }
  body { font-size: 12pt; line-height: 1.5; color: #000; background: #fff; }
  a[href]::after { content: " (" attr(href) ")"; font-size: 0.8em; color: #666; }
  a[href^="#"]::after, a[href^="javascript"]::after { content: none; }
  h2, h3 { page-break-after: avoid; }
  table, figure, blockquote { page-break-inside: avoid; }
  img { max-width: 100%; page-break-inside: avoid; }
  p { widows: 3; orphans: 3; }
}
```

- Only add print styles for content-heavy pages (blog, docs, reports)
- Marketing/landing pages: print is rarely needed — skip unless requested
- Test: Cmd+P in browser, check layout breaks
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall