incomestreamsurfer/astro-builder-skill/references
Claude Code and agent skill by incomestreamsurfer/astro-builder-skill
- community
Checking that the SKILL.md file is still in the repository.
Install
npx vskill@latest install incomestreamsurfer/astro-builder-skill/referencesSKILL.md
The same SKILL.md was published earlier as incomestreamsurfer/astro-builder-skill/references.
Taste Skill — Premium Frontend Design Reference
Source: https://github.com/Leonxlnx/taste-skill
This is the taste-skill by Leonxlnx, integrated as a design reference for building premium, non-generic frontends. When building pages, follow these rules alongside the SEO and Astro-specific guidelines.
1. ACTIVE BASELINE CONFIGURATION
Adapt these values dynamically based on what the user explicitly requests. Use these as global variables driving design decisions in all sections below.
2. DEFAULT ARCHITECTURE & CONVENTIONS
DEPENDENCY VERIFICATION [MANDATORY]: Before importing ANY 3rd party library, check package.json. If missing, output the install command first.
Styling Policy: Use Tailwind CSS (v3/v4) for 90% of styling.
- TAILWIND VERSION LOCK: Check
package.jsonfirst. Do not use v4 syntax in v3 projects. - ANTI-EMOJI POLICY: NEVER use emojis in code, markup, text content, or alt text. Use high-quality icons (Phosphor, Radix) or clean SVG primitives.
Responsiveness & Spacing:
- Standardize breakpoints (sm, md, lg, xl)
- Contain page layouts using
max-w-[1400px] mx-autoormax-w-7xl - Viewport Stability: NEVER use
h-screenfor full-height sections. ALWAYS usemin-h-[100dvh] - Grid over Flex-Math: NEVER use complex flexbox percentage math. ALWAYS use CSS Grid (
grid grid-cols-1 md:grid-cols-3 gap-6)
Icons: Use @phosphor-icons/react or @radix-ui/react-icons. Standardize strokeWidth globally.
3. DESIGN ENGINEERING DIRECTIVES (Bias Correction)
Rule 1: Deterministic Typography
- Display/Headlines:
text-4xl md:text-6xl tracking-tighter leading-none - ANTI-SLOP: Discourage Inter for premium vibes. Use Geist, Outfit, Cabinet Grotesk, or Satoshi
- Serif fonts are BANNED for Dashboard/Software UIs
- Body:
text-base text-gray-600 leading-relaxed max-w-[65ch]
Rule 2: Color Calibration
- Max 1 Accent Color. Saturation < 80%
- THE LILA BAN: "AI Purple/Blue" aesthetic is BANNED. No purple button glows, no neon gradients
- Use neutral bases (Zinc/Slate) with high-contrast singular accents (Emerald, Electric Blue, Deep Rose)
- Stick to ONE palette for the entire output
Rule 3: Layout Diversification
- ANTI-CENTER BIAS: Centered Hero sections are BANNED when LAYOUT_VARIANCE > 4
- Use "Split Screen" (50/50), "Left Aligned content/Right Aligned asset", or "Asymmetric White-space"
Rule 4: Materiality, Shadows, and Anti-Card Overuse
- For VISUAL_DENSITY > 7, generic card containers are BANNED. Use
border-t,divide-y, or negative space - Use cards ONLY when elevation communicates hierarchy
- When a shadow is used, tint it to the background hue
Rule 5: Interactive UI States
Must implement full interaction cycles:
- Loading: Skeletal loaders matching layout sizes (not generic spinners)
- Empty States: Beautifully composed empty states
- Error States: Clear inline error reporting
- Tactile Feedback: On
:active, use-translate-y-[1px]orscale-[0.98]
Rule 6: Data & Form Patterns
- Label MUST sit above input. Helper text optional. Error text below input. Use
gap-2for input blocks.
4. CREATIVE PROACTIVITY
- Liquid Glass Refraction: Go beyond
backdrop-blur. Addborder-white/10andshadow-[inset_0_1px_0_rgba(255,255,255,0.1)] - Magnetic Micro-physics (MOTION > 5): Buttons pull toward cursor. Use
useMotionValue/useTransform, NOT useState - Perpetual Micro-Interactions (MOTION > 5): Embed continuous animations (Pulse, Typewriter, Float, Shimmer)
- Spring Physics:
type: "spring", stiffness: 100, damping: 20for all interactive elements - Staggered Orchestration: Use
staggerChildrenoranimation-delay: calc(var(--index) * 100ms)
5. PERFORMANCE GUARDRAILS
- Apply grain/noise filters to
fixed inset-0 z-50 pointer-events-nonepseudo-elements only - Never animate
top,left,width, orheight. Animate viatransformandopacityonly - Z-Index: Use strictly for systemic layers (Navbars, Modals, Overlays)
6. TECHNICAL REFERENCE (Dial Definitions)
DESIGN_VARIANCE:
- 1-3: Symmetrical grids, equal paddings
- 4-7: Overlapping margins, varied aspect ratios, left-aligned headers
- 8-10: Masonry layouts, CSS Grid fractional units, massive empty zones
- MOBILE OVERRIDE: Levels 4-10 MUST fall back to single-column on < 768px
MOTION_INTENSITY:
- 1-3: No auto animations. CSS
:hover/:activeonly - 4-7:
transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1), animation-delay cascades - 8-10: Complex scroll-triggered reveals, Framer Motion hooks. NEVER use
addEventListener('scroll')
VISUAL_DENSITY:
- 1-3: Lots of white space, huge section gaps — expensive and clean
- 4-7: Normal spacing for standard web apps
- 8-10: Tiny paddings, 1px separators, packed data. Use
font-monofor all numbers
7. AI TELLS (Forbidden Patterns)
Visual & CSS:
- NO Neon/Outer Glows — use inner borders or tinted shadows
- NO Pure Black (#000000) — use Off-Black, Zinc-950, Charcoal
- NO Oversaturated Accents
- NO Excessive Gradient Text on large headers
- NO Custom Mouse Cursors
Typography:
- NO Inter Font — use Geist, Outfit, Cabinet Grotesk, Satoshi
- NO Oversized H1s — control hierarchy with weight and color
- Serif ONLY for creative/editorial, NEVER on Dashboards
Layout & Spacing:
- Align perfectly. Avoid floating elements with awkward gaps
- NO 3-Column Card Layouts — use 2-column Zig-Zag, asymmetric grid, or horizontal scroll
Content & Data:
- NO Generic Names ("John Doe") — use creative realistic names
- NO Generic Avatars — use photo placeholders or specific styling
- NO Fake Numbers (99.99%, 50%) — use organic data (47.2%, +1 (312) 847-1928)
- NO Startup Slop Names ("Acme", "Nexus") — invent premium contextual names
- NO Filler Words ("Elevate", "Seamless", "Unleash") — use concrete verbs
- NO Broken Unsplash Links — use
https://picsum.photos/seed/{random}/800/600
8. THE CREATIVE ARSENAL
Pull from this library of advanced concepts:
Navigation: Mac OS Dock Magnification, Magnetic Buttons, Gooey Menus, Dynamic Islands, Radial Menus, Mega Menu Reveals
Layout: Bento Grids, Masonry, Chroma Grids, Split Screen Scroll, Curtain Reveals
Cards: Parallax Tilt, Spotlight Border, Glassmorphism Panels, Holographic Foil, Tinder Swipe Stacks, Morphing Modals
Scroll-Animations: Sticky Scroll Stacks, Horizontal Scroll Hijack, Zoom Parallax, Scroll Progress Paths, Liquid Swipe Transitions
Typography: Kinetic Marquees, Text Mask Reveals, Text Scramble Effects, Circular Text Paths, Gradient Stroke Animation
Micro-Interactions: Particle Explosion Buttons, Skeleton Shimmer, Directional Hover Buttons, Ripple Click Effects, Mesh Gradient Backgrounds
9. ASTRO-SPECIFIC ADAPTATION
Since we're in Astro (not pure React/Next.js), adapt the taste-skill rules:
- Static by default: Most page content is
.astrocomponents with zero JS. The taste-skill's typography, color, layout, and spacing rules apply directly via Tailwind classes. - Islands for interactivity: When motion/interaction is needed (magnetic buttons, scroll animations, form states), create isolated React
.tsxcomponents withclient:visibleorclient:load. - No RSC concerns: Astro doesn't use React Server Components. All
.astrofiles are server-rendered. React islands are always client-side. - Font loading: Load premium fonts (Geist, Satoshi, etc.) via
@fontsourcepackages or Google Fonts in the<head>.
10. FINAL PRE-FLIGHT CHECK
- Is mobile layout collapse (
w-full,px-4,max-w-7xl mx-auto) guaranteed? - Do full-height sections use
min-h-[100dvh]noth-screen? - Are empty, loading, and error states provided for interactive components?
- Are cards omitted in favor of spacing where possible?
- Is the design non-generic? No purple gradients, no Inter, no centered 3-card layouts?
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskill/references/taste-skill.md
Popularity
- Repository stars
- 77
- Repository forks
- 36
- 7-day trend score
- 22
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/incomestreamsurfer/astro-builder-skill/references)