top-design
Create award-winning, immersive web experiences at the level of Awwwards-featured agencies. Use when the user mentions "premium website", "portfolio site", "scroll animations", "Awwwards quality", "brand experience", "cinematic web design", "parallax storytelling", or "agency-quality site". Also trigger when building landing pages that need to impress, designing creative portfolios, or elevating a standard website to 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.
What this skill does
# 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 (not decoration, but architecture), motion creates emotion (animation serves narrative, not novelty), white space is a weapon (tension through restraint), and performance is non-negotiable (60fps or nothing). **The foundation:** What separates 10/10 from 8/10 is not incremental improvement but a qualitative leap. An 8/10 design has good typography, nice colors, and smooth animations. A 10/10 design has typography that makes you gasp, colors that feel invented for this specific project, and animations that tell stories. The gap is not skill -- it is intention. Every decision at the 10/10 level answers the question: "Does this serve the experience, or is it just filling space?" ## Scoring **Goal: 10/10.** When reviewing or creating digital experiences, rate them 0-10 using the rubric below. A 10/10 means the design would be featured on Awwwards. Always provide the current score and 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. The typeface you choose, the scale you set, and the tracking you refine dictate everything else: color palette mood, animation style, spacing rhythm, and overall personality. When someone scrolls past your hero and does not pause, your typography is not working. **Why it works:** Dramatic scale contrast creates immediate visual hierarchy that communicates even when content is blurred or viewed from across the room. Large display type with tight tracking commands attention like architecture commands a skyline, while intimate body text draws readers into the content. This tension between monumental and personal is what makes people stop scrolling. **Key insights:** - **Massive scale contrast is non-negotiable** -- the ratio between display and body should be at minimum 10:1 (e.g., 180px headline / 14px body), with viewport-filling type at the extreme end making body text feel intimate - **Negative tracking on large type** (-0.02em to -0.05em) tightens display text into cohesive visual units, while generous line-height for body (1.5-1.7) ensures readability - **Font selection defines tier** -- display fonts should come from 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 states and transitions, adding dynamism without layout shift - **Optical alignment over mathematical alignment** -- human perception is imperfect, so text must be adjusted visually, not just numerically - **Control every line break on headlines** -- text that breaks beautifully requires manual intervention at key breakpoints **Product applications:** | Context | Application | Example | |---------|-------------|---------| | Portfolio hero | Viewport-filling display type with dramatic scale drop to body | Locomotive.ca hero typography | | Brand website | Custom/variable font with weight animation on hover | Studio Freight interactive type | | Product landing | Tight display tracking with generous body spacing | Apple product pages | | Editorial layout | Serif/sans pairing with extreme scale contrast | AREA 17 case studies | | Cultural institution | Statement typography that becomes the visual identity | Hello Monday museum sites | | Tech startup | Premium geometric sans at architectural scale | Stripe typography system | **Copy patterns:** - Display: single powerful statement, 3-7 words maximum - Subhead: one sentence that contextualizes the display type - Body: 16-18px minimum, generous line-height, moderate measure (45-75 characters) - The "typography stare test": blur your eyes -- does the type hierarchy still read? If everything looks the same importance when blurred, you have failed **Ethical boundary:** Typography choices should enhance readability and accessibility, not sacrifice legibility for aesthetic novelty. Ensure body text meets WCAG contrast requirements and remains readable at standard viewing distances. See: [references/typography.md](references/typography.md) for font pairing strategies, type scale systems, and advanced CSS typography. ### 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 -- full-viewport hero, intimate text section, massive single word, dense grid -- creates a reading experience that holds attention. **Why it works:** White space is not empty space -- it is active design material that creates tension, controls pacing, and makes viewers lean in. Asymmetric layouts generate visual energy that centered, symmetrical compositions cannot achieve. When elements overlap, bleed, or extend beyond their containers with intention, the design feels alive and confident rather t
Related in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".