SkillAgentSearch skills...

top-design

Create award-winning, immersive web experiences at the level of Awwwards-featured agencies

Install / Use

npx skills add wondelai/skills --skill top-design

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

90/100

Supported Platforms

Zed

Our assessment of top-design

top-design scores 90/100 on our quality scale, 1347th of 4,698 Development & Engineering skills we index (top 29%).

Its SKILL.md is 23 KB long, well organised into 20 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.

With 2,248 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
18/20
Description
12/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so top-design is actively maintained.
  • Our last check on 2026-10-30 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

top-design compared with similar skills

All 4 of these similar skills score higher than top-design; compare them before choosing.

SkillScoreStarsUpdatedFormat
top-design (this skill)by wondelai902.2k2mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md

Frequently asked questions

How do I install top-design?
Run npx skills add wondelai/skills --skill top-design. The install tabs above show the steps for each supported agent.
Which AI agents does top-design work with?
It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
Is top-design safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is top-design still maintained?
The repository was last updated about 2 months ago, so top-design is actively maintained.

name: top-design description: 'Create award-winning, immersive web experiences at the level of Awwwards-featured agencies. Use when the user mentions "Awwwards quality", "make my site stunning", "scroll animations", "parallax storytelling", "cinematic web design", "portfolio site", or "brand experience". Also trigger when elevating a standard landing page into a memorable digital experience. Covers dramatic typography, purposeful motion, scroll-based composition, and performance-optimized animation. For foundational UI, see refactoring-ui. For type selection, see web-typography.' license: MIT metadata: author: wondelai version: "1.6.0"

Top-Design: Award-Winning Digital Experiences

Create websites and applications at the level of world-class digital agencies. This skill embodies the craft of studios that consistently win FWA, Awwwards, CSS Design Awards, and Webby Awards.

Core Principle

Every pixel is intentional -- nothing default, nothing accidental. The agencies you are emulating -- Locomotive, Studio Freight, AREA 17, Active Theory, Hello Monday -- share a common DNA: typography IS the design, motion creates emotion, white space is a weapon, and performance is non-negotiable (60fps or nothing).

The foundation: The gap between 8/10 and 10/10 is not skill -- it is intention. An 8/10 has good typography and smooth animations; a 10/10 has typography that makes you gasp and animations that tell stories. Every decision must answer: "Does this serve the experience, or is it just filling space?"

Scoring

Goal: 10/10. Rate any digital experience 0-10 using the rubric below -- a 10/10 would be featured on Awwwards. Always state the current score and the specific improvements needed to reach 10/10.

Scoring Rubric

| Score | Level | Description | |-------|-------|-------------| | 0-2 | Amateur | Default fonts, no hierarchy, generic layout, template feel | | 3-4 | Basic | Decent typography, some hierarchy, but forgettable | | 5-6 | Competent | Good fundamentals, clean execution, but lacks soul | | 7-8 | Professional | Strong typography, intentional motion, clear POV | | 9 | Exceptional | Signature moments, memorable details, near-flawless craft | | 10 | World-class | Would win Awwwards SOTD, defines new standards |

Category Scoring (Each 0-10)

TYPOGRAPHY (Weight: 25%) | Score | Criteria | |-------|----------| | 0-3 | System fonts, uniform scale, default tracking | | 4-6 | Premium fonts, some scale contrast, basic hierarchy | | 7-8 | Dramatic scale contrast (10:1+), perfect tracking, optical alignment | | 9-10 | Typography IS the design -- gasping moments, custom/variable fonts, type as architecture |

VISUAL COMPOSITION (Weight: 25%) | Score | Criteria | |-------|----------| | 0-3 | Centered everything, equal spacing, rigid grid, no tension | | 4-6 | Some asymmetry, decent spacing rhythm, basic depth | | 7-8 | Intentional grid breaks, layered elements, strong negative space | | 9-10 | Magnetic compositions, unexpected scale shifts, elements that breathe and surprise |

MOTION & INTERACTION (Weight: 20%) | Score | Criteria | |-------|----------| | 0-3 | No animation or default/linear motion | | 4-6 | Basic transitions, some scroll effects | | 7-8 | Custom easing, orchestrated reveals, purposeful parallax | | 9-10 | Motion that tells stories, perfectly timed choreography, scroll feels invented |

COLOR & ATMOSPHERE (Weight: 15%) | Score | Criteria | |-------|----------| | 0-3 | Random colors, pure black/white, no mood | | 4-6 | Cohesive palette, some atmosphere | | 7-8 | Colors feel owned, contextual shifts, intentional contrast | | 9-10 | Colors feel invented for this project, atmosphere you can feel |

DETAILS & CRAFT (Weight: 15%) | Score | Criteria | |-------|----------| | 0-3 | Default cursors, no hover states, generic everything | | 4-6 | Basic hover states, some custom elements | | 7-8 | Magnetic buttons, branded selection colors, custom cursor (if user-approved) | | 9-10 | Every micro-detail considered -- focus states, loading, empty states, scroll indicators |

Quick Score Formula

Total = (Typography x 0.25) + (Composition x 0.25) + (Motion x 0.20) + (Color x 0.15) + (Details x 0.15)

The Seven Pillars of 10/10 Design

1. Typography as Architecture

Core concept: Typography is not decoration layered onto a design -- it IS the design. Your typeface, scale, and tracking dictate color mood, animation style, spacing rhythm, and overall personality.

Why it works: Dramatic scale contrast creates hierarchy that communicates even when blurred or seen from across the room. The tension between monumental display type and intimate body text is what makes people stop scrolling.

Key insights:

  • Massive scale contrast is non-negotiable -- minimum 10:1 between display and body (e.g., 180px / 14px); viewport-filling type at the extreme
  • Negative tracking on large type (-0.02em to -0.05em) tightens display into cohesive units; body needs generous line-height (1.5-1.7)
  • Font selection defines tier -- premium foundries (Pangram Pangram, Dinamo, Grilli Type, Klim, Commercial Type) or quality Google alternatives (Space Grotesk, Instrument Serif, Fraunces); never Inter, Roboto, Arial, or system-ui for hero experiences
  • Variable fonts enable weight animation on hover without layout shift
  • Optical alignment beats mathematical alignment -- adjust visually, not just numerically
  • Control every line break on headlines -- beautiful breaks require manual intervention at key breakpoints

Applications: viewport-filling display dropping hard to body (Locomotive hero); variable font with hover weight-animation (Studio Freight); serif/sans pairing at extreme scale contrast (AREA 17 editorial). Display = one statement, 3-7 words; body = 16-18px minimum, 45-75 character measure.

See references/typography.md when choosing typefaces or building the type scale -- named font pairings by style, full fluid clamp() and step-based scales, tracking/leading ladders, and font-subsetting/FOUT mechanics.

2. Layout & Composition

Core concept: Master the grid so you can break it with intention -- every violation should feel deliberate, not accidental. The rhythm of density and breathing room creates a reading experience that holds attention.

Why it works: White space is active design material that creates tension and controls pacing. Asymmetry generates visual energy that centered compositions cannot; elements that overlap or bleed with intention feel alive and confident.

Key insights:

  • White space as a weapon -- amateurs fill every gap; 10/10 designers use emptiness to create tension that controls the eye
  • Asymmetric balance creates interest -- offset elements from center, let images bleed beyond containers
  • Unexpected scale shifts create rhythm -- alternate massive/intimate, dense/sparse for narrative pacing
  • The grid paradox -- a strong underlying grid is what makes breaks meaningful; without it, breaks are chaos

Applications: offset title with bleeding imagery (margin-left: 8.33%; margin-right: -5vw); varied card sizes for intentional asymmetry (Locomotive showcases); overlapping elements for depth (Active Theory). Alternate full-width immersion with contained reading sections.

Ethical boundary: Layout experimentation must never compromise navigation clarity -- users must always know where they are and how to move forward.

See references/layout-systems.md when laying out sections or going responsive -- grid frameworks, breakpoint systems, and asymmetric/bleeding-element patterns.

3. Motion & Animation

Core concept: Every animation must answer "Why does this move?" The three laws of elite motion: purpose over decoration, custom curves (never linear), orchestration over isolation.

Why it works: Choreographed motion guides attention, communicates hierarchy, and creates emotional resonance. Custom easing curves give movement a physical quality default browser easing cannot achieve.

Key insights:

  • Custom easing is mandatory -- ease, ease-in, ease-out, linear are banned; use cubic-bezier(0.16, 1, 0.3, 1) (expo out), cubic-bezier(0.25, 1, 0.5, 1) (quart out), cubic-bezier(0.87, 0, 0.13, 1) (expo in-out)
  • Page load follows a strict choreography -- structure (0-200ms), hero title words staggered (200-600ms), subtitle (400-800ms), navigation cascade (600-900ms), supporting elements (800-1200ms); reference holds the canonical per-element stagger values
  • Animate in relationship, not isolation -- elements that move together feel cohesive and intentional
  • 60fps is non-negotiable -- if an animation drops frames, simplify or remove it

Applications: choreographed staggered page-load reveal (Studio Freight); clip-path/mask image reveals on scroll-enter (AREA 17); hover weight-shifts and magnetic buttons (Dogstudio). Text lines slide up individually with stagger -- never fade in as a block; pages morph rather than cut.

Ethical boundary: Motion must never block interaction or cause motion sickness -- respect prefers-reduced-motion, keep all content accessible without animation, and justify anything longer than 1.2s.

See references/animation-patterns.md when implementing motion -- copy-pasteable scroll reveals, staggered load choreography, page transitions, and magnetic/hover micro-interactions with code.

4. Color & Contrast

Core concept: Color should feel invented for each project -- never pulled from a generic palette generator. Three approaches: monochromatic tension (95% one color, 5% accent), bold signature (own a combination), contextual shifting (palette responds to content).

Why it works: Color creates atmosphere before a single word is read. Pure black/white feel digital and lifeless; warm variants feel physical and considered. A restrained accent draws the eye exactly where intended.

Key insights:

  • Never use pure black or pure white -- #0a0a0a and #fafaf9 have a physical quality that #000/#fff lack
  • Build a functional hierarchy -- text-primary, text-secondary (60% opacity), text-tertiary (40%), surface, border (10%) for consistent depth
  • One strong accent used sparingly (#ff4d00 or similar) beats a complex multi-color palette
  • Contextual color shifts between sections create visual chapters
  • Design the system for both light and dark contexts, not individual instances

Applications: monochromatic with signature accent (Locomotive: cream + black + orange spark); contextual shifting per case study (AREA 17); dark mode with one vibrant accent (Stripe: navy + purple). Drive everything from CSS custom properties (--color-dark/-light/-accent plus functional --color-text-primary/-surface); the accent appears only on CTAs, links, and single-detail moments.

See references/case-studies.md when you need a worked example of any pillar -- agency-by-agency breakdowns of real color systems, type treatments, and micro-interactions to reverse-engineer.

5. Scroll-Based Design

Core concept: Scroll is the web's primary interaction and should feel designed, not default. Treat scroll as a narrative device -- controlling pacing, creating reveals, building tension, delivering signature moments.

Why it works: Default scroll is mechanical and treats all content as equally important. When scroll position drives reveals and transitions, moving through content becomes participatory rather than passive.

Key insights:

  • Smooth scroll is the foundation -- implement Lenis or Locomotive Scroll for the weighted, physical feel every award-winning site uses
  • Parallax must be purposeful -- sparing, and only on decorative elements; never on text or critical content
  • Pinned sections create storytelling beats -- lock a section while content transforms within it
  • Horizonta

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars2.2k
CategoryDevelopment
Updated2mo ago
Forks228

Languages

Shell

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions