aesthetic
npx machina-cli add skill zircote/agents/aesthetic --openclawAesthetic
Create aesthetically beautiful interfaces by following proven design principles and systematic workflows.
When to Use This Skill
Use when:
- Building or designing user interfaces
- Analyzing designs from inspiration websites (Dribbble, Mobbin, Behance)
- Generating design images and evaluating aesthetic quality
- Implementing visual hierarchy, typography, color theory
- Adding micro-interactions and animations
- Creating design documentation and style guides
- Need guidance on accessibility and design systems
Core Framework: Four-Stage Approach
1. BEAUTIFUL: Understanding Aesthetics
Study existing designs, identify patterns, extract principles. AI lacks aesthetic sense—standards must come from analyzing high-quality examples and aligning with market tastes.
Reference: references/design-principles.md - Visual hierarchy, typography, color theory, white space principles.
2. RIGHT: Ensuring Functionality
Beautiful designs lacking usability are worthless. Study design systems, component architecture, accessibility requirements.
Reference: references/design-principles.md - Design systems, component libraries, WCAG accessibility standards.
3. SATISFYING: Micro-Interactions
Incorporate subtle animations with appropriate timing (150-300ms), easing curves (ease-out for entry, ease-in for exit), sequential delays.
Reference: references/micro-interactions.md - Duration guidelines, easing curves, performance optimization.
4. PEAK: Storytelling Through Design
Elevate with narrative elements—parallax effects, particle systems, thematic consistency. Use restraint: "too much of anything isn't good."
Reference: references/storytelling-design.md - Narrative elements, scroll-based storytelling, interactive techniques.
Workflows
Workflow 1: Capture & Analyze Inspiration
Purpose: Extract design guidelines from inspiration websites.
Steps:
- Browse inspiration sites (Dribbble, Mobbin, Behance, Awwwards)
- Use chrome-devtools skill to capture full-screen screenshots (not full page)
- Use ai-multimodal skill to analyze screenshots and extract:
- Design style (Minimalism, Glassmorphism, Neo-brutalism, etc.)
- Layout structure & grid systems
- Typography system & hierarchy IMPORTANT: Try to predict the font name (Google Fonts) and font size in the given screenshot, don't just use Inter or Poppins.
- Color palette with hex codes
- Visual hierarchy techniques
- Component patterns & styling
- Micro-interactions
- Accessibility considerations
- Overall aesthetic quality rating (1-10)
- Document findings in project design guidelines using templates
Workflow 2: Generate & Iterate Design Images
Purpose: Create aesthetically pleasing design images through iteration.
Steps:
- Define design prompt with: style, colors, typography, audience, animation specs
- Use ai-multimodal skill to generate design images with Gemini API
- Use ai-multimodal skill to analyze output images and evaluate aesthetic quality
- If score < 7/10 or fails professional standards:
- Identify specific weaknesses (color, typography, layout, spacing, hierarchy)
- Refine prompt with improvements
- Regenerate with ai-multimodal or use media-processing skill to modify outputs (resize, crop, filters, composition)
- Repeat until aesthetic standards met (score ≥ 7/10)
- Document final design decisions using templates
Design Documentation
Create Design Guidelines
Use assets/design-guideline-template.md to document:
- Color patterns & psychology
- Typography system & hierarchy
- Layout principles & spacing
- Component styling standards
- Accessibility considerations
- Design highlights & rationale
Save in project ./docs/design-guideline.md.
Create Design Story
Use assets/design-story-template.md to document:
- Narrative elements & themes
- Emotional journey
- User journey & peak moments
- Design decision rationale
Save in project ./docs/design-story.md.
Resources & Integration
Related Skills
- ai-multimodal: Analyze documents, screenshots & videos, generate design images, edit generated images, evaluate aesthetic quality using Gemini API
- chrome-devtools: Capture full-screen screenshots from inspiration websites, navigate between pages, interact with elements, read console logs & network requests
- media-processing: Refine generated images (FFmpeg for video, ImageMagick for images)
- ui-styling: Implement designs with shadcn/ui components + Tailwind CSS utility-first styling
- web-frameworks: Build with Next.js (App Router, Server Components, SSR/SSG)
Reference Documentation
References: references/design-resources.md - Inspiration platforms, design systems, AI tools, MCP integrations, development strategies.
Key Principles
- Aesthetic standards come from humans, not AI—study quality examples
- Iterate based on analysis—never settle for first output
- Balance beauty with functionality and accessibility
- Document decisions for consistency across development
- Use progressive disclosure in design—reveal complexity gradually
- Always evaluate aesthetic quality objectively (score ≥ 7/10)
Overview
Aesthetic guides you to craft interfaces that are visually compelling and usable by applying a four-stage framework: BEAUTIFUL (aesthetics), RIGHT (usability), SATISFYING (micro-interactions), and PEAK (storytelling). It includes workflows to capture and analyze inspiration with chrome-devtools and ai-multimodal, and to generate and iterate design images until aesthetic standards are met. It integrates with Chrome DevTools, ai-multimodal, media-processing, UI styling, and web frameworks.
How This Skill Works
Aesthetic operates in four stages: BEAUTIFUL analyzes high-quality designs to extract visual principles (hierarchy, typography, color theory); RIGHT ensures usability and accessibility through design systems and WCAG guidelines; SATISFYING adds micro-interactions with 150–300ms timing and defined easing; and PEAK elevates storytelling through narrative elements and restrained effects. The workflows guide you to capture inspiration using chrome-devtools, analyze with ai-multimodal, and iteratively generate design images (Gemini API) until the target aesthetic is achieved.
When to Use It
- Building or designing user interfaces
- Analyzing designs from inspiration sites like Dribbble, Mobbin, Behance
- Generating design images and evaluating aesthetic quality
- Implementing visual hierarchy, typography, and color theory
- Creating design documentation and style guides with accessibility and design-system guidance
Quick Start
- Step 1: Define goals and use chrome-devtools to capture inspiration screenshots (non-full-page).
- Step 2: Run ai-multimodal to analyze the captures and extract style, layout, typography, color, and accessibility notes; document guidelines.
- Step 3: Generate and iterate design images with Gemini API via ai-multimodal, refining until aesthetic standards are met.
Best Practices
- Anchor visuals in established design principles (hierarchy, typography, color theory) before adding flair.
- Always validate accessibility and design-system constraints (WCAG compliance) early in the process.
- Use chrome-devtools to capture non-full-page inspiration shots and let ai-multimodal extract patterns.
- Iterate design images with ai-multimodal (Gemini API) until aesthetic targets are met and documented.
- Document guidelines in templates covering BEAUTIFUL, RIGHT, SATISFYING, and PEAK for consistency across projects.
Example Use Cases
- Redesign of a SaaS admin dashboard focusing on clear visual hierarchy and accessible color contrast.
- Inspiration-driven UI refresh citing patterns from Dribbble and Behance to inform layout and typography.
- Marketing landing page with AI-generated hero variants tested for color harmony and readability.
- Mobile onboarding flow enhanced with subtle micro-interactions and optimized timing.
- Comprehensive design-system documentation that encapsulates BEAUTIFUL, RIGHT, SATISFYING, and PEAK.