notque/vexjoy-agent / skills/frontend/frontend
frontend
UnverifiedFrontend: UI design, distinctive visual styles, HTML artifacts, Three.js 3D, TypeScript/React/Next.js apps, e-commerce, portfolios, React Native, web performance.
references/ui-design/ai-slop-detection.md
View on GitHub# AI Slop Detection
<!-- Loaded via ui-design.md when task involves AI slop, generic UI, AI-generated look, template look, or default styling -->
Detection commands and keep-if exceptions for generated-UI tells. The tells and their fixes are defined in `skills/shared-patterns/ui-design-judgment.md` section 9; this file adds how to find them in existing code. Each pattern starts with the correct approach.
## Use Purposeful Gradients
Gradients serve a visual purpose: directing attention, creating depth, or establishing atmosphere. Aggressive multi-color gradients with 3+ color stops — the rainbow-adjacent backgrounds AI defaults to — signal that no design decision was made. Use single-hue gradients (e.g., dark blue to slightly lighter blue) or solid backgrounds. A gradient earns its place when it creates a mood, not when it fills a blank.
```css
/* Correct: single-hue gradient creating subtle depth */
background: linear-gradient(180deg, #1a1a2e 0%, #16213e 100%);
/* Correct: solid background with texture for interest */
background-color: #fafaf9;
```
**Keep if:** The design specification calls for a multi-stop gradient and provides the exact color stops with a visual rationale. Brand gradients with 3+ stops exist (Instagram, Stripe).
**Detection:**
```bash
rg 'linear-gradient|radial-gradient' --include='*.css' --include='*.tsx' --include='*.jsx' --include='*.html' | grep -E '(#[0-9a-fA-F]{3,8}|rgb|hsl|oklch).*,.*,.*,'
```
Flag any gradient with 3 or more color stops for manual review.
---
## Reserve Emoji for Brand Context
Emoji used as decorative section markers — a rocket before "Features", a sparkle before "Benefits" — is an AI tell. It adds visual noise without communicating information. Use SVG icons from a coherent icon set (Lucide, Heroicons, Phosphor) or text-only headings. Emoji belongs in conversational UI (chat, notifications, reactions) where informal tone is the point, not in marketing or product sections where it cheapens the message.
```html
<!-- Correct: icon from a coherent set -->
<h2><LucideIcon name="zap" size={20} /> Performance</h2>
<!-- Correct: text-only heading with typographic hierarchy -->
<h2>Performance</h2>
```
**Keep if:** The brand voice is deliberately casual (Discord, Notion) and emoji is part of the documented brand identity, not a default choice.
**Detection:**
```bash
rg '[\x{1F300}-\x{1F9FF}\x{2600}-\x{26FF}\x{2700}-\x{27BF}]' --include='*.tsx' --include='*.jsx' --include='*.html' -n
```
Flag emoji inside heading elements (`h1`-`h6`), label elements, or button text for review.
---
## Design Cards Without Left-Border Accent
The `border-radius: 12px` card with `border-left: 4px solid {accent}` is the single most common AI card pattern. It appears in virtually every AI-generated dashboard and feature grid. Use full borders, subtle box shadows, or no border at all. If you need to indicate category or status, use a small color dot, a tag, or a tinted background — not a left border accent.
```css
/* Correct: shadow-based card separation */
.card {
border-radius: 8px;
box-shadow: 0 1px 3px rgba(0, 0, 0, 0.08);
border: 1px solid #e5e5e5;
}
/* Correct: no border, background differentiation */
.card {
border-radius: 8px;
background: #f8f8f8;
}
```
**Keep if:** The left border accent is part of a documented design system with a specific semantic meaning (e.g., VS Code's panel indicators, GitHub's diff markers).
**Detection:**
```bash
rg 'border-left:.*solid' --include='*.css' --include='*.tsx' --include='*.jsx' -n
```
Cross-reference hits with `border-radius` in the same rule or component. The combination is the signal.
---
## Use Professional Illustration or Photography
AI defaults to hand-drawn, sketchy SVG illustrations — wobbly lines, friendly blob shapes, stick-figure-adjacent characters. These look like placeholder art that shipped by accident. Use real photography, professional vector illustration from a licensed set (unDraw with customization, Storyset), or honest placeholders (see `skills/frontend/frontend/references/distinctive-frontend-design-refs/honest-placeholders.md`). An honest "image needed" placeholder is better than a bad illustration that looks intentional.
```html
<!-- Correct: real photography with proper alt text -->
<img src="/images/team-photo.jpg" alt="Engineering team at the Portland office" />
<!-- Correct: honest placeholder when real assets are not ready -->
<div class="placeholder">product hero (1200x800)</div>
```
**Keep if:** The hand-drawn style is an intentional brand choice (Notion's illustrations, Balsamiq's wireframe aesthetic) and appears in the brand guide.
**Detection:** Look for inline `<svg>` elements with irregular path data (many short arc and curve commands). AI-generated SVG illustrations tend to have dense `d` attributes with numerous `C`, `Q`, and `A` commands in rapid succession.
---
## Match Fonts to the Surface
A neutral sans (system UI font, Inter, Geist) is the right default for product tools. On a brand page, the same face picked by reflex makes the page look like a template, and so does the opposite reflex: serif display, cream background, and grain on every project. Choose from the brand and audience.
```css
/* Tool: one neutral family, hierarchy from size and weight */
font-family: system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
/* Brand page: a display face chosen for this brand, neutral text face */
--font-display: 'Instrument Serif', Georgia, serif;
--font-text: 'Geist', system-ui, sans-serif;
```
**Keep if:** Any neutral sans on a tool. On a brand page, keep a popular face when the brand guide names it or you can state why it fits.
**Detection:**
```bash
rg -i 'font-family.*\b(Inter|Roboto|Arial|Helvetica|system-ui)\b' --include='*.css' --include='*.tsx' --include='*.jsx' --include='*.html' -n
```
Review hits on brand pages only.
---
## Avoid Pure Black Under Pure White Text
Pure `#FFFFFF` backgrounds are fine in light mode. In dark mode, pure black under pure white text is harsh; use a near-black surface (for example `#0f1115` or `oklch(18% 0.015 260)`) and slightly off-white text. Tint neutral grays toward the brand hue so they do not look dead.
```css
[data-theme="dark"] {
--bg: oklch(18% 0.015 260);
--fg: oklch(93% 0.01 260);
}
```
**Keep if:** A terminal or code-editor theme where pure black is the convention, or a deliberate high-contrast mode.
**Detection:**
```bash
rg -i '#000000|#000\b' --include='*.css' --include='*.tsx' --include='*.jsx' --include='*.html' -n
```
---
## Derive Colors from Context
Random hex values with no relationship to each other — `#4f46e5` next to `#10b981` next to `#f59e0b` — signal AI generation. Every color in a palette should trace back to a source: the brand guide, a cultural reference, a material inspiration, or a deliberate harmony relationship (analogous, complementary, triadic). Colors derived from context feel inevitable. Random colors feel assembled.
```css
/* Correct: palette derived from Japanese indigo dyeing */
:root {
--indigo-deep: oklch(25% 0.08 250); /* ai-iro (indigo) */
--indigo-mid: oklch(45% 0.12 248); /* hanada (flower-field blue) */
--indigo-light: oklch(85% 0.04 250); /* kamenozoki (peek of the turtle) */
}
```
**Keep if:** The colors come from an established design system (Tailwind's palette, Material Design) where the relationships are already defined.
**Detection:** Check whether color values appear in the project's design specification, brand guide, or a documented palette source. Colors that cannot be traced to a source need justification. See `skills/frontend/frontend/references/distinctive-frontend-design-refs/oklch-color-harmony.md` for the technique to build harmonious palettes from context.
---
## Snap Spacing to a Scale
Values like `padding: 7px`, `margin: 13px`, or `gap: 18px` that do not fit a 4px or 8px grid are AI tells. Designers work on scales. AI generates plausible-looking numbers. All spacing, padding, margin, and gap values should snap to 4px increments (4, 8, 12, 16, 20, 24, 32, 40, 48, 64). Font sizes should snap to a typographic scale.
```css
/* Correct: all values on a 4px grid */
.card {
padding: 16px;
margin-bottom: 24px;
gap: 12px;
border-radius: 8px;
}
```
**Keep if:** The value is 1px or 2px for borders, outlines, or dividers — these are structural, not spacing. `--allow 1,2` in the design scale checker handles this.
**Detection:**
```bash
python3 scripts/design-scale-check.py path/to/styles.css
```
The script flags any `px` value that is not a multiple of 4 (configurable via `--base`). See `scripts/design-scale-check.py` for full usage.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |