Skip to content

notque/vexjoy-agent / skills/frontend/frontend

frontend

Unverified

Frontend: UI design, distinctive visual styles, HTML artifacts, Three.js 3D, TypeScript/React/Next.js apps, e-commerce, portfolios, React Native, web performance.

FileKindSize
SKILL.mdskill md22.5 KB
SPEC.mdmarkdown4.3 KB
agents/html-builder.mdmarkdown5.9 KB
assets/base-template.htmlother495 B
references/design-refs/accessibility-review.mdmarkdown13.0 KB
references/design-refs/design-critique.mdmarkdown10.4 KB
references/design-refs/design-handoff.mdmarkdown9.9 KB
references/design-refs/design-systems.mdmarkdown9.3 KB
references/design-refs/llm-design-failure-modes.mdmarkdown9.1 KB
references/design-refs/ux-copy.mdmarkdown9.5 KB
references/distinctive-frontend-design-refs/animation-patterns.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/background-techniques.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/balatro-shader-breakdown.mdmarkdown14.9 KB
references/distinctive-frontend-design-refs/card-shader-patterns.mdmarkdown10.9 KB
references/distinctive-frontend-design-refs/color-inspirations.jsonconfig9.4 KB
references/distinctive-frontend-design-refs/css-audit-patterns.mdmarkdown4.7 KB
references/distinctive-frontend-design-refs/font-catalog.jsonconfig9.7 KB
references/distinctive-frontend-design-refs/game-ui-polish.mdmarkdown6.3 KB
references/distinctive-frontend-design-refs/honest-placeholders.mdmarkdown3.2 KB
references/distinctive-frontend-design-refs/implementation-examples.mdmarkdown7.7 KB
references/distinctive-frontend-design-refs/macrostructure-catalog.mdmarkdown9.3 KB
references/distinctive-frontend-design-refs/oklch-color-harmony.mdmarkdown7.3 KB
references/distinctive-frontend-design-refs/performance-budgets.mdmarkdown10.6 KB
references/distinctive-frontend-design-refs/phase-details.mdmarkdown4.8 KB
references/distinctive-frontend-design-refs/pptx-conversion.mdmarkdown9.7 KB
references/distinctive-frontend-design-refs/roll-text.mdmarkdown7.2 KB
references/distinctive-frontend-design-refs/shader-integration-react.mdmarkdown16.7 KB
references/distinctive-frontend-design-refs/slide-controller.mdmarkdown9.4 KB
references/distinctive-frontend-design-refs/text-animation-patterns.mdmarkdown4.3 KB
references/html-artifact-refs/design-system.mdmarkdown10.2 KB
references/html-artifact-refs/diagram-layering.mdmarkdown3.9 KB
references/html-artifact-refs/infographic-layouts.mdmarkdown4.9 KB
references/html-artifact-refs/pdf-export.mdmarkdown6.0 KB
references/html-artifact-refs/pptx-export.mdmarkdown10.2 KB
references/html-artifact-refs/shape-diagram-illustration.mdmarkdown4.3 KB
references/nextjs-ecommerce.mdmarkdown3.4 KB
references/nextjs-ecommerce/admin-dashboard.mdmarkdown9.8 KB
references/nextjs-ecommerce/error-catalog.mdmarkdown7.9 KB
references/nextjs-ecommerce/expertise.mdmarkdown5.1 KB
references/nextjs-ecommerce/patterns-and-errors.mdmarkdown4.6 KB
references/nextjs-ecommerce/preferred-patterns.mdmarkdown8.0 KB
references/nextjs-ecommerce/shopping-cart-patterns.mdmarkdown7.7 KB
references/nextjs-ecommerce/stripe-integration.mdmarkdown9.5 KB
references/performance-optimization.mdmarkdown9.9 KB
references/performance-optimization/browser-dom-optimizations.mdmarkdown6.0 KB
references/performance-optimization/bundle-optimization.mdmarkdown7.9 KB
references/performance-optimization/core-web-vitals.mdmarkdown9.6 KB
references/performance-optimization/js-algorithm-optimizations.mdmarkdown9.6 KB
references/performance-optimization/metrics-and-monitoring.mdmarkdown8.8 KB
references/performance-optimization/nextjs-optimization.mdmarkdown10.6 KB
references/performance-optimization/performance-testing.mdmarkdown9.6 KB
references/performance-optimization/preferred-patterns.mdmarkdown7.4 KB
references/performance-optimization/react-async-patterns.mdmarkdown7.0 KB
references/performance-optimization/react-bundle-optimization.mdmarkdown6.3 KB
references/performance-optimization/react-rendering-performance.mdmarkdown12.0 KB
references/react-native.mdmarkdown4.4 KB
references/react-native/animation-patterns.mdmarkdown3.9 KB
references/react-native/error-handling.mdmarkdown7.7 KB
references/react-native/list-performance.mdmarkdown5.4 KB
references/react-native/monorepo-config.mdmarkdown2.3 KB
references/react-native/navigation-patterns.mdmarkdown2.0 KB
references/react-native/rendering-patterns.mdmarkdown3.2 KB
references/react-native/state-management.mdmarkdown3.3 KB
references/react-native/testing.mdmarkdown6.2 KB
references/react-native/ui-patterns.mdmarkdown5.0 KB
references/react-portfolio.mdmarkdown7.7 KB
references/react-portfolio/gallery-patterns.mdmarkdown2.5 KB
references/react-portfolio/image-optimization.mdmarkdown3.4 KB
references/react-portfolio/lightbox-patterns.mdmarkdown6.1 KB
references/react-portfolio/nextjs-app-router.mdmarkdown4.9 KB
references/react-portfolio/performance.mdmarkdown3.9 KB
references/react-portfolio/portfolio-seo.mdmarkdown4.8 KB
references/react-portfolio/responsive-design.mdmarkdown3.3 KB
references/threejs-builder-refs/advanced-animation.mdmarkdown12.1 KB
references/threejs-builder-refs/advanced-topics.mdmarkdown11.0 KB
references/threejs-builder-refs/build-recipes.mdmarkdown7.4 KB
references/threejs-builder-refs/game-architecture.mdmarkdown10.4 KB
references/threejs-builder-refs/game-patterns.mdmarkdown12.5 KB
references/threejs-builder-refs/gltf-loading.mdmarkdown8.6 KB
references/threejs-builder-refs/performance-patterns.mdmarkdown11.8 KB
references/threejs-builder-refs/react-three-fiber.mdmarkdown17.8 KB
references/threejs-builder-refs/shader-patterns.mdmarkdown15.0 KB
references/threejs-builder-refs/visual-polish.mdmarkdown16.3 KB
references/threejs-builder-refs/webgpu.mdmarkdown20.4 KB
references/typescript-frontend.mdmarkdown5.3 KB
references/typescript-frontend/engineering-rules.mdmarkdown7.8 KB
references/typescript-frontend/nextjs-security.mdmarkdown2.6 KB
references/typescript-frontend/react-view-transitions.mdmarkdown5.4 KB
references/ui-design.mdmarkdown10.2 KB
references/ui-design/ai-slop-detection.mdmarkdown8.5 KB
references/ui-design/design-conventions.mdmarkdown2.8 KB
references/ui-design/motion-and-interaction.mdmarkdown5.6 KB
scripts-distinctive-frontend-design/css_slop_rules.pyscript15.3 KB
scripts-distinctive-frontend-design/tests/test_css_slop_rules.pyscript6.9 KB
scripts-distinctive-frontend-design/tests/test_validate_design_advisory.pyscript3.3 KB
scripts-distinctive-frontend-design/tests/test_validate_design_macro.pyscript4.3 KB
scripts-distinctive-frontend-design/validate_design.pyscript22.2 KB
scripts-html-artifact/assemble-template.pyscript7.5 KB
scripts-html-artifact/css_slop_rules.pyscript15.4 KB
scripts-html-artifact/detect-shape.pyscript7.0 KB
scripts-html-artifact/fill-template.pyscript5.5 KB
scripts-html-artifact/pptx-bridge/__init__.pyscript490 B
scripts-html-artifact/pptx-bridge/_pptx_engine.pyscript26.4 KB
scripts-html-artifact/pptx-bridge/extract_slides.pyscript13.5 KB
scripts-html-artifact/pptx-bridge/render_pptx.pyscript6.9 KB
scripts-html-artifact/pptx-bridge/run-unified.pyscript11.6 KB
scripts-html-artifact/render-github-issues.pyscript7.5 KB
scripts-html-artifact/tests/test_assemble_template.pyscript29.5 KB
scripts-html-artifact/tests/test_css_slop_emission.pyscript7.9 KB
scripts-html-artifact/tests/test_detect_shape.pyscript5.3 KB
scripts-html-artifact/tests/test_fill_template.pyscript5.2 KB
scripts-html-artifact/tests/test_to_pdf.pyscript13.3 KB
scripts-html-artifact/tests/test_validate_artifact.pyscript13.6 KB
scripts-html-artifact/to-pdf.pyscript12.5 KB
scripts-html-artifact/validate-artifact.pyscript11.0 KB
templates/base-reset.cssother1.2 KB
templates/components/collapsible.cssother1.1 KB
templates/components/collapsible.jsscript516 B
templates/components/copy-button.cssother534 B
templates/components/copy-button.jsscript334 B
templates/components/drag-drop.cssother612 B
templates/components/drag-drop.jsscript1.1 KB
templates/components/filter.cssother1.1 KB
templates/components/filter.jsscript987 B
templates/components/keyboard-nav.cssother249 B
templates/components/keyboard-nav.jsscript900 B
templates/components/scrollytelling.cssother1.5 KB
templates/components/scrollytelling.jsscript2.0 KB
templates/components/slider.cssother848 B
templates/components/tabs.cssother770 B
templates/components/tabs.jsscript508 B
templates/components/theme-toggle.cssother1.2 KB
templates/components/theme-toggle.jsscript178 B
templates/fonts/ArchivoBlack-OFL.txtmarkdown4.4 KB
templates/fonts/archivo-black.cssother13.7 KB
templates/print/code-review-print.cssother1.9 KB
templates/print/data-viz-print.cssother1.5 KB
templates/print/deck-print.cssother1.5 KB
templates/print/default-print.cssother1.6 KB
templates/print/diagram-print.cssother1.6 KB
templates/print/editor-print.cssother2.1 KB
templates/print/prototype-print.cssother1.4 KB
templates/print/report-print.cssother1.8 KB
templates/print/spec-print.cssother1.4 KB
templates/saved/README.mdmarkdown1.8 KB
templates/saved/business-review.htmlother17.1 KB
templates/saved/business-review.slots.jsonconfig1.5 KB
templates/saved/github-issues.htmlother34.0 KB
templates/saved/project-kickoff.htmlother17.3 KB
templates/saved/project-kickoff.slots.jsonconfig1.7 KB
templates/saved/system-design.htmlother16.9 KB
templates/saved/system-design.slots.jsonconfig1.6 KB
templates/shapes/code-review.cssother2.7 KB
templates/shapes/data-viz.cssother2.3 KB
templates/shapes/deck.cssother1.9 KB
templates/shapes/diagram.cssother2.7 KB
templates/shapes/editor.cssother2.8 KB
templates/shapes/prototype.cssother2.7 KB
templates/shapes/report.cssother2.9 KB
templates/shapes/spec.cssother3.0 KB
templates/themes/birchline.cssother2.4 KB
templates/themes/dark-focus.cssother2.6 KB
templates/themes/interactive-warm.cssother4.5 KB
templates/themes/minimal-document.cssother2.6 KB

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.
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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall