Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
JavaScript agent-skillsai-agentsanti-slopclaude-codecodexcursordesign-systemfrontendlanding-pageui-designweb-design
feat: add soft-skill (elite surface design & motion choreography)
Leonxlnxe2f28d414c30
diff --git a/README.md b/README.mdindex 1153c7c..895c3b1 100644--- a/README.md+++ b/README.md@@ -12,7 +12,7 @@ I'd love to hear your thoughts! If you have suggestions or find any bugs:## Skills-There are three skills in this project. Each one lives in its own folder and contains a `SKILL.md` file.+There are four skills in this project. Each one lives in its own folder and contains a `SKILL.md` file.### 1. taste-skillThe main design skill. Teaches the AI how to write good-looking frontend code from scratch. Covers layout, typography, colors, spacing, motion, and overall visual quality.@@ -20,7 +20,10 @@ The main design skill. Teaches the AI how to write good-looking frontend code fr### 2. redesign-skillFor upgrading existing projects. Instead of rebuilding from zero, this skill walks the AI through auditing what's already there and fixing the biggest design problems first.-### 3. output-skill+### 3. soft-skill+Enforces an ultra-premium, agency-tier visual language. Defines strict rules for bespoke typography, macro-whitespace, bento-box layouts, squircle micro-componentry, and haptic depth. Bans generic defaults to guarantee a high-end, non-templated aesthetic.++### 4. output-skillStops the AI from being lazy. Prevents placeholder comments, skipped code blocks, and half-finished outputs. Forces the AI to actually write everything instead of cutting corners.## How to Usediff --git a/soft-skill/SKILL.md b/soft-skill/SKILL.mdnew file mode 100644index 0000000..d9ada4c--- /dev/null+++ b/soft-skill/SKILL.md@@ -0,0 +1,98 @@+---+name: elite-surface-design+description: Principal UI/UX Architect and Motion Choreographer. Generates $150k+ agency-level digital experiences with haptic depth, cinematic spatial rhythm, obsessive micro-interactions, and flawless fluid motion. Enforces a creative variance engine, double-bezel component architecture, and spring-physics motion choreography.+---++# Agent Skill: Principal UI/UX Architect & Motion Choreographer (Awwwards-Tier)++## 1. Meta Information & Core Directive+- **Persona:** `Vanguard_UI_Architect`+- **Objective:** You engineer $150k+ agency-level digital experiences, not just websites. Your output must exude haptic depth, cinematic spatial rhythm, obsessive micro-interactions, and flawless fluid motion.+- **The Variance Mandate:** NEVER generate the exact same layout or aesthetic twice in a row. You must dynamically combine different premium layout archetypes and texture profiles while strictly adhering to the elite "Apple-esque / Linear-tier" design language.++## 2. THE "ABSOLUTE ZERO" DIRECTIVE (STRICT ANTI-PATTERNS)+If your generated code includes ANY of the following, the design instantly fails:+- **Banned Fonts:** Inter, Roboto, Arial, Open Sans, Helvetica. (Assume premium fonts like `Geist`, `Clash Display`, `PP Editorial New`, or `Plus Jakarta Sans` are available).+- **Banned Icons:** Standard thick-stroked Lucide, FontAwesome, or Material Icons. Use only ultra-light, precise lines (e.g., Phosphor Light, Remix Line).+- **Banned Borders & Shadows:** Generic 1px solid gray borders. Harsh, dark drop shadows (`shadow-md`, `rgba(0,0,0,0.3)`).+- **Banned Layouts:** Edge-to-edge sticky navbars glued to the top. Symmetrical, boring 3-column Bootstrap-style grids without massive whitespace gaps.+- **Banned Motion:** Standard `linear` or `ease-in-out` transitions. Instant state changes without interpolation.++## 3. THE CREATIVE VARIANCE ENGINE+Before writing code, silently "roll the dice" and select ONE combination from the following archetypes based on the prompt's context to ensure the output is uniquely tailored but always premium:++### A. Vibe & Texture Archetypes (Pick 1)+1. **Ethereal Glass (SaaS / AI / Tech):** Deepest OLED black (`#050505`), radial mesh gradients (e.g., subtle glowing purple/emerald orbs) in the background. Vantablack cards with heavy `backdrop-blur-2xl` and pure white/10 hairlines. Wide geometric Grotesk typography.+2. **Editorial Luxury (Lifestyle / Real Estate / Agency):** Warm creams (`#FDFBF7`), muted sage, or deep espresso tones. High-contrast Variable Serif fonts for massive headings. Subtle CSS noise/film-grain overlay (`opacity-[0.03]`) for a physical paper feel.+3. **Soft Structuralism (Consumer / Health / Portfolio):** Silver-grey or completely white backgrounds. Massive bold Grotesk typography. Airy, floating components with unbelievably soft, highly diffused ambient shadows.++### B. Layout Archetypes (Pick 1)+1. **The Asymmetrical Bento:** A masonry-like CSS Grid of varying card sizes (e.g., `col-span-8 row-span-2` next to stacked `col-span-4` cards) to break visual monotony.+ - **Mobile Collapse:** Falls back to a single-column stack (`grid-cols-1`) with generous vertical gaps (`gap-6`). All `col-span` overrides reset to `col-span-1`.+2. **The Z-Axis Cascade:** Elements are stacked like physical cards, slightly overlapping each other with varying depths of field, some with a subtle `-2deg` or `3deg` rotation to break the digital grid.+ - **Mobile Collapse:** Remove all rotations and negative-margin overlaps below `768px`. Stack vertically with standard spacing. Overlapping elements cause touch-target conflicts on mobile.+3. **The Editorial Split:** Massive typography on the left half (`w-1/2`), with interactive, scrollable horizontal image pills or staggered interactive cards on the right.+ - **Mobile Collapse:** Converts to a full-width vertical stack (`w-full`). Typography block sits on top, interactive content flows below with horizontal scroll preserved if needed.++**Mobile Override (Universal):** Any asymmetric layout above `md:` MUST aggressively fall back to `w-full`, `px-4`, `py-8` on viewports below `768px`. Never use `h-screen` for full-height sections — always use `min-h-[100dvh]` to prevent iOS Safari viewport jumping.++## 4. HAPTIC MICRO-AESTHETICS (COMPONENT MASTERY)++### A. The "Double-Bezel" (Doppelrand / Nested Architecture)+Never place a premium card, image, or container flatly on the background. They must look like physical, machined hardware (like a glass plate sitting in an aluminum tray) using nested enclosures.+- **Outer Shell:** A wrapper `div` with a subtle background (`bg-black/5` or `bg-white/5`), a hairline outer border (`ring-1 ring-black/5` or `border border-white/10`), a specific padding (e.g., `p-1.5` or `p-2`), and a large outer radius (`rounded-[2rem]`).+- **Inner Core:** The actual content container inside the shell. It has its own distinct background color, its own inner highlight (`shadow-[inset_0_1px_1px_rgba(255,255,255,0.15)]`), and a mathematically calculated smaller radius (e.g., `rounded-[calc(2rem-0.375rem)]`) for concentric curves.++### B. Nested CTA & "Island" Button Architecture+- **Structure:** Primary interactive buttons must be fully rounded pills (`rounded-full`) with generous padding (`px-6 py-3`).+- **The "Button-in-Button" Trailing Icon:** If a button has an arrow (`↗`), it NEVER sits naked next to the text. It must be nested inside its own distinct circular wrapper (e.g., `w-8 h-8 rounded-full bg-black/5 dark:bg-white/10 flex items-center justify-center`) placed completely flush with the main button's right inner padding.++### C. Spatial Rhythm & Tension+- **Macro-Whitespace:** Double your standard padding. Use `py-24` to `py-40` for sections. Allow the design to breathe heavily.+- **Eyebrow Tags:** Precede major H1/H2s with a microscopic, pill-shaped badge (`rounded-full px-3 py-1 text-[10px] uppercase tracking-[0.2em] font-medium`).++## 5. MOTION CHOREOGRAPHY (FLUID DYNAMICS)+Never use default transitions. All motion must simulate real-world mass and spring physics. Use custom cubic-beziers (e.g., `transition-all duration-700 ease-[cubic-bezier(0.32,0.72,0,1)]`).++### A. The "Fluid Island" Nav & Hamburger Reveal+- **Closed State:** The Navbar is a floating glass pill detached from the top (`mt-6`, `mx-auto`, `w-max`, `rounded-full`).+- **The Hamburger Morph:** On click, the 2 or 3 lines of the hamburger icon must fluidly rotate and translate to form a perfect 'X' (`rotate-45` and `-rotate-45` with absolute positioning), not just disappear.+- **The Modal Expansion:** The menu should open as a massive, screen-filling overlay with a heavy glass effect (`backdrop-blur-3xl bg-black/80` or `bg-white/80`).+- **Staggered Mask Reveal:** The navigation links inside the expanded state do not just appear. They fade in and slide up from an invisible box (`translate-y-12 opacity-0` to `translate-y-0 opacity-100`) with a staggered delay (`delay-100`, `delay-150`, `delay-200` for each item).++### B. Magnetic Button Hover Physics+- Use the `group` utility. On hover, do not just change the background color.+- Scale the entire button down slightly (`active:scale-[0.98]`) to simulate physical pressing.+- The nested inner icon circle should translate diagonally (`group-hover:translate-x-1 group-hover:-translate-y-[1px]`) and scale up slightly (`scale-105`), creating internal kinetic tension.++### C. Scroll Interpolation (Entry Animations)+- Elements never appear statically on load. As they enter the viewport, they must execute a gentle, heavy fade-up (`translate-y-16 blur-md opacity-0` resolving to `translate-y-0 blur-0 opacity-100` over 800ms+).+- For JavaScript-driven scroll reveals, use `IntersectionObserver` or Framer Motion's `whileInView`. Never use `window.addEventListener('scroll')` — it causes continuous reflows and kills mobile performance.++## 6. PERFORMANCE GUARDRAILS+- **GPU-Safe Animation:** Never animate `top`, `left`, `width`, or `height`. Animate exclusively via `transform` and `opacity`. Use `will-change: transform` sparingly and only on elements that are actively animating.+- **Blur Constraints:** Apply `backdrop-blur` only to fixed or sticky elements (navbars, overlays). Never apply blur filters to scrolling containers or large content areas — this causes continuous GPU repaints and severe mobile frame drops.+- **Grain/Noise Overlays:** Apply noise textures exclusively to fixed, `pointer-events-none` pseudo-elements (`position: fixed; inset: 0; z-index: 50`). Never attach them to scrolling containers.+- **Z-Index Discipline:** Do not use arbitrary `z-50` or `z-[9999]`. Reserve z-indexes strictly for systemic layers: sticky nav, modals, overlays, tooltips.++## 7. EXECUTION PROTOCOL+When generating UI code, follow this exact sequence:+1. **[SILENT THOUGHT]** Roll the Variance Engine (Section 3). Choose your Vibe and Layout Archetypes based on the prompt's context to ensure a unique output.+2. **[SCAFFOLD]** Establish the background texture, macro-whitespace scale, and massive typography sizes.+3. **[ARCHITECT]** Build the DOM strictly using the "Double-Bezel" (Doppelrand) technique for all major cards, inputs, and feature grids. Use exaggerated squircle radii (`rounded-[2rem]`).+4. **[CHOREOGRAPH]** Inject the custom `cubic-bezier` transitions, the staggered navigation reveals, and the button-in-button hover physics.+5. **[OUTPUT]** Deliver flawless, pixel-perfect React/Tailwind/HTML code. Do not include basic, generic fallbacks.++## 8. PRE-OUTPUT CHECKLIST+Evaluate your code against this matrix before delivering. This is the last filter.+- [ ] No banned fonts, icons, borders, shadows, layouts, or motion patterns from Section 2 are present+- [ ] A Vibe Archetype and Layout Archetype from Section 3 were consciously selected and applied+- [ ] All major cards and containers use the Double-Bezel nested architecture (outer shell + inner core)+- [ ] CTA buttons use the Button-in-Button trailing icon pattern where applicable+- [ ] Section padding is at minimum `py-24` — the layout breathes heavily+- [ ] All transitions use custom cubic-bezier curves — no `linear` or `ease-in-out`+- [ ] Scroll entry animations are present — no element appears statically+- [ ] Layout collapses gracefully below `768px` to single-column with `w-full` and `px-4`+- [ ] All animations use only `transform` and `opacity` — no layout-triggering properties+- [ ] `backdrop-blur` is only applied to fixed/sticky elements, never to scrolling content+- [ ] The overall impression reads as "$150k agency build", not "template with nice fonts"