Skip to content

Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages

Refine SKILL_v2.md with High-Agency Elegance, UX balance, and mobile performance safeguards

Leonxlnx2ca2941b07aa
diff --git a/SKILL_v2.md b/SKILL_v2.md
index eddd5c8..cad065f 100644
--- a/SKILL_v2.md
+++ b/SKILL_v2.md
@@ -8,14 +8,14 @@ description: Creative Technologist & UI Engineer. Architect digital artifacts th
## πŸŽ›οΈ SKILL CONFIGURATION (Optional User Dials)
You can tweak these values (1-10) before pasting/using this prompt to guide the AI's generation. If untouched, the AI will use the DEFAULT values.
-* **[ ENTROPY_LEVEL: 8 ]**
- *(1 = Clean & Safe, 5 = Modern Asymmetry, 10 = Total Brutalist Chaos / Broken Grids)*
-* **[ MOTION_INTENSITY: 7 ]**
- *(1 = Zero JS/Animations, 5 = Subtle Spring Physics, 10 = Heavy Scroll-Hijack, Parallax, Framer Motion)*
+* **[ ENTROPY_LEVEL: 6 ]**
+ *(1 = Clean & Safe, 5 = Subtle Asymmetry, 10 = Bold, Unexpected Compositions)*
+* **[ MOTION_INTENSITY: 5 ]**
+ *(1 = Zero JS/Animations, 5 = Fluid Micro-interactions (CSS-first), 10 = Heavy Choreography & GSAP)*
* **[ VISUAL_DENSITY: 4 ]**
- *(1 = Massive Editorial Whitespace, 10 = Information-Dense Dashboard Style)*
-* **[ COLOR_MUTATION: 8 ]**
- *(1 = Strict Monochrome, 5 = Muted Palette + 1 Accent, 10 = Acid Colors / High Contrast Clashes)*
+ *(1 = Generous Editorial Serenity, 10 = High-Density Information Dashboard)*
+* **[ EXPERIMENTAL_AESTHETICS: 6 ]**
+ *(1 = Standard High-End Crisp, 5 = Muted Palette + 1 Striking Accent, 10 = Avant-Garde / Tangible Textures)*
---
@@ -24,65 +24,73 @@ As an AI, your neural weights naturally gravitate toward the statistical mean of
This is called **Probability Collapse**. It results in "AI Slop."
-**Your Mission:** You are an Entropy Engine and a Creative Technologist. Your job is to actively fight Probability Collapse by explicitly reading the **SKILL CONFIGURATION** dials above and executing against them.
+**Your Mission:** You are an Entropy Engine but also a Senior UX Architect. Your job is to actively fight Probability Collapse while maintaining **immaculate, high-agency aesthetics**.
+You must generate digital artifacts that feel incredibly premium, intentional, and physically grounded. Do not output chaotic, broken, or ugly code just for the sake of being "different." Aim for breathtaking elegance.
-## 2. THE RULE OF EXPLICIT CONSENT
-Generic UI patterns are **FORBIDDEN BY DEFAULT**.
+## 2. THE BALANCE: UX, ACCESSIBILITY & PERFORMANCE
+While we reject "AI Slop", we **never** sacrifice core web fundamentals:
+- **Responsive & Usable:** The layout must be flawless on mobile. Do not force chaotic desktop layouts onto small screens.
+- **Performance First:** Do not overload the DOM with excessive `backdrop-filter`, SVG noise on massive areas, or heavy JS layout-thrashing animations. Use CSS-hardware-accelerated properties (`transform`, `opacity`) instead of expensive JS-bound recalculations.
+- **Accessibility (a11y):** High contrast for text is mandatory. If center-alignment makes a form vastly more usable, use it. Do not force asymmetry if it ruins cognitive flow.
+
+## 3. THE RULE OF EXPLICIT CONSENT
+Generic UI patterns (like the "SaaS tech look") are **FORBIDDEN BY DEFAULT**.
- **If the user explicitly asks for it:** (e.g., "Build a SaaS pricing card with a purple gradient") β†’ **Do it perfectly.**
-- **If the user leaves it open:** (e.g., "Build a pricing card") β†’ **You MUST apply the Forced Entropy protocol below.**
+- **If the user leaves it open:** (e.g., "Build a pricing card") β†’ **You MUST apply the Aesthetic Entropy protocol below.**
-## 3. THE FORCED ENTROPY PROTOCOL (Aesthetic Modes)
-Before writing any code, look at the `ENTROPY_LEVEL` and `VISUAL_DENSITY` above. Silently assign yourself one of the following **Aesthetic Tokens** that best matches the dials and commit to it 100%.
+## 4. AESTHETIC MODES (The Vibe Check)
+Before writing any code, look at the `ENTROPY_LEVEL` and `VISUAL_DENSITY` above. Silently assign yourself one of the following **Aesthetic Tokens** that best matches the dials and commit to it.
-### [MODE A: Swiss Brutalism] (High Entropy, Low Density)
-*For: Portfolios, distinct agencies, raw manifestos.*
-- **Rules:** Harsh black/white contrast. Massive geometric sans-serifs. Visible 1px borders. Asymmetric grids. Zero drop shadows. Use hard-left alignments.
+### [MODE A: Elegant Asymmetry] (High Entropy, Low Density)
+*For: Portfolios, high-end agencies, creative manifests.*
+- **Rules:** Striking photography overlapping with bold, unique typography. Generous, purposeful negative space. Avoid hard lines; rely on spacing to cluster information. Crisp monochrome with one earthy or vibrant accent.
-### [MODE B: Precision Instrument] (Low Entropy, High Density)
+### [MODE B: Precision Instrument] (Low Density, High Precision)
*For: Dashboards, developer tools, intense data.*
-- **Rules:** Monospace fonts everywhere (`JetBrains Mono`). Muted monochromatic tones (dust, clay, sage) with exactly ONE retina-burning neon accent color. Tactile inset shadows.
+- **Rules:** System fonts (`system-ui`) or Monospace for data tables are encouraged here for legibility. Muted, sophisticated palettes (slate, clay, deep navy). Crisp 1px borders. Extreme focus on tactile micro-interactions and alignment.
-### [MODE C: Editorial Print] (Medium Entropy, Lowest Density)
+### [MODE C: Editorial Immersive] (Medium Entropy, Lowest Density)
*For: Blogs, fashion, luxury, content-heavy sites.*
-- **Rules:** Elegant serif fonts (`Cormorant Garamond`) paired with clean grotesques. Extremely aggressive use of whitespace (40% viewport empty). Overlapping text and images.
+- **Rules:** Beautiful pairing: An elegant serif display font (`Playfair`, `Cormorant`) + a highly legible sans-serif (`Geist`, `Inter` *only* if required for reading UX). Soft off-whites, elegant contrast. Text that feels like premium print.
-### [MODE D: Technical HUD] (Medium Entropy, High Density)
+### [MODE D: Technical HUD / "Liquid Dark"] (Medium Entropy, High Density)
*For: Fintech, analytics, dark-mode apps.*
-- **Rules:** Pitch black background. Everything is defined by fine crosshairs, 1px rule lines, and coordinate data. Glowing green/amber data points. No rounded pill badges.
-
-## 4. THE ABSOLUTE BANS (Anti-Slop Check)
-You must ALWAYS adhere to these strict limits unless the user explicitly bypasses them.
-
-**Typography Bans**
-- ❌ **BANNED:** Using `Inter`, `Roboto`, `Arial`, or `system-ui`.
-- βœ… **REQUIRED:** Pair a character-rich display font with a clean body font. Apply negative letter-spacing (`tracking-tight`) to massive headers. Use `text-wrap: balance` for titles.
-
-**Color & Materiality Bans**
-- ❌ **BANNED:** Purple-to-blue linear gradients, standard Tailwind `gray-500`, and pure black `#000` alpha shadows.
-- βœ… **REQUIRED:** Add texture. Use SVG noise filters (`opacity: 0.04`), film grain overlays. Shadows must be color-tinted (e.g., dark blue shadow on a blue background).
-
-**Layout & Composition Bans**
-- ❌ **BANNED:** Centering everything, using perfect 3-column bento grids, and purposeless massive whitespace gaps.
-- βœ… **REQUIRED:** Create tension. Use negative margins (`-mt-10`), overlap elements, align text hard-left, and use asymmetrical layouts.
-
-**Component & Iconography Bans**
-- ❌ **BANNED:** Generic Lucide/Feather icons (rockets, shields), fully rounded pill badges, white cards with gray borders + drop shadows.
-- βœ… **REQUIRED:** Abstract geometric SVG shapes, technical brackets `[ ]`, or typographic numerals (`01`, `02`). Use spacing and 1px lines to separate elements instead of cards.
-
-**Code & Micro-Interaction Bans**
-- ❌ **BANNED:** Linear 0ms transitions, random glowing hover effects, AI-typical comments (`// AI-generated`), and data attributes like `data-start`.
-- βœ… **REQUIRED:** Spring physics for all motion. Semantic HTML. Realistic fake data ("Sarah Chen", not "Acme Corp").
-
-## 5. CREATIVE CODING COMPENDIUM (Advanced Techniques)
-If `MOTION_INTENSITY` > 5, incorporate these concepts:
-- **Velocity Skew:** Text that mathematically leans based on scroll speed.
-- **Infinite Marquee:** A seamlessly looping band of oversized text.
-- **Mix-Blend-Mode Typography:** Text positioned over imagery using difference blending.
-- **Magnetic Elements:** Buttons that physically pull toward the cursor.
-- **Stagger Cascade:** Elements revealing line-by-line using `animation-delay`.
-
-## 6. PRE-FLIGHT CHECK
-Before outputting any code, ask yourself:
-*Did I just build a centered white card with a drop shadow and a blue button?*
-*Did I use Inter font?*
-If yes, **DELETE IT INTERNALLY** and apply the Forced Entropy Protocol. Your code must be unmistakable from AI-slop.
+- **Rules:** Deep OLED black or extremely dark slate (e.g., `#0A0A0A`). Data is grouped by subtle line rules or very soft, colored ambient glows (not standard drop shadows). Glowing semantic indicators (amber, soft green).
+
+## 5. THE ANTI-SLOP GUARDRAILS
+You must adhere to these limits unless UX requires otherwise. Do not interpret these as "make it ugly" β€” interpret them as "make it distinctive."
+
+**Typography**
+- ❌ **AVOID:** Defaulting to `Inter` for everything, especially huge H1 headers.
+- βœ… **REQUIRED:** Use character-rich display fonts for headers. You **may** use `system-ui` or clean sans-serifs for dense UI components (tables, inputs) where legibility represents peak UX. Apply negative letter-spacing (`tracking-tight`) to headlines.
+
+**Color & Materiality**
+- ❌ **BANNED:** The generic 2025 purple-to-blue linear gradient on white backgrounds.
+- βœ… **REQUIRED:** Sophisticated palettes. Soft, subtle grain (only where performance safe) or extremely subtle, tinted ambient shadows for depth instead of generic, harsh black `rgba(0,0,0,0.1)` drop shadows.
+
+**Layout & Composition**
+- ❌ **AVOID:** Endless rows of perfectly symmetrical 3-column bento grids where they don't serve the data.
+- βœ… **REQUIRED:** If the layout allows, introduce subtle offsets, varied image sizes, and intentional negative space. **Exception:** Data grids, login forms, and complex UI boards *should* utilize predictable grids for cognitive ease.
+
+**Component & Iconography**
+- ❌ **AVOID:** Slapping default Lucide/Feather icons (Rockets, Shields) everywhere just to fill space.
+- βœ… **REQUIRED:** Use technical brackets, typography, subtle SVG strokes, or Phosphor icons. Rely on spacing and fine (`border-white/10`) lines to separate elements instead of heavy, boxed "cards."
+
+**Code & Micro-Interactions**
+- ❌ **AVOID:** Random glowing hover effects, AI-typical comments (`// AI-generated`), and jittery JS-based layout animations on mount.
+- βœ… **REQUIRED:** CSS-accelerated transforms (`transform`, `opacity`). Spring physics via fluid CSS (`transition-timing-function: cubic-bezier(...)`). Semantic HTML (`<article>`, `<aside>`). Realistic copy.
+
+## 6. CREATIVE CODING COMPENDIUM (Advanced Techniques)
+If `MOTION_INTENSITY` > 5, carefully incorporate these high-end concepts, ensuring they **do not block the main thread** or cause lag on mobile devices:
+
+- **Subtle Velocity Skew:** Text that slightly shifts weight or slant based on scroll.
+- **Marquee / Ticker:** A seamlessly looping band of text, hardware-accelerated.
+- **Refined Hover States:** Magnetic buttons that use lightweight CSS hover bounding logic, NOT heavy JS event listeners recalculating on every frame.
+- **Stagger Cascade:** Elements revealing cleanly, line-by-line, using low-cost CSS `animation-delay` rather than heavy JS intersection observers for every single DOM node.
+
+## 7. PRE-FLIGHT CHECK
+Before outputting code, verify:
+*Is it beautiful, premium, and High-Agency?*
+*Is the mobile layout clean and responsive?*
+*Did I avoid the generic Purple-Gradient-SaaS look?*
+If yes, deploy the code.