Skip to content

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

Overhaul SKILL.md: Replace subjective Prime Directive with React-first rules, Tailwind vs Raw CSS separation, prohibit Vanilla JS DOM manipulation, safeguard grain filters, and provide concrete inline scenarios.

Leonxlnx301289954ec2
diff --git a/SKILL.md b/SKILL.md
index 51b389c..56db300 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,225 +1,114 @@
---
-name: anti-slop-frontend
-description: Creative Technologist & Senior Frontend Engineer skill. Architect digital artifacts that transcend utility — interfaces that feel like physical objects, avant-garde magazines, or precision instruments. Enforces strict anti-patterns, advanced kinetic techniques, and contextual aesthetic modes to eradicate "AI Slop" from every output.
+name: high-agency-frontend
+description: Creative Technologist & Senior Frontend Engineer skill. Architect digital artifacts using measurable constraints, React-first architecture, specific Tailwind + Raw CSS separation, and strict interaction modes to eradicate "AI Slop".
---
-# Anti-Slop Frontend Skill
+# High-Agency Frontend Skill
-## Mission
-Build interfaces that feel like **physical objects**, avant-garde magazines, or precision instruments.
-**PRIME DIRECTIVE**: Eliminate all generic patterns. If the output resembles a standard template, a Dribbble clone, or a default component library, it is a **failure**.
+## 1. DEFAULT ARCHITECTURE & TOOLING
----
+**Framework & State:**
+- React or Next.js (Server Components by default; `"use client"` strictly at the leaf level for interactive UI).
+- Use local `useState`/`useReducer` for UI state. Global state is only for preventing deep prop-drilling across the component tree.
+- Generate full interaction states proactively: **Loading** (Skeletons, not spinners), **Empty** (designed placeholders), and **Error** (inline feedback).
-## 1. THE ANTI-PATTERNS (STRICTLY FORBIDDEN)
+**Styling Separation:**
+- **Styling Rule:** Use Tailwind CSS for 90% of styling (layout, colors, spacing). Use raw CSS (or CSS Modules) ONLY for complex `@keyframes`, `clamp()` typography, and pseudo-element grain filters where Tailwind strings become unreadable.
-Before writing a single line of CSS, internalize these forbidden patterns.
+**Animation & DOM:**
+- **No Vanilla JS DOM manipulation** (e.g., `document.querySelector`, `el.addEventListener`).
+- For complex physics or DOM events, strictly use React patterns: `useRef` and `useEffect`. **Mandatory:** `useEffect` hooks implementing listeners MUST return a cleanup function to prevent memory leaks.
+- Prefer `framer-motion` for complex physics and choreography.
-### Visual Syntax Errors
+---
-| ❌ Forbidden | ✅ Alternative |
-|---|---|
-| Purple-to-blue tech gradient | Muted editorial tones, grain overlays, or hard geometric color blocks |
-| Neon / outer glow box-shadows | Hard-edged retro shadows, colored shadows matching bg hue, or no shadow at all |
-| Glassmorphism everywhere | Solid opacity layers, dithering patterns, or tactile texture instead of blur |
-| Pure black alpha shadows | Colored shadows (e.g., deep navy on blue bg) or flat neo-brutalist borders |
-| Perfect center alignment | Asymmetric layouts; indent unexpectedly; left-anchor with intentional offset |
+## 2. THE ANTI-PATTERNS (STRICTLY FORBIDDEN)
-### Component Clichés
+Before writing any code, internalize these forced constraints:
-| ❌ Forbidden | ✅ Alternative |
+| ❌ Forbidden / Generic | ✅ High-Agency Alternative |
|---|---|
-| 3-column rounded bento grid | Broken grids, masonry layouts, or overlapping sections |
-| Rocket / shield / lock icons | Abstract geometry, technical crosshairs, or raw typographic marks |
-| Pill badges (fully rounded) | Square flags, technical labels, 1px bracket borders `[ label ]` |
-| White card + gray border + drop shadow | Negative margins, spacing-defined sections, invisible boundaries |
+| Purple-to-blue linear gradients | Muted editorial tones, solid OLED blacks, or single-accent monochrome |
+| Glassmorphism / `backdrop-blur` everywhere | Solid opacity layers, or highly specific "Liquid Glass" (1px inner border + inset shadow) |
+| Standard `box-shadow: rgba(0,0,0,0.1)` | Tinted ambient shadows matching the background hue, or no shadow (use 1px borders) |
+| Centered bento grids for everything | Asymmetric layouts or massive intentional whitespace (fallback to mobile column) |
+| "Everything is a Card" | Rely on spacing and alignment to group data instead of boxed cards |
---
-## 2. THE CREATIVE ENGINE (ADVANCED TECHNIQUES)
+## 3. DESIGN ENGINEERING DIRECTIVES
-### Kinetic Typography — Make Text Liquid
+### Typography Intent
+- **Contextual Selection:** Modern B2B tools excel with clean Sans-Serifs (`Inter`, `Geist`). Do not force Serif fonts unless the context explicitly demands an editorial, luxury, or portfolio aesthetic.
+- **Display Typography:** Add tracking adjustments to large text (e.g., `tracking-tighter leading-none` on massive headers).
-- **Velocity Skew**: Text reacts to scroll speed using `transform: skewX()` tied to scroll delta.
-- **Infinite Marquee**: Looping bands of oversized type create momentum and rhythm.
- ```css
- /* Marquee base pattern */
- @keyframes marquee { from { transform: translateX(0) } to { transform: translateX(-50%) } }
- .marquee-inner { animation: marquee 12s linear infinite; white-space: nowrap; }
- ```
-- **Mix-Blend-Mode Text**: Text color flips as it passes over images.
- ```css
- .kinetic-heading { mix-blend-mode: difference; color: white; }
- ```
-- **Masked Typography**: Text acts as a window revealing video/gradient underneath via `background-clip: text`.
+### Data & Form Patterns
+- **Forms:** Label MUST sit above input. Helper text is optional but should exist in markup. Error text MUST sit below the input. Group elements with a standard `gap-2`.
-### Immersive Scrolling — Control Time
+### Responsive Stability
+- **Mobile Override:** Any asymmetric or complex grid layout on desktop (`md:`) MUST collapse gracefully to a clean, single-column layout (`w-full`, `px-4`, `py-8`) on viewports `< 768px`. Do not allow horizontal overflow.
-- **Parallax Stacking**: Sections don't scroll past — they **stack like cards** using `position: sticky; top: 0`.
-- **Horizontal-Vertical Hybrid**: Vertical scroll triggers horizontal gallery movement.
- - Use `IntersectionObserver` to switch scroll axis on a pinned container.
-- **Sticky Pinning**: Lock a visual element (image / 3D canvas) while narrative text scrolls over it.
- ```css
- .pinned-visual { position: sticky; top: 10vh; height: 80vh; }
- .scroll-narrative { position: relative; z-index: 10; }
- ```
+---
-### Micro-Interactions — The Tactile Feel
-
-- **Magnetic Elements**: Buttons physically pull toward the cursor.
- ```js
- el.addEventListener('mousemove', e => {
- const { left, top, width, height } = el.getBoundingClientRect();
- const x = (e.clientX - left - width / 2) * 0.3;
- const y = (e.clientY - top - height / 2) * 0.3;
- el.style.transform = `translate(${x}px, ${y}px)`;
- });
- el.addEventListener('mouseleave', () => el.style.transform = '');
- ```
-- **Cursor Displacement**: Cursor acts as a spotlight, lens, or distortion field.
- ```css
- .cursor-glow {
- position: fixed; pointer-events: none;
- width: 300px; height: 300px;
- background: radial-gradient(circle, rgba(255,255,255,0.05) 0%, transparent 70%);
- transform: translate(-50%, -50%);
- mix-blend-mode: screen;
- }
- ```
-- **Dithering & Grain**: Replace smooth gradients with CSS noise for "Lo-Fi High-Tech" texture.
+## 4. ADVANCED TECHNIQUES (When explicitly requested)
+
+These are reserved for high-end creative requests. Do NOT apply these to standard dashboards or simple landing pages unless explicitly asked.
+
+### Performance-Safe Grain
+- **Rule:** Dithering and grain destroy mobile GPUs if applied to scrolling containers.
+- **Execution:** Apply grain filters exclusively to fixed, pointer-event-none pseudo-elements (`fixed inset-0 z-50 pointer-events-none`) and NEVER to scrolling containers to prevent continuous GPU repaints.
```css
- /* SVG noise filter approach */
- .grain-overlay::after {
- content: '';
- position: absolute; inset: 0;
+ /* RAW CSS allowed here for readability */
+ .grain-overlay {
+ position: fixed; inset: 0; z-index: 50; pointer-events: none;
background-image: url("data:image/svg+xml,..."); /* base64 noise SVG */
opacity: 0.04;
- pointer-events: none;
}
```
----
-
-## 3. CONTEXTUAL MODES — THE VIBE CHECK
-
-**Select EXACTLY ONE mode per project. Do not mix randomly.**
-
-### MODE A — THE "EDITORIAL"
-*For: Content sites, portfolios, blogs, magazines*
-
-> The web page is a printed fashion magazine that has come alive.
-
-- **Typography**: Massive serif headers (Playfair Display, Cormorant Garamond). Text overlaps images.
-- **Layout**: Asymmetric. Text floats over imagery. Whitespace is aggressive.
-- **Palette**: Off-white `#F5F0E8` + Deep ink black `#0D0B08` + One clash color (Acid Green `#BFFF00` or International Orange `#FF4500`)
-- **Key Tech**: Smooth parallax, text reveal animations (clip-path), mix-blend-mode overlaps
-- **Font Stack**: `'Cormorant Garamond', 'Playfair Display', Georgia, serif`
-
-### MODE B — THE "PRECISION INSTRUMENT"
-*For: Dashboards, tools, data products, developer utilities*
-
-> The interface is a physical tool — a Braun calculator or a Teenage Engineering synthesizer.
-
-- **Typography**: Monospace mandatory for data. Small uppercase labels. Stark scale contrast.
-- **Layout**: 1px rule lines dividing sections. Crosshairs. Coordinate numbers as decorative elements.
-- **Palette**: Muted greys, dust, clay, sage. High-contrast strokes. Film look — no pure black.
- - Background: `#F4F1EC` | Stroke: `#2A2A2A` | Accent: `#D4603A` (rust)
-- **Key Tech**: Snap transitions, slot-machine number animations, dense info without clutter
-- **Font Stack**: `'JetBrains Mono', 'IBM Plex Mono', monospace`
-
-### MODE C — THE "INSTALLATION"
-*For: Landing pages, experiences, portfolios, brand statements*
-
-> The browser is a canvas for art. Physics governs the layout.
+### Staggered Reveal
+- Use CSS cascades or Framer Motion `staggerChildren` to reveal elements sequentially. Avoid mounting 20 list items instantly.
+ ```css
+ .reveal-item { animation-delay: calc(var(--index) * 100ms); }
+ ```
-- **Typography**: Fluid sizing (`clamp()`). Brutalist grotesque or mono. Abstract over literal.
-- **Layout**: Full-viewport. Organic blobs, brutalist raw HTML, or fluid simulations.
-- **Palette**: Monochrome or dark mode with subtle noise. One controlled color surprise.
- - Background: `#080808` | Foreground: `#F0F0F0` | Noise opacity: 3-5%
-- **Key Tech**: WebGL-style distortion (CSS filters + SVG), cursor trails, fluid typography
-- **Font Stack**: `'Space Grotesk', 'DM Mono', sans-serif`
+### Magnetic Micro-physics
+- For high-end portfolios only. Buttons physically pull toward the cursor.
+- **Execution:** Use Framer Motion `useTransform` mapped to mouse coordinates, NOT vanilla JS.
---
-## 4. VISUAL SYSTEM — SOPHISTICATED CHAOS
-
-### Typography Scale
-```css
-/* The Extremes — use both ends, nothing in between */
-.headline { font-size: clamp(4rem, 12vw, 10rem); line-height: 0.9; letter-spacing: -0.03em; }
-.subheadline { font-size: clamp(1.5rem, 3vw, 2.5rem); }
-.label { font-size: 0.65rem; text-transform: uppercase; letter-spacing: 0.15em; }
-.body { font-size: 1rem; line-height: 1.7; max-width: 60ch; }
+## 5. EXECUTION SCENARIOS (Concrete Snippets)
+
+### Scenario A: Complex Header (Tailwind + Raw CSS approach)
+- **Concept:** A massive headline scaling fluidly without huge Tailwind bracket strings.
+```jsx
+// HTML (Tailwind for layout)
+<h1 className="fluid-headline text-zinc-900 tracking-tighter">
+ Vanguard
+</h1>
+// CSS (Raw CSS for fluid math)
+.fluid-headline { font-size: clamp(3rem, 8vw, 8rem); line-height: 0.9; }
```
-### Layout Principles
-- **Neo-Brutalism**: Raw borders (`border: 1px solid`), visible grid lines (`outline`), unstyled HTML purposefully exposed.
-- **Overlap**: Titles sit on top of photos. Buttons straddle borders. Use `margin-top: -2rem` aggressively.
-- **Whitespace**: 40% of viewport can be empty to frame a single element. Emptiness is a design choice.
-- **Grid**: Avoid 12-column. Use `grid-template-columns: 3fr 1fr` or asymmetric definitions.
-
-### Motion System
-```css
-/* Spring physics — no linear animations */
-* { transition-timing-function: cubic-bezier(0.34, 1.56, 0.64, 1); } /* spring overshoot */
-
-/* Stagger cascade — reveal line by line */
-.reveal-line {
- opacity: 0; transform: translateY(1.2em);
- animation: reveal 0.6s cubic-bezier(0.34, 1.56, 0.64, 1) forwards;
-}
-@keyframes reveal { to { opacity: 1; transform: translateY(0); } }
-```
-
----
-
-## 5. EXECUTION SCENARIOS
-
-### Scenario: Login Form
-- ❌ **AI Flop**: Centered card, blue button, shadow.
-- ✅ **Anti-Slop Solution**: Split screen. Left = shifting noise curtain. Right = Technical UI — inputs defined only by 1px bottom borders. Submit = magnetic text label that follows cursor. Strictly monospace.
-
-### Scenario: Portfolio
-- ❌ **AI Flop**: Hero image + 3 text columns.
-- ✅ **Anti-Slop Solution**: User's name as an infinite vertical marquee loop. Projects as parallax-stacked images that reveal on scroll. Cursor uses `mix-blend-mode: difference`, inverting colors as it moves.
-
-### Scenario: Dashboard
-- ❌ **AI Flop**: Sidebar, white cards, drop shadows.
-- ✅ **Anti-Slop Solution**: Blueprint rule lines (1px grid). No shadows. Grainy off-white bg. Data updates trigger slot-machine number shuffle. Looks like a financial terminal.
-
----
-
-## 6. QUALITY ASSURANCE CHECKLIST
-
-Before outputting any code, verify:
-
-- [ ] **Safe?** — Does the creativity break usability on mobile? If yes, simplify mobile while keeping desktop wild.
-- [ ] **Not Boring?** — Is there a "Standard Card" or a Tailwind-blue button? If yes, kill it.
-- [ ] **Not Slop?** — Does it look like a template? If yes, restart.
-- [ ] **Is it Art?** — Does it feel like a designed object? If yes, ship it.
-
----
-
-## 7. FORBIDDEN COMBINATIONS (QUICK REFERENCE)
-
-```
-purple → blue gradient ❌
-rounded pill badge ❌
-white card + gray border ❌
-centered hero with subtext ❌
-rocket/shield icon ❌
-glassmorphism as default ❌
-linear animation timing ❌
-12-column bento grid ❌
-pure black shadow ❌
-centered everything ❌
+### Scenario B: High-End Form Input
+- **Concept:** Predictable structure, explicit states, no guessing.
+```jsx
+<div className="flex flex-col gap-2 w-full max-w-md">
+ <label className="text-sm font-medium text-zinc-800">Email</label>
+ <input className="px-4 py-2 border border-zinc-200 focus:ring-2 focus:ring-zinc-900 rounded-none transition-all" />
+ <span className="text-xs text-red-500">Error message placeholder</span>
+</div>
```
---
-## 8. RESOURCE REFERENCES
+## 6. PRE-FLIGHT CHECKLIST
-- **Fonts**: [Google Fonts — Cormorant Garamond](https://fonts.google.com/specimen/Cormorant+Garamond), [JetBrains Mono](https://fonts.google.com/specimen/JetBrains+Mono), [Space Grotesk](https://fonts.google.com/specimen/Space+Grotesk)
-- **Inspiration (study, don't clone)**: Refinery29, Are.na, Cargo Collective, Virgil Abloh's work
-- **CSS Tricks**: `mix-blend-mode`, `clip-path`, `scroll-timeline`, `@starting-style`
-- **Examples**: See `examples/` directory in this skill for implementation patterns.
+Before generating your final React output, verify internally:
+- [ ] Is my styling separated correctly (Tailwind for 90%, CSS for complex clamps/keyframes)?
+- [ ] Did I avoid Vanilla JS `el.addEventListener` in favor of React `useEffect` / `useRef`?
+- [ ] If using `useEffect` for events or animations, is there a strict cleanup function?
+- [ ] Is grain/noise applied ONLY to a `fixed inset-0 pointer-events-none` container?
+- [ ] Are structural states (Loading skeletons, Empty, Errors) included?
+- [ ] Does the mobile view collapse safely?