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
Add stitch-skill: taste-skill converted to Google Stitch DESIGN.md format
Leonxlnxc3c3e767aa0f
diff --git a/README.md b/README.mdindex 46cf8e7..d5f4f13 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 six skills in this project. Each one lives in its own folder and contains a `SKILL.md` file.+There are seven 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.@@ -32,6 +32,9 @@ For clean, editorial-style interfaces inspired by tools like Notion and Linear.### 6. brutalist-skillRaw mechanical interfaces fusing Swiss typographic print with CRT terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, and analog degradation effects like halftones, scanlines, and dithering. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints.+### 7. stitch-skill+Google Stitch-compatible semantic design system. Converts the taste-skill's anti-slop engineering directives into Stitch's native `DESIGN.md` format — descriptive natural-language rules paired with precise hex values that Stitch's AI agent interprets to generate premium, non-generic interfaces. Includes the SKILL.md agent instructions and a ready-to-import DESIGN.md file.+## How to Use1. Copy the `SKILL.md` file from the skill folder you need into your project.diff --git a/stitch-skill/DESIGN.md b/stitch-skill/DESIGN.mdnew file mode 100644index 0000000..310b5aa--- /dev/null+++ b/stitch-skill/DESIGN.md@@ -0,0 +1,78 @@+# Design System: Taste Standard+**Skill:** stitch-design-taste++## 1. Visual Theme & Atmosphere+A restrained, gallery-airy interface with confident asymmetric layouts and fluid spring-physics motion. The atmosphere is clinical yet warm — like a well-lit architecture studio where every element earns its place through function. Density is balanced (Level 4), variance runs high (Level 8) to prevent symmetrical boredom, and motion is fluid but never theatrical (Level 6). The overall impression: expensive, intentional, alive.++## 2. Color Palette & Roles+- **Canvas White** (#F9FAFB) — Primary background surface. Warm-neutral, never clinical blue-white+- **Pure Surface** (#FFFFFF) — Card and container fill. Used with whisper shadow for elevation+- **Charcoal Ink** (#18181B) — Primary text. Zinc-950 depth — never pure black+- **Steel Secondary** (#71717A) — Body text, descriptions, metadata. Zinc-500 warmth+- **Muted Slate** (#94A3B8) — Tertiary text, timestamps, disabled states+- **Whisper Border** (rgba(226,232,240,0.5)) — Card borders, structural 1px lines. Semi-transparent for depth+- **Diffused Shadow** (rgba(0,0,0,0.05)) — Card elevation. Wide-spreading, 40px blur, -15px offset. Never harsh++### Accent Selection (Pick ONE per project)+- **Emerald Signal** (#10B981) — For growth, success, positive data dashboards+- **Electric Blue** (#3B82F6) — For productivity, SaaS, developer tools+- **Deep Rose** (#E11D48) — For creative, editorial, fashion-adjacent projects+- **Amber Warmth** (#F59E0B) — For community, social, warm-toned products++### Banned Colors+- Purple/Violet neon gradients — the "AI Purple" aesthetic+- Pure Black (#000000) — always Off-Black or Zinc-950+- Oversaturated accents above 80% saturation+- Mixed warm/cool gray systems within one project++## 3. Typography Rules+- **Display:** `Geist`, `Satoshi`, `Cabinet Grotesk`, or `Outfit` — Track-tight (`-0.025em`), controlled fluid scale, weight-driven hierarchy (700–900). Not screaming. Leading compressed (`1.1`). Alternatives forced — `Inter` is BANNED for premium contexts+- **Body:** Same family at weight 400 — Relaxed leading (`1.65`), 65ch max-width, Steel Secondary color (#71717A)+- **Mono:** `Geist Mono` or `JetBrains Mono` — For code blocks, metadata, timestamps. When density exceeds Level 7, all numbers switch to monospace+- **Serif:** `Playfair Display` or similar — ONLY for creative/editorial. NEVER in dashboards or software UIs+- **Scale:** Display at `clamp(2.25rem, 5vw, 3.75rem)`. Body at `1rem/1.125rem`. Mono metadata at `0.8125rem`++## 4. Component Stylings+* **Buttons:** Flat surface, no outer glow. Primary: accent fill with white text. Secondary: ghost/outline. Active state: `-1px translateY` or `scale(0.98)` for tactile push. Hover: subtle background shift, never glow+* **Cards/Containers:** Generously rounded corners (`2.5rem`). Pure white fill. Whisper border (`1px`, semi-transparent). Diffused shadow (`0 20px 40px -15px rgba(0,0,0,0.05)`). Internal padding `2rem–2.5rem`. Used ONLY when elevation communicates hierarchy — high-density layouts replace cards with `border-top` dividers or negative space+* **Inputs/Forms:** Label positioned above input. Helper text optional. Error text below in Deep Rose. Focus ring in accent color, `2px` offset. No floating labels. Standard `0.5rem` gap between label-input-error stack+* **Navigation:** Sleek, sticky. Icons scale on hover (Dock Magnification optional). No hamburger on desktop. Clean horizontal with generous spacing+* **Loaders:** Skeletal shimmer matching exact layout dimensions and rounded corners. Shifting light reflection across placeholder shapes. Never circular spinners+* **Empty States:** Composed illustration or icon composition with guidance text. Never just "No data found"+* **Error States:** Inline, contextual. Red accent underline or border. Clear recovery action++## 5. Layout Principles+- **Grid-First:** CSS Grid for all structural layouts. Never flexbox percentage math (`calc(33% - 1rem)` is BANNED)+- **Asymmetric Hero:** Centered Hero sections BANNED for this variance level. Force Split Screen (50/50), Left-Aligned content / Right visual, or Asymmetric Whitespace+- **Feature Sections:** The "3 equal cards in a row" pattern is BANNED. Use 2-column Zig-Zag, asymmetric Bento grids (2fr 1fr 1fr), or horizontal scroll galleries+- **Containment:** All content within `max-width: 1400px`, centered. Generous horizontal padding (`1rem` mobile, `2rem` tablet, `4rem` desktop)+- **Full-Height:** Use `min-height: 100dvh` — never `height: 100vh` (iOS Safari address bar jump)+- **Responsive:** Aggressive single-column collapse below 768px. All asymmetric layouts revert to `width: 100%`, `padding: 1rem 1rem`, `2rem` vertical gaps. No horizontal scroll on mobile+- **Bento Architecture:** For feature grids, use Row 1: 3 columns | Row 2: 2 columns (70/30 split). Each tile contains a perpetual micro-animation++## 6. Motion & Interaction+- **Physics Engine:** Spring-based exclusively. `stiffness: 100, damping: 20`. No linear easing anywhere. Premium, weighty feel on all interactive elements+- **Perpetual Micro-Loops:** Every active dashboard component has an infinite-loop state — Pulse on status dots, Typewriter on search bars, Float on feature icons, Shimmer on loading states+- **Staggered Orchestration:** Lists and grids mount with cascaded delays (`animation-delay: calc(var(--index) * 100ms)`). Waterfall reveals, never instant mount+- **Layout Transitions:** Smooth re-ordering via shared element IDs. Items swap positions with physics, simulating real-time intelligence+- **Hardware Rules:** Animate ONLY `transform` and `opacity`. Never `top`, `left`, `width`, `height`. Grain/noise filters on fixed, pointer-events-none pseudo-elements only+- **Performance:** CPU-heavy perpetual animations isolated in microscopic leaf components. Never trigger parent re-renders. Target 60fps minimum++## 7. Anti-Patterns (Banned)+- No emojis — anywhere in UI, code, or alt text+- No `Inter` font — use `Geist`, `Outfit`, `Cabinet Grotesk`, `Satoshi`+- No pure black (`#000000`) — Off-Black or Zinc-950 only+- No neon outer glows or default box-shadow glows+- No oversaturated accent colors above 80%+- No excessive gradient text on large headers+- No custom mouse cursors+- No 3-column equal card layouts for features+- No centered Hero sections (at this variance level)+- No generic names: "John Doe", "Sarah Chan", "Acme", "Nexus", "SmartFlow"+- No fake round numbers: `99.99%`, `50%`, `1234567` — use organic data: `47.2%`, `+1 (312) 847-1928`+- No AI copywriting clichés: "Elevate", "Seamless", "Unleash", "Next-Gen", "Revolutionize"+- No broken Unsplash links — use `picsum.photos/seed/{id}/800/600` or SVG UI Avatars+- No generic `shadcn/ui` defaults — customize radii, colors, shadows to match this system+- No `z-index` spam — use only for Navbar, Modal, Overlay layer contexts+- No `h-screen` — always `min-h-[100dvh]`+- No circular loading spinners — skeletal shimmer onlydiff --git a/stitch-skill/SKILL.md b/stitch-skill/SKILL.mdnew file mode 100644index 0000000..f88b3f9--- /dev/null+++ b/stitch-skill/SKILL.md@@ -0,0 +1,161 @@+---+name: stitch-design-taste+description: Semantic Design System Skill for Google Stitch. Generates agent-friendly DESIGN.md files that enforce premium, anti-generic UI standards — strict typography, calibrated color, asymmetric layouts, perpetual micro-motion, and hardware-accelerated performance.+---++# Stitch Design Taste — Semantic Design System Skill++## Overview+This skill generates `DESIGN.md` files optimized for Google Stitch screen generation. It translates the battle-tested anti-slop frontend engineering directives into Stitch's native semantic design language — descriptive, natural-language rules paired with precise values that Stitch's AI agent can interpret to produce premium, non-generic interfaces.++The generated `DESIGN.md` serves as the **single source of truth** for prompting Stitch to generate new screens that align with a curated, high-agency design language. Stitch interprets design through **"Visual Descriptions"** supported by specific color values, typography specs, and component behaviors.++## Prerequisites+- Access to Google Stitch via [labs.google.com/stitch](https://labs.google.com/stitch)+- Optionally: Stitch MCP Server for programmatic integration with Cursor, Antigravity, or Gemini CLI++## The Goal+Generate a `DESIGN.md` file that encodes:+1. **Visual atmosphere** — the mood, density, and design philosophy+2. **Color calibration** — neutrals, accents, and banned patterns with hex codes+3. **Typographic architecture** — font stacks, scale hierarchy, and anti-patterns+4. **Component behaviors** — buttons, cards, inputs with interaction states+5. **Layout principles** — grid systems, spacing philosophy, responsive strategy+6. **Motion philosophy** — animation engine specs, spring physics, perpetual micro-interactions+7. **Anti-patterns** — explicit list of banned AI design clichés++## Analysis & Synthesis Instructions++### 1. Define the Atmosphere+Evaluate the target project's intent. Use evocative adjectives from the taste spectrum:+- **Density:** "Art Gallery Airy" (1–3) → "Daily App Balanced" (4–7) → "Cockpit Dense" (8–10)+- **Variance:** "Predictable Symmetric" (1–3) → "Offset Asymmetric" (4–7) → "Artsy Chaotic" (8–10)+- **Motion:** "Static Restrained" (1–3) → "Fluid CSS" (4–7) → "Cinematic Choreography" (8–10)++Default baseline: Variance 8, Motion 6, Density 4. Adapt dynamically based on user's vibe description.++### 2. Map the Color Palette+For each color provide: **Descriptive Name** + **Hex Code** + **Functional Role**.++**Mandatory constraints:**+- Maximum 1 accent color. Saturation below 80%+- The "AI Purple/Blue Neon" aesthetic is strictly BANNED — no purple button glows, no neon gradients+- Use absolute neutral bases (Zinc/Slate) with high-contrast singular accents+- Stick to one palette for the entire output — no warm/cool gray fluctuation+- Never use pure black (`#000000`) — use Off-Black, Zinc-950, or Charcoal++### 3. Establish Typography Rules+- **Display/Headlines:** Track-tight, controlled scale. Not screaming. Hierarchy through weight and color, not just massive size+- **Body:** Relaxed leading, max 65 characters per line+- **Font Selection:** `Inter` is BANNED for premium/creative contexts. Force unique character: `Geist`, `Outfit`, `Cabinet Grotesk`, or `Satoshi`+- **Dashboard Constraint:** Serif fonts are strictly BANNED for Dashboard/Software UIs. Use Sans-Serif pairings exclusively (`Geist` + `Geist Mono` or `Satoshi` + `JetBrains Mono`)+- **High-Density Override:** When density exceeds 7, all numbers must use Monospace++### 4. Describe Component Stylings+For each component type, describe shape, color, shadow depth, and interaction behavior:+- **Buttons:** Tactile push feedback on active state. No neon outer glows. No custom mouse cursors+- **Cards:** Use ONLY when elevation communicates hierarchy. Tint shadows to background hue. For high-density layouts, replace cards with border-top dividers or negative space+- **Inputs/Forms:** Label above input, helper text optional, error text below. Standard gap spacing+- **Loading States:** Skeletal loaders matching layout dimensions — no generic circular spinners+- **Empty States:** Composed compositions indicating how to populate data+- **Error States:** Clear, inline error reporting++### 5. Define Layout Principles+- Centered Hero sections are BANNED when variance exceeds 4 — force Split Screen, Left-Aligned, or Asymmetric Whitespace+- The generic "3 equal cards horizontally" feature row is BANNED — use 2-column Zig-Zag, asymmetric grid, or horizontal scroll+- CSS Grid over Flexbox math — never use `calc()` percentage hacks+- Contain layouts using max-width constraints (e.g., 1400px centered)+- Full-height sections must use `min-h-[100dvh]` — never `h-screen` (iOS Safari catastrophic jump)++### 6. Encode Motion Philosophy+- **Spring Physics default:** `stiffness: 100, damping: 20` — premium, weighty feel. No linear easing+- **Perpetual Micro-Interactions:** Every active component should have an infinite loop state (Pulse, Typewriter, Float, Shimmer)+- **Staggered Orchestration:** Never mount lists instantly — use cascade delays for waterfall reveals+- **Performance:** Animate exclusively via `transform` and `opacity`. Never animate `top`, `left`, `width`, `height`. Grain/noise filters on fixed pseudo-elements only++### 7. List Anti-Patterns (AI Tells)+Encode these as explicit "NEVER DO" rules in the DESIGN.md:+- No emojis anywhere+- No `Inter` font+- No pure black (`#000000`)+- No neon/outer glow shadows+- No oversaturated accents+- No excessive gradient text on large headers+- No custom mouse cursors+- No 3-column equal card layouts+- No generic names ("John Doe", "Acme", "Nexus")+- No fake round numbers (`99.99%`, `50%`)+- No AI copywriting clichés ("Elevate", "Seamless", "Unleash", "Next-Gen")+- No broken Unsplash links — use `picsum.photos` or SVG avatars+- No centered Hero sections (for high-variance projects)++## Output Format (DESIGN.md Structure)++```markdown+# Design System: [Project Title]++## 1. Visual Theme & Atmosphere+(Evocative description of the mood, density, variance, and motion intensity.+Example: "A restrained, gallery-airy interface with confident asymmetric layouts+and fluid spring-physics motion. The atmosphere is clinical yet warm — like a+well-lit architecture studio.")++## 2. Color Palette & Roles+- **Canvas White** (#F9FAFB) — Primary background surface+- **Pure Surface** (#FFFFFF) — Card and container fill+- **Charcoal Ink** (#18181B) — Primary text, Zinc-950 depth+- **Muted Steel** (#71717A) — Secondary text, descriptions, metadata+- **Whisper Border** (rgba(226,232,240,0.5)) — Card borders, 1px structural lines+- **[Accent Name]** (#XXXXXX) — Single accent for CTAs, active states, focus rings+(Max 1 accent. Saturation < 80%. No purple/neon.)++## 3. Typography Rules+- **Display:** [Font Name] — Track-tight, controlled scale, weight-driven hierarchy+- **Body:** [Font Name] — Relaxed leading, 65ch max-width, neutral secondary color+- **Mono:** [Font Name] — For code, metadata, timestamps, high-density numbers+- **Banned:** Inter, generic system fonts for premium contexts. Serif fonts banned in dashboards.++## 4. Component Stylings+* **Buttons:** Flat, no outer glow. Tactile -1px translate on active. Accent fill for primary, ghost/outline for secondary.+* **Cards:** Generously rounded corners (2.5rem). Diffused whisper shadow. Used only when elevation serves hierarchy. High-density: replace with border-top dividers.+* **Inputs:** Label above, error below. Focus ring in accent color. No floating labels.+* **Loaders:** Skeletal shimmer matching exact layout dimensions. No circular spinners.+* **Empty States:** Composed, illustrated compositions — not just "No data" text.++## 5. Layout Principles+(Grid-first responsive architecture. Asymmetric splits for Hero sections.+Strict single-column collapse below 768px. Max-width containment.+No flexbox percentage math. Generous internal padding.)++## 6. Motion & Interaction+(Spring physics for all interactive elements. Staggered cascade reveals.+Perpetual micro-loops on active dashboard components. Hardware-accelerated+transforms only. Isolated Client Components for CPU-heavy animations.)++## 7. Anti-Patterns (Banned)+(Explicit list of forbidden patterns: no emojis, no Inter, no pure black,+no neon glows, no 3-column equal grids, no AI copywriting clichés,+no generic placeholder names, no broken image links.)+```++## Best Practices+- **Be Descriptive:** "Deep Charcoal Ink (#18181B)" — not just "dark text"+- **Be Functional:** Explain what each element is used for+- **Be Consistent:** Same terminology throughout the document+- **Be Precise:** Include exact hex codes, rem values, pixel values in parentheses+- **Be Opinionated:** This is not a neutral template — it enforces a specific, premium aesthetic++## Tips for Success+1. Start with the atmosphere — understand the vibe before detailing tokens+2. Look for patterns — identify consistent spacing, sizing, and styling+3. Think semantically — name colors by purpose, not just appearance+4. Consider hierarchy — document how visual weight communicates importance+5. Encode the bans — anti-patterns are as important as the rules themselves++## Common Pitfalls to Avoid+- Using technical jargon without translation ("rounded-xl" instead of "generously rounded corners")+- Omitting hex codes or using only descriptive names+- Forgetting functional roles of design elements+- Being too vague in atmosphere descriptions+- Ignoring the anti-pattern list — these are what make the output premium+- Defaulting to generic "safe" designs instead of enforcing the curated aesthetic