High-Agency Frontend Skill

0. ANTI-SLOP BASELINE [MANDATORY]

Before applying anything below, read references/ui-anti-slop.md and apply every rule in it. That file is the canonical anti-slop ruleset (typography, color, layout, motion, states, content, icons, code quality, accessibility). This skill adds the following stricter / additional stances on top of it:

• Serif is strictly banned on Dashboard/Software UI (anti-slop allows editorial serif; this skill forbids serif on data UI entirely).
• Aesthetic target is "Vercel-core meets Dribbble-clean": absolute neutral bases, single high-contrast accent, dial-driven variance (Section 1).
• Everything in the dial system, React/Next architecture, Framer technique sections, Creative Arsenal, and Bento paradigm below is unique to this skill and not in the anti-slop reference.

1. ACTIVE BASELINE CONFIGURATION

• DESIGN_VARIANCE: 8 (1=Perfect Symmetry, 10=Artsy Chaos)
• MOTION_INTENSITY: 6 (1=Static/No movement, 10=Cinematic/Magic Physics)
• VISUAL_DENSITY: 4 (1=Art Gallery/Airy, 10=Pilot Cockpit/Packed Data)

AI Instruction: The standard baseline for all generations is strictly set to these values (8, 6, 4). Do not ask the user to edit this file. Otherwise, ALWAYS listen to the user: adapt these values dynamically based on what they explicitly request in their chat prompts. Use these baseline (or user-overridden) values as your global variables to drive the specific logic in Sections 3 through 7.

2. DEFAULT ARCHITECTURE & CONVENTIONS

Unless the user explicitly specifies a different stack, adhere to these structural constraints to maintain consistency:

• DEPENDENCY VERIFICATION [MANDATORY]: Before importing ANY 3rd party library (e.g. framer-motion, lucide-react, zustand), you MUST check package.json. If the package is missing, you MUST output the installation command (e.g. npm install package-name) before providing the code. Never assume a library exists.
• Framework & Interactivity: React or Next.js. Default to Server Components (RSC).
  • RSC SAFETY: Global state works ONLY in Client Components. In Next.js, wrap providers in a "use client" component.
  • INTERACTIVITY ISOLATION: If Sections 4 or 7 (Motion/Liquid Glass) are active, the specific interactive UI component MUST be extracted as an isolated leaf component with 'use client' at the very top. Server Components must exclusively render static layouts.
• State Management: Use local useState/useReducer for isolated UI. Use global state strictly for deep prop-drilling avoidance.
• Styling Policy: Use Tailwind CSS (v3/v4) for 90% of styling.
  • TAILWIND VERSION LOCK: Check package.json first. Do not use v4 syntax in v3 projects.
  • T4 CONFIG GUARD: For v4, do NOT use tailwindcss plugin in postcss.config.js. Use @tailwindcss/postcss or the Vite plugin.
• ANTI-EMOJI POLICY [CRITICAL]: NEVER use emojis in code, markup, text content, or alt text. Replace symbols with high-quality icons (Radix, Phosphor) or clean SVG primitives. Emojis are BANNED.
• Responsiveness & Spacing:
  • Standardize breakpoints (sm, md, lg, xl).
  • Contain page layouts using max-w-[1400px] mx-auto or max-w-7xl.
  • Viewport Stability [CRITICAL]: NEVER use h-screen for full-height Hero sections. ALWAYS use min-h-[100dvh] to prevent catastrophic layout jumping on mobile browsers (iOS Safari).
  • Grid over Flex-Math: NEVER use complex flexbox percentage math (w-[calc(33%-1rem)]). ALWAYS use CSS Grid (grid grid-cols-1 md:grid-cols-3 gap-6) for reliable structures.
• Icons: You MUST use exactly @phosphor-icons/react or @radix-ui/react-icons as the import paths (check installed version). Standardize strokeWidth globally (e.g., exclusively use 1.5 or 2.0).

3. DESIGN ENGINEERING DIRECTIVES

The bias-correction rules (typography, color calibration, layout diversification, anti-card-overuse, interactive states, form patterns) are now in references/ui-anti-slop.md §1-5. Apply them via the dial values in Section 1: when a dial raises variance/density/motion, push those anti-slop rules harder (e.g. VISUAL_DENSITY > 7 → the §2 "cards only when elevation communicates hierarchy" rule becomes "no card containers at all, use 1px dividers").

4. CREATIVE PROACTIVITY (Anti-Slop Implementation)

To actively combat generic AI designs, systematically implement these high-end coding concepts as your baseline:

• "Liquid Glass" Refraction: When glassmorphism is needed, go beyond backdrop-blur. Add a 1px inner border (border-white/10) and a subtle inner shadow (shadow-[inset_0_1px_0_rgba(255,255,255,0.1)]) to simulate physical edge refraction.
• Magnetic Micro-physics (If MOTION_INTENSITY > 5): Implement buttons that pull slightly toward the mouse cursor. CRITICAL: NEVER use React useState for magnetic hover or continuous animations. Use EXCLUSIVELY Framer Motion's useMotionValue and useTransform outside the React render cycle to prevent performance collapse on mobile.
• Perpetual Micro-Interactions: When MOTION_INTENSITY > 5, embed continuous, infinite micro-animations (Pulse, Typewriter, Float, Shimmer, Carousel) in standard components (avatars, status dots, backgrounds). Apply premium Spring Physics (type: "spring", stiffness: 100, damping: 20) to all interactive elements—no linear easing.
• Layout Transitions: Always utilize Framer Motion's layout and layoutId props for smooth re-ordering, resizing, and shared element transitions across state changes.
• Staggered Orchestration: Do not mount lists or grids instantly. Use staggerChildren (Framer) or CSS cascade (animation-delay: calc(var(--index) * 100ms)) to create sequential waterfall reveals. CRITICAL: For staggerChildren, the Parent (variants) and Children MUST reside in the identical Client Component tree. If data is fetched asynchronously, pass the data as props into a centralized Parent Motion wrapper.

5. PERFORMANCE GUARDRAILS

See references/ui-anti-slop.md §4 (Motion & Performance) — DOM cost, hardware acceleration, z-index restraint, grain/blur placement. No additions.

6. TECHNICAL REFERENCE (Dial Definitions)

DESIGN_VARIANCE (Level 1-10)

• 1-3 (Predictable): Flexbox justify-center, strict 12-column symmetrical grids, equal paddings.
• 4-7 (Offset): Use margin-top: -2rem overlapping, varied image aspect ratios (e.g., 4:3 next to 16:9), left-aligned headers over center-aligned data.
• 8-10 (Asymmetric): Masonry layouts, CSS Grid with fractional units (e.g., grid-template-columns: 2fr 1fr 1fr), massive empty zones (padding-left: 20vw).
• MOBILE OVERRIDE: For levels 4-10, any asymmetric layout above md: MUST aggressively fall back to a strict, single-column layout (w-full, px-4, py-8) on viewports < 768px to prevent horizontal scrolling and layout breakage.

MOTION_INTENSITY (Level 1-10)

• 1-3 (Static): No automatic animations. CSS :hover and :active states only.
• 4-7 (Fluid CSS): Use transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1). Use animation-delay cascades for load-ins. Focus strictly on transform and opacity. Use will-change: transform sparingly.
• 8-10 (Advanced Choreography): Complex scroll-triggered reveals or parallax. Use Framer Motion hooks. NEVER use window.addEventListener('scroll').

VISUAL_DENSITY (Level 1-10)

• 1-3 (Art Gallery Mode): Lots of white space. Huge section gaps. Everything feels very expensive and clean.
• 4-7 (Daily App Mode): Normal spacing for standard web apps.
• 8-10 (Cockpit Mode): Tiny paddings. No card boxes; just 1px lines to separate data. Everything is packed. Mandatory: Use Monospace (font-mono) for all numbers.

7. AI TELLS (FORBIDDEN PATTERNS)

The full forbidden-pattern list (visual/CSS, typography, layout/spacing, content "Jane Doe" effect, external resources) is in references/ui-anti-slop.md §1, §2, §3, §6, §7. This skill enforces all of them; no skill-specific additions beyond the Section 0 stricter stances.

8. THE CREATIVE ARSENAL (High-End Inspiration)

Do not default to generic UI. Pull from this library of advanced concepts to ensure the output is visually striking and memorable. When appropriate, leverage GSAP (ScrollTrigger/Parallax) for complex scrolltelling or ThreeJS/WebGL for 3D/Canvas animations, rather than basic CSS motion. CRITICAL: Never mix GSAP/ThreeJS with Framer Motion in the same component tree. Default to Framer Motion for UI/Bento interactions. Use GSAP/ThreeJS EXCLUSIVELY for isolated full-page scrolltelling or canvas backgrounds, wrapped in strict useEffect cleanup blocks.

The Standard Hero Paradigm

• Stop doing centered text over a dark image. Try asymmetric Hero sections: Text cleanly aligned to the left or right. The background should feature a high-quality, relevant image with a subtle stylistic fade (darkening or lightening gracefully into the background color depending on if it is Light or Dark mode).

Navigation & Menüs

• Mac OS Dock Magnification: Nav-bar at the edge; icons scale fluidly on hover.
• Magnetic Button: Buttons that physically pull toward the cursor.
• Gooey Menu: Sub-items detach from the main button like a viscous liquid.
• Dynamic Island: A pill-shaped UI component that morphs to show status/alerts.
• Contextual Radial Menu: A circular menu expanding exactly at the click coordinates.
• Floating Speed Dial: A FAB that springs out into a curved line of secondary actions.
• Mega Menu Reveal: Full-screen dropdowns that stagger-fade complex content.

Layout & Grids

• Bento Grid: Asymmetric, tile-based grouping (e.g., Apple Control Center).
• Masonry Layout: Staggered grid without fixed row heights (e.g., Pinterest).
• Chroma Grid: Grid borders or tiles showing subtle, continuously animating color gradients.
• Split Screen Scroll: Two screen halves sliding in opposite directions on scroll.
• Curtain Reveal: A Hero section parting in the middle like a curtain on scroll.

Cards & Containers

• Parallax Tilt Card: A 3D-tilting card tracking the mouse coordinates.
• Spotlight Border Card: Card borders that illuminate dynamically under the cursor.
• Glassmorphism Panel: True frosted glass with inner refraction borders.
• Holographic Foil Card: Iridescent, rainbow light reflections shifting on hover.
• Tinder Swipe Stack: A physical stack of cards the user can swipe away.
• Morphing Modal: A button that seamlessly expands into its own full-screen dialog container.

Scroll-Animations

• Sticky Scroll Stack: Cards that stick to the top and physically stack over each other.
• Horizontal Scroll Hijack: Vertical scroll translates into a smooth horizontal gallery pan.
• Locomotive Scroll Sequence: Video/3D sequences where framerate is tied directly to the scrollbar.
• Zoom Parallax: A central background image zooming in/out seamlessly as you scroll.
• Scroll Progress Path: SVG vector lines or routes that draw themselves as the user scrolls.
• Liquid Swipe Transition: Page transitions that wipe the screen like a viscous liquid.

Galleries & Media

• Dome Gallery: A 3D gallery feeling like a panoramic dome.
• Coverflow Carousel: 3D carousel with the center focused and edges angled back.
• Drag-to-Pan Grid: A boundless grid you can freely drag in any compass direction.
• Accordion Image Slider: Narrow vertical/horizontal image strips that expand fully on hover.
• Hover Image Trail: The mouse leaves a trail of popping/fading images behind it.
• Glitch Effect Image: Brief RGB-channel shifting digital distortion on hover.

Typography & Text

• Kinetic Marquee: Endless text bands that reverse direction or speed up on scroll.
• Text Mask Reveal: Massive typography acting as a transparent window to a video background.
• Text Scramble Effect: Matrix-style character decoding on load or hover.
• Circular Text Path: Text curved along a spinning circular path.
• Gradient Stroke Animation: Outlined text with a gradient continuously running along the stroke.
• Kinetic Typography Grid: A grid of letters dodging or rotating away from the cursor.

Micro-Interactions & Effects

• Particle Explosion Button: CTAs that shatter into particles upon success.
• Liquid Pull-to-Refresh: Mobile reload indicators acting like detaching water droplets.
• Skeleton Shimmer: Shifting light reflections moving across placeholder boxes.
• Directional Hover Aware Button: Hover fill entering from the exact side the mouse entered.
• Ripple Click Effect: Visual waves rippling precisely from the click coordinates.
• Animated SVG Line Drawing: Vectors that draw their own contours in real-time.
• Mesh Gradient Background: Organic, lava-lamp-like animated color blobs.
• Lens Blur Depth: Dynamic focus blurring background UI layers to highlight a foreground action.

9. THE "MOTION-ENGINE" BENTO PARADIGM

When generating modern SaaS dashboards or feature sections, you MUST utilize the following "Bento 2.0" architecture and motion philosophy. This goes beyond static cards and enforces a "Vercel-core meets Dribbble-clean" aesthetic heavily reliant on perpetual physics.

A. Core Design Philosophy

• Aesthetic: High-end, minimal, and functional.
• Palette: Background in #f9fafb. Cards are pure white (#ffffff) with a 1px border of border-slate-200/50.
• Surfaces: Use rounded-[2.5rem] for all major containers. Apply a "diffusion shadow" (a very light, wide-spreading shadow, e.g., shadow-[0_20px_40px_-15px_rgba(0,0,0,0.05)]) to create depth without clutter.
• Typography: Strict Geist, Satoshi, or Cabinet Grotesk font stack. Use subtle tracking (tracking-tight) for headers.
• Labels: Titles and descriptions must be placed outside and below the cards to maintain a clean, gallery-style presentation.
• Pixel-Perfection: Use generous p-8 or p-10 padding inside cards.

B. The Animation Engine Specs (Perpetual Motion)

All cards must contain "Perpetual Micro-Interactions." Use the following Framer Motion principles:

• Spring Physics: No linear easing. Use type: "spring", stiffness: 100, damping: 20 for a premium, weighty feel.
• Layout Transitions: Heavily utilize the layout and layoutId props to ensure smooth re-ordering, resizing, and shared element state transitions.
• Infinite Loops: Every card must have an "Active State" that loops infinitely (Pulse, Typewriter, Float, or Carousel) to ensure the dashboard feels "alive".
• Performance: Wrap dynamic lists in <AnimatePresence> and optimize for 60fps. PERFORMANCE CRITICAL: Any perpetual motion or infinite loop MUST be memoized (React.memo) and completely isolated in its own microscopic Client Component. Never trigger re-renders in the parent layout.

C. The 5-Card Archetypes (Micro-Animation Specs)

Implement these specific micro-animations when constructing Bento grids (e.g., Row 1: 3 cols | Row 2: 2 cols split 70/30):

1. The Intelligent List: A vertical stack of items with an infinite auto-sorting loop. Items swap positions using layoutId, simulating an AI prioritizing tasks in real-time.
2. The Command Input: A search/AI bar with a multi-step Typewriter Effect. It cycles through complex prompts, including a blinking cursor and a "processing" state with a shimmering loading gradient.
3. The Live Status: A scheduling interface with "breathing" status indicators. Include a pop-up notification badge that emerges with an "Overshoot" spring effect, stays for 3 seconds, and vanishes.
4. The Wide Data Stream: A horizontal "Infinite Carousel" of data cards or metrics. Ensure the loop is seamless (using x: ["0%", "-100%"]) with a speed that feels effortless.
5. The Contextual UI (Focus Mode): A document view that animates a staggered highlight of a text block, followed by a "Float-in" of a floating action toolbar with micro-icons.

10. FINAL PRE-FLIGHT CHECK

Evaluate your code against this matrix before outputting. This is the last filter you apply to your logic.

• Is global state used appropriately to avoid deep prop-drilling rather than arbitrarily?
• Is mobile layout collapse (w-full, px-4, max-w-7xl mx-auto) guaranteed for high-variance designs?
• Do full-height sections safely use min-h-[100dvh] instead of the bugged h-screen?
• Do useEffect animations contain strict cleanup functions?
• Are empty, loading, and error states provided?
• Are cards omitted in favor of spacing where possible?
• Did you strictly isolate CPU-heavy perpetual animations in their own Client Components?