All skills
jwynia avatar

/frontend-design

@99a8797
by J Wyniajwynia/agent-skills160 stars
20

Create distinctive, production-grade frontend interfaces with high design quality. Provides analysis tools for auditing existing designs and generation tools for creating color palettes, typography systems, design tokens, and component templates. Supports React, Vue, Svelte, and vanilla HTML/CSS. Use when building web components, pages, or applications. Keywords: design, UI, frontend, CSS, components, palette, typography, tokens, accessibility.

Use this Skill: https://skilld.dev/gh/jwynia/agent-skills/frontend-design

This session only. Nothing lands on disk.

referencesdesign-philosophy.md

≈1.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Design Philosophy: Avoiding AI Slop

This document provides detailed guidance on creating distinctive, production-grade frontend interfaces that avoid generic "AI-generated" aesthetics.

Core Principle

Choose a clear aesthetic direction and execute it with precision. Bold maximalism and refined minimalism both work - the key is intentionality, not intensity.

Design Thinking Process

Before writing any code, understand the context and commit to a BOLD aesthetic direction:

1. Purpose

  • What problem does this interface solve?
  • Who uses it and in what context?
  • What emotions should it evoke?

2. Aesthetic Tone

Pick a distinctive direction. Here are examples for inspiration:

Tone Characteristics
Brutally Minimal Stark contrast, maximum whitespace, single accent color
Maximalist Chaos Dense information, layered textures, vibrant palettes
Retro-Futuristic Neon accents, dark backgrounds, geometric shapes
Organic/Natural Soft curves, earthy tones, flowing animations
Luxury/Refined Subtle typography, muted palettes, premium spacing
Playful/Toy-like Rounded corners, bright colors, bouncy animations
Editorial/Magazine Strong typography hierarchy, asymmetric layouts
Brutalist/Raw Exposed structure, stark fonts, visible grids
Art Deco/Geometric Bold patterns, metallic accents, symmetry
Soft/Pastel Gentle gradients, light shadows, calming colors
Industrial/Utilitarian Monospace fonts, muted colors, functional density

3. Differentiation

What makes this interface UNFORGETTABLE? What's the one thing someone will remember?


The Five Pillars of Distinctive Design

1. Typography

Do:

  • Choose fonts that are beautiful, unique, and characterful
  • Pair a distinctive display font with a refined body font
  • Use unexpected, personality-rich choices
  • Consider the context and audience

Don't:

  • Default to Arial, Inter, Roboto, or system fonts
  • Use the same fonts across every project
  • Ignore font pairing harmony
  • Over-rely on weight for hierarchy

Distinctive Font Examples:

Category Options
Display Playfair Display, Fraunces, Libre Baskerville, Cormorant
Sans-Serif Space Grotesk, DM Sans, Plus Jakarta Sans, Outfit
Mono JetBrains Mono, Fira Code, IBM Plex Mono
Unique Anybody, Instrument Serif, Cabinet Grotesk

2. Color & Theme

Do:

  • Commit to a cohesive aesthetic
  • Use CSS variables for consistency
  • Choose dominant colors with sharp accents
  • Consider context (brand, mood, accessibility)

Don't:

  • Default to purple gradients on white
  • Use timid, evenly-distributed palettes
  • Ignore contrast requirements
  • Copy trending palettes without adaptation

Palette Strategies:

  • Monochromatic: Single hue with varied saturation/lightness
  • Complementary: Opposite colors for high contrast
  • Analogous: Adjacent colors for harmony
  • Split-Complementary: Main color + two adjacent to its complement
  • Triadic: Three evenly-spaced colors

3. Motion

Do:

  • Focus on high-impact moments
  • Create orchestrated page load reveals with staggered animation-delay
  • Use scroll-triggered animations that surprise
  • Implement hover states with personality

Don't:

  • Add motion for motion's sake
  • Create scattered, uncoordinated micro-interactions
  • Ignore reduced-motion preferences
  • Use jarring or disorienting effects

Motion Hierarchy:

  1. Page transitions: Most impactful, highest attention
  2. Scroll reveals: Content appearing as user explores
  3. Hover states: Feedback and delight
  4. Micro-interactions: Subtle polish (buttons, toggles)

CSS-First Approach:

/* Staggered reveal */
.item { animation: fadeIn 0.5s ease-out forwards; opacity: 0; }
.item:nth-child(1) { animation-delay: 0.1s; }
.item:nth-child(2) { animation-delay: 0.2s; }
.item:nth-child(3) { animation-delay: 0.3s; }

/* Respect preferences */
@media (prefers-reduced-motion: reduce) {
  .item { animation: none; opacity: 1; }
}

4. Spatial Composition

Do:

  • Create unexpected layouts
  • Use asymmetry intentionally
  • Allow elements to overlap
  • Employ diagonal flow and grid-breaking elements
  • Balance generous negative space OR controlled density

Don't:

  • Default to symmetric card grids
  • Treat every element equally
  • Fear whitespace (or density, if that's your direction)
  • Ignore visual rhythm

Layout Techniques:

  • Broken grid: Elements that break the expected grid
  • Overlap: Layered elements creating depth
  • Scale contrast: Large elements next to small
  • Negative space: Breathing room as a design element
  • Asymmetric balance: Visual weight distributed unevenly

5. Backgrounds & Visual Details

Do:

  • Create atmosphere and depth
  • Use contextual effects that match the aesthetic
  • Layer transparencies for dimension
  • Add texture where appropriate

Don't:

  • Default to solid white backgrounds
  • Use generic gradient presets
  • Forget about dark mode considerations
  • Over-apply effects

Visual Effects Palette:

  • Gradient meshes
  • Noise and grain textures
  • Geometric patterns
  • Layered transparencies
  • Dramatic shadows (soft or hard)
  • Decorative borders
  • Custom cursors
  • Glassmorphism (used intentionally)
  • Neumorphism (used sparingly)

What to Avoid: The "AI Slop" Checklist

Typography Anti-Patterns

  • Inter everywhere
  • Roboto as the only choice
  • Arial or system fonts
  • Identical font usage across projects

Color Anti-Patterns

  • Purple-to-blue gradient on white
  • Generic "modern" teal
  • Desaturated "safe" palettes
  • Unrelated accent colors

Layout Anti-Patterns

  • 3-column card grids
  • Identical padding everywhere
  • Symmetric hero sections
  • Predictable section patterns

Effect Anti-Patterns

  • Subtle gray shadows on everything
  • Generic rounded corners (8px everywhere)
  • Smooth but meaningless transitions
  • Glass effects without purpose

Implementation Complexity Matching

Critical: Match implementation complexity to aesthetic vision.

Maximalist Designs

  • Elaborate code with extensive animations
  • Multiple layered effects
  • Complex state management for interactions
  • Rich color variations

Minimalist Designs

  • Restraint and precision
  • Careful attention to spacing
  • Perfect typography
  • Subtle, meaningful details
  • "Less" requires more care, not less code

Quality Checklist

Before considering a design complete:

  • Typography is distinctive and intentional
  • Colors support the aesthetic direction
  • Motion is orchestrated, not scattered
  • Layout has visual interest and hierarchy
  • Details add atmosphere without clutter
  • Accessibility is preserved (contrast, motion preferences)
  • The design is memorable - someone would recognize it

Remember

"Claude is capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision."

No two designs should look the same. Vary themes, fonts, aesthetics. The goal is intentional, memorable, production-grade interfaces.

Source: SKILL.md on GitHub

1 warning15d5 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    The skill provides a set of design-focused Deno scripts for CSS analysis and frontend code generation. It follows secure practices by using scoped Deno permissions and versioned imports from trusted registries. No security issues were detected.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    3/14 files flagged

  • ZeroLeaks5mo

    1 finding · Score: 86/100

Signed by skilld at 99a8797. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 8 months ago
compatibility
Requires Deno with --allow-read, --allow-write permissions
Other metadata
metadata
{
  "author": "agent-skills",
  "version": "1.0",
  "type": "generator",
  "mode": "generative",
  "domain": "development"
}
  • Frontend
  • React
  • Vue
  • design-systems
  • svelte
  • css
  • typography
  • color-palette
  • design-tokens
  • accessibility

README badge

README badge for jwynia/agent-skills/frontend-design

Generates and audits frontend design systems including color palettes, typography scales, design tokens, and component templates for React, Vue, Svelte, and HTML. Supports analysis of existing CSS for design patterns, token extraction, and accessibility compliance checks.

Generated from the current SKILL.md.

Does this skill work with TypeScript and Deno?
Yes. All scripts are written in TypeScript and require Deno runtime with --allow-read and --allow-write permissions to execute.
What frameworks and styling methods does component generation support?
Component generation supports React, Vue, Svelte, and vanilla HTML. Styling options include CSS, Tailwind, CSS modules, styled-components, and Emotion.
Can this skill extract design tokens from existing CSS files?
Yes. The extract-tokens script can parse existing CSS and output design tokens in multiple formats: CSS variables, SCSS, Tailwind, Style Dictionary, or Tokens Studio.
Does this handle accessibility checking?
Yes. The analyze-accessibility script checks color contrast ratios, focus indicators, touch target sizes, and motion preferences against WCAG AA or AAA standards.
What color palette output formats are available?
Generated palettes can be output as CSS variables, SCSS, Tailwind config, token format, or JSON.

Generated from the current SKILL.md. These answers refresh after source changes.