Design Systems logo

Design Systems

Organization
Automattic
design-systems

Bold aesthetic direction guidance for web design. Use when making creative decisions about typography, color, motion, spatial composition, and overall visual style. Helps avoid generic "AI slop" aesthetics.

Overview

PublisherAutomattic
Repositorywordpress-agent-skills
Skill namedesign-systems
Stars
113
Forks
19
Bundled files
Instructions only
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by Automattic on GitHub. Read the source before you install it.

Installation

Install the Design Systems AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/Automattic/wordpress-agent-skills.git /tmp/wordpress-agent-skills
mkdir -p .claude/skills
cp -r /tmp/wordpress-agent-skills/claude-cowork/wp-site-creator/skills/design-systems .claude/skills/design-systems
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Design Systems in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Design Systems on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Design Systems is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Design Systems Skill

Frameworks for creating distinctive, memorable web designs that avoid generic "AI slop" aesthetics.

Absolute Rules

  • NO EMOJIS: Never use emojis anywhere in generated content - not in headings, paragraphs, button text, or any other text.

Design Thinking Framework

Before designing, understand the context and commit to a BOLD aesthetic direction:

1. Purpose

  • What problem does this design solve?
  • Who uses it?
  • What action should users take?

2. Tone

Do NOT pick from a fixed list of generic styles. Instead, derive every direction from the site's topic, industry, culture, and audience:

  • Think like a specialist designer who has been hired for exactly this brief. What visual references would you research? What mood boards would you create? What real-world spaces, objects, materials, or cultural artefacts inform the aesthetic?
  • Ground each direction in the topic. For a traditional restaurant, directions might explore rustic warmth, refined elegance, or cultural heritage — never brutalist concrete. For a tech startup, directions might explore clean precision, bold disruption, or data-driven minimalism — never cozy farmhouse.
  • Ensure authentic diversity. The 4 directions should vary meaningfully in color palette, typography, layout approach, and mood — but every one must feel like a plausible, thoughtful design for this specific type of site. Diversity comes from exploring different facets of the topic, not from importing unrelated aesthetics.
  • Name each direction specifically. Titles should reflect the topic-grounded concept (e.g., "Warm Heritage" or "Alpine Elegance" for a Swiss chalet site), not generic labels like "Minimalist" or "Bold".

3. Constraints

  • Technical requirements (framework, performance, accessibility)
  • Brand guidelines (if any)
  • Content requirements

4. Differentiation

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

Frontend Aesthetics Guidelines

You tend to converge toward generic, "on distribution" outputs. In frontend design, this creates what users call the "AI slop" aesthetic. Avoid this: make creative, distinctive frontends that surprise and delight.

Typography

Choose fonts that are beautiful, unique, and interesting.

AVOID (overused/generic):

  • Inter
  • Roboto
  • Arial
  • System fonts
  • Space Grotesk (overused by AI)

PREFER (distinctive choices):

  • Pair a distinctive display font with a refined body font
  • Consider: Fraunces, Clash Display, Cabinet Grotesk, Satoshi, Outfit, Syne, DM Serif Display, Playfair Display, Cormorant Garamond, Archivo
  • Match font personality to brand (tech: geometric sans; luxury: refined serif; creative: display fonts)
  • Unexpected, characterful font choices that elevate the frontend's aesthetics

Typography scale:

  • Use a consistent scale (1.25 or 1.333 ratio)
  • Headings should command attention
  • Body text should be comfortable to read (16-18px minimum)

Color & Theme

Commit to a cohesive aesthetic. Dominant colors with sharp accents outperform timid, evenly-distributed palettes.

Strategies:

  • Monochromatic with accent: Single color family + one pop color
  • Complementary contrast: Two opposing colors (careful with saturation)
  • Analogous harmony: Adjacent colors on the wheel
  • Dark mode: Not just inverted - design specifically for dark

AVOID:

  • Purple gradients on white backgrounds (cliched AI aesthetic)
  • Evenly distributed rainbow palettes
  • Low-contrast, washed-out schemes
  • Generic blue (#007bff) as primary
  • Timid, evenly-distributed palettes

Color proportions:

  • 60% dominant (backgrounds, large areas)
  • 30% secondary (containers, sections)
  • 10% accent (CTAs, highlights)

Motion & Animation

Motion is a design system element like color and typography — it should be intentional, cohesive, and matched to the site's personality. Prioritize CSS-only solutions.

Technique palette — choose from these categories to create a rich, dynamic experience:

CategoryTechniques
Entrance animationsFade-up, slide-in, scale-up, clip-path reveals — with staggered delays for groups
Hover/focus transitionsCard lifts, button transforms, underline grows, color shifts, shadow deepens
Continuous subtle motionFloating elements, pulsing accents, slow-rotating decorative shapes, gradient shifts
Scroll-triggered revealsSections/elements animate as they enter the viewport
Background animationGradient color cycling, pattern movement, ambient drift
Text effectsLetter-spacing transitions, weight shifts, color wipes on headings

CSS animation patterns:

css
/* Staggered fade-up entrance */
.fade-up {
  opacity: 0;
  transform: translateY(30px);
  animation: fadeUp 0.6s ease forwards;
}
.fade-up:nth-child(1) { animation-delay: 0.1s; }
.fade-up:nth-child(2) { animation-delay: 0.2s; }
.fade-up:nth-child(3) { animation-delay: 0.3s; }
.fade-up:nth-child(4) { animation-delay: 0.4s; }

@keyframes fadeUp {
  to { opacity: 1; transform: translateY(0); }
}

/* Slide-in from side */
.slide-in-left {
  opacity: 0;
  transform: translateX(-40px);
  animation: slideInLeft 0.7s ease forwards;
}
@keyframes slideInLeft {
  to { opacity: 1; transform: translateX(0); }
}

/* Scale reveal */
.scale-up {
  opacity: 0;
  transform: scale(0.9);
  animation: scaleUp 0.5s ease forwards;
}
@keyframes scaleUp {
  to { opacity: 1; transform: scale(1); }
}

/* Continuous float — decorative elements */
.float {
  animation: float 3s ease-in-out infinite;
}
@keyframes float {
  0%, 100% { transform: translateY(0); }
  50% { transform: translateY(-10px); }
}

/* Gradient background animation */
.gradient-shift {
  background-size: 200% 200%;
  animation: gradientShift 8s ease infinite;
}
@keyframes gradientShift {
  0% { background-position: 0% 50%; }
  50% { background-position: 100% 50%; }
  100% { background-position: 0% 50%; }
}

/* Hover transitions */
.hover-lift {
  transition: transform 0.2s ease, box-shadow 0.2s ease;
}
.hover-lift:hover {
  transform: translateY(-4px);
  box-shadow: 0 12px 24px rgba(0,0,0,0.15);
}

/* Accessibility: always include */
@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    transition-duration: 0.01ms !important;
  }
}

Orchestration guidance:

  • Pick 2-3 motion techniques per site and use them consistently, subtly — don't scatter every technique across a single page
  • Match motion to personality: tech sites = precise, snappy timing; luxury = slow, elegant easing; playful = bouncy, energetic curves
  • Entrance animations should follow a clear reading order — top-to-bottom, left-to-right stagger
  • Scroll reveals are the highest-impact pattern: sections animate as they enter the viewport, creating a sense of narrative progression

Spatial Composition

Break out of predictable layouts. Use unexpected layouts and avoid generic patterns:

  • Asymmetry: Off-center elements create visual interest
  • Overlap: Elements crossing boundaries add depth
  • Diagonal flow: Guide the eye with angled elements
  • Grid-breaking: Strategic elements that escape the grid
  • Negative space: Generous whitespace OR controlled density (pick one)

Interpret creatively and make unexpected choices that feel genuinely designed for the context.

Backgrounds & Visual Details

Create atmosphere and depth rather than defaulting to solid colors:

TechniqueUse Case
Gradient meshesModern, dynamic feel
Noise texturesWarmth, tactile quality
Geometric patternsTech, precision
Layered transparenciesDepth, sophistication
Dramatic shadowsPremium, elevated
Decorative bordersEditorial, structured
Grain overlaysVintage, analog feel

Iconography

  • Use custom-designed SVG icons that align with the theme's aesthetic
  • Maintain consistent stroke width and style
  • Icons should complement, not compete with content

Matching Complexity to Vision

IMPORTANT: Match implementation complexity to the aesthetic vision.

Maximalist designs need:

  • Elaborate code with extensive animations
  • Multiple visual layers
  • Rich interactive effects
  • Dense styling

Minimalist designs need:

  • Restraint and precision
  • Careful attention to spacing
  • Subtle typography refinements
  • Every detail intentional

Elegance comes from executing the vision well, not from adding more features.

Design Variety and Variation

When generating multiple designs:

Never Converge

  • NEVER converge on the same choices across generations
  • No design should be the same
  • Avoid overused fonts (see AVOID list above) across generations
  • Each design should feel genuinely different

Vary Core Elements

Color Variation:

  • Mix light and dark themes
  • Mix warm and cool palettes
  • Mix monochromatic and colorful approaches

Typography Variation:

  • Use different font combinations each time
  • Mix serif and sans-serif headings
  • Mix elegant and bold type treatments
  • Vary type scale and hierarchy

Layout Variation:

  • Mix full-width and contained layouts
  • Mix asymmetric and symmetric compositions
  • Vary density (spacious vs. compact)

Style Variation:

  • Explore different aesthetic territories
  • Each design should feel like it could be the foundation for a distinct, complete website
  • Avoid converging on similar solutions

Ensure significant variation: The designs should vary meaningfully in color palette, typography, layout approach, and mood — but every one must feel like a plausible, thoughtful design for the specific site context.

Remember: Extraordinary creative work requires committing fully to a distinctive vision. Don't hold back.

Frequently asked questions

What does the Design Systems AI skill do?

Bold aesthetic direction guidance for web design. Use when making creative decisions about typography, color, motion, spatial composition, and overall visual style. Helps avoid generic "AI slop" aesthetics.

Why use Design Systems on TypingMind?

Because you install it once and use it with any model. Design Systems is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Design Systems in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/Automattic/wordpress-agent-skills/tree/trunk/claude-cowork/wp-site-creator/skills/design-systems. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Design Systems?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Design Systems?

As many as you like. As long as a model supports skills, you can use Design Systems with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Design Systems AI skill free?

It is published on GitHub by Automattic. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇