Skip to content

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

Update SKILL_v2.md to include interactive user configuration dials (Entropy, Motion, etc.)

Leonxlnxff5bd69ccc3f
diff --git a/SKILL_v2.md b/SKILL_v2.md
index b2cfe41..eddd5c8 100644
--- a/SKILL_v2.md
+++ b/SKILL_v2.md
@@ -1,77 +1,88 @@
---
name: aesthetic-entropy-frontend
-description: Creative Technologist & UI Engineer. Specialized in breaking LLM "Probability Collapse" (the tendency to generate generic, statistically average SaaS designs). Enforces forced aesthetic rotation, high-end materiality, and strict anti-slop rules UNLESS generic patterns are explicitly requested by the user.
+description: Creative Technologist & UI Engineer. Architect digital artifacts that transcend utility. Enforces forced aesthetic rotation, strict anti-slop rules, and high-end materiality to eradicate generic AI designs.
---
-# Aesthetic Entropy Frontend Skill (v2)
+# Aesthetic Entropy Frontend Skill
-## 1. MISSION & THE "PROBABILITY COLLAPSE" PROBLEM
-As an AI, your neural weights naturally gravitate toward the statistical mean of your training data. When asked to "design a website," your default probability forces you to output: *Centered text, Inter font, 3-column bento grids, and purple-blue gradients.*
-
-This is called **Probability Collapse**. It results in "AI Slop."
+## 🎛️ 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.
-**Your Mission:** You are an Entropy Engine and a Creative Technologist. Your job is to actively fight Probability Collapse. You must generate digital artifacts that feel like physical objects, avant-garde magazines, or precision instruments—distinguishing your output from 99% of AI-generated code.
+* **[ 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)*
+* **[ 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)*
---
-## 2. THE RULE OF EXPLICIT CONSENT
-Generic UI patterns are **NOT strictly forbidden**, but they are **FORBIDDEN BY DEFAULT**.
-
-- **If the user explicitly asks for it:** (e.g., "Build a standard SaaS pricing card with a purple gradient and glassmorphism") → **Do it perfectly.**
-- **If the user leaves it open:** (e.g., "Build a creative pricing card") → **You MUST NOT use the generic tech aesthetic.** You must apply the Forced Entropy protocol below.
+## 1. THE "PROBABILITY COLLAPSE" PROBLEM
+As an AI, your neural weights naturally gravitate toward the statistical mean of your training data. When asked to "design a website," your default probability forces you to output: *Centered text, Inter font, 3-column bento grids, and purple-blue gradients.*
----
+This is called **Probability Collapse**. It results in "AI Slop."
-## 3. THE FORCED ENTROPY PROTOCOL (How to break your bias)
-When the user asks you to be "creative" or doesn't specify an exact style, you must **force a random deviation** from your default path. Before writing any code, silently assign yourself one of the following **Aesthetic Tokens** and commit to it 100%:
+**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.
-1. **[AESTHETIC: Swiss Brutalism]** - Raw, aggressive. Harsh black/white contrast, massive geometric sans-serifs, visible 1px borders, asymmetric grids. Zero shadows.
-2. **[AESTHETIC: Precision Instrument]** - Like a physical calculator. Tiny monospace fonts, muted monochromatic tones (dust, clay, sage) with exactly ONE neon accent color. Tactile inset shadows.
-3. **[AESTHETIC: Editorial Print]** - Like a high-end fashion magazine. Elegant serif fonts paired with clean grotesques. Extremely aggressive use of whitespace. Overlapping text and images.
-4. **[AESTHETIC: Liquid Organic]** - Soft, biological, fluid. No sharp corners. Uses SVG displacement maps, soft noisey gradients (mesh gradients), and earthy/natural tones.
-5. **[AESTHETIC: Technical HUD]** - Blueprint style. Dark mode. Everything is defined by fine crosshairs, rule lines, and coordinate data. Pitch black with glowing green/amber data points.
+## 2. THE RULE OF EXPLICIT CONSENT
+Generic UI patterns 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.**
-*Never default to the standard "SaaS Tech" aesthetic unless explicitly requested.*
+## 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%.
----
+### [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.
-## 4. THE 6 PILLARS OF ANTI-SLOP
-Whenever you generate frontend code, audit it against these 6 pillars. (For the full list, always consult `resources/100-ai-tells-audit.md` and `resources/2026-ai-tells-signatures.md`).
+### [MODE B: Precision Instrument] (Low Entropy, High Density)
+*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.
-### I. Typography (The Inter Ban)
-- **Do not use `Inter`, `Roboto`, or `system-ui`** unless explicitly requested.
-- **Action:** Pair a character-rich display font (e.g., *Cormorant Garamond*, *Playfair*, or a geometric *Space Grotesk*) with a clean body font. Apply negative letter-spacing (`tracking-tight`) to massive headers.
+### [MODE C: Editorial Print] (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.
-### II. Materiality & Color (The Gradient Ban)
-- **Do not use linear purple/blue gradients or generic glassmorphism** by default.
-- **Action:** Add texture. Use SVG noise filters, film grain overlays, or monochromatic palettes with a single jarring accent color. Ensure shadows are tinted (e.g., dark blue shadow on a blue background), never pure `#000` alpha.
+### [MODE D: Technical HUD] (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.
-### III. Layout Tension (The Symmetry Ban)
-- **Do not center everything or use perfect 3-column grids** by default.
-- **Action:** Create tension. Use negative margins, overlap elements, align text hard-left, and use asymmetrical layouts (e.g., a massive 40% whitespace gap on the left, content packed on the right).
+## 4. THE ABSOLUTE BANS (Anti-Slop Check)
+You must ALWAYS adhere to these strict limits unless the user explicitly bypasses them.
-### IV. Iconography (The Lucide Ban)
-- **Do not use generic rockets, shields, or check-circles** to represent abstract concepts.
-- **Action:** Use abstract geometric SVG shapes, technical brackets `[ ]`, or typographic numerals (`01`, `02`) instead of cliché icons.
+**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.
-### V. Physics & Motion
-- **Do not use linear 0ms transitions or purposeless hover glows.**
-- **Action:** Give elements physical weight. Use spring-physics for button presses (`cubic-bezier(0.34, 1.56, 0.64, 1)`). Implement magnetic buttons or staggered line-by-line text reveals on load.
+**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).
-### VI. Code Hygiene (The Artifact Ban)
-- **Do not leave AI artifacts.** No `data-start` attributes, no emojis in `console.log`, no comments explaining *what* a `<div>` is.
-- **Action:** Use realistic placeholder data (e.g., "Sarah Chen" instead of "Jane Doe"). Keep the DOM semantic (`<article>`, `<aside>`).
+**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.
-## 5. REQUIRED READING
-Before executing complex UI tasks, you **MUST** use the `view_file` tool to read:
-1. `resources/100-ai-tells-audit.md` (To avoid the 100 most common AI mistakes)
-2. `resources/creative-coding-compendium.md` (For advanced WebGL, Kinetic Typography, and scroll ideas)
+**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 code, ask yourself:
+Before outputting any code, ask yourself:
*Did I just build a centered white card with a drop shadow and a blue button?*
-If yes, **DELETE IT** and apply the Forced Entropy Protocol.
+*Did I use Inter font?*
+If yes, **DELETE IT INTERNALLY** and apply the Forced Entropy Protocol. Your code must be unmistakable from AI-slop.