
aesthetic-analysis
Analyze and extract design patterns from visual examples. Deconstructs design systems, color palettes, typography, and layout principles from reference materials.
- Installs
- 190
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/qodex-ai/ai-agent-skills --skill aesthetic-analysis- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads aesthetic-analysis automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Landing Page Redesign
Instructions
When requested to redesign a landing page based on a reference:
1. User Interview
- If not provided in the initial request, ask the user for:
- Reference URL or Image: The landing page or design to replicate (can be a live website URL or an image URL)
- Target Page: Which file in the codebase should receive the design (e.g.,
app/(tabs)/index.tsx,app/landing.tsx)
- If details are provided in the initial request, skip to step 2
2. Capture Reference Design
- Use Playwright MCP to open the reference URL:
- Navigate to the page
- Take a full-page screenshot to understand structure
- Interact with the website, mouse hover, click around
- Analyze the page deeply
- Analyze the landing page/image for:
- Layout structure (header, hero, sections, footer)
- Interactive elements
- Color palette
- Typography (fonts, sizes, weights)
- Spacing and padding patterns
- UI components (buttons, cards, forms, etc.)
- Responsive design patterns
3. Implement the Design
- Read the target page file to understand current structure
- Implement the design following these principles:
- Match the layout: Replicate section structure, grid layouts, flex patterns
- Match the intractions: Replicate mouse and button interactions, whether clicks or hovers - on key elements
- Match colors: Extract and use exact hex values from the reference
- Match typography: Use similar fonts (adjust to available system fonts or suggest font imports)
- Match spacing: Replicate padding, margins, and gaps
- Match components: Build equivalent React Native components for buttons, cards, inputs, etc.
- Follow project patterns: Use StyleSheet.create() as per CLAUDE.md guidelines
- Mobile-first: Ensure the design works on mobile (Expo/React Native)
- Write the implementation to the target file
4. Compare Implementations
- If the reference is a live website:
- Take a screenshot of the implemented page
- Use Playwright to view your implementation
- Visually compare:
- Layout alignment and proportions
- Color accuracy
- Typography consistency
- Spacing and padding
- Component styling details
- Document differences found
5. Iterate and Refine
- Based on comparison, identify specific gaps:
- Layout issues (alignment, sizing, positioning)
- Color mismatches
- Typography differences
- Missing components or details
- Spacing inconsistencies
- Make targeted refinements to address each gap
- Repeat steps 4-5 until:
- The design matches as closely as technically possible
- All major visual elements are replicated
- User confirms satisfaction
- Aim for 3-5 iterations minimum to achieve high fidelity
6. Final Review
- Present the final implementation to the user
- Summarize what was matched and any intentional differences
- Suggest any follow-up improvements (e.g., animations, hover states, responsive tweaks)
Best Practices
- Be detail-oriented: Small differences in spacing, colors, or typography can break the visual consistency
- Extract exact values: Use color pickers and measurement tools to get precise values from screenshots
- Component reusability: Extract repeated patterns into reusable components
- Maintain project standards: Follow the StyleSheet.create() pattern and existing architecture
- Document trade-offs: If React Native limitations prevent exact replication, document why
Example Flow
User request: "Make our landing page look like https://stripe.com/payments"
- Interview: Ask "Which file should receive this design?" → User: "app/(tabs)/index.tsx"
- Capture:
- Navigate to stripe.com/payments
- Take full-page screenshot
- Analyze deeply: Dark theme, gradient hero, feature grid, clean typography, button changes color upon hover/click
- Implement:
- Read app/(tabs)/index.tsx
- Build based on reference
- Compare:
- Screenshot shows hero gradient is lighter than reference
- Button border-radius is too sharp
- Font weights don't match
- Button doesn't change upon hover
- Iterate:
- Adjust gradient colors to match
- Reduce border-radius on buttons
- Increase font weights
- button changes upon hover/click
- Re-compare
- Iterate again:
- Fine-tune spacing between sections
- Adjust icon sizes
- Match exact color values
- Final review: Present to user with summary of matched elements
Technical Notes
-
React Native considerations:
- Web fonts may need to be loaded via expo-font or google fonts
- Some web-specific effects (box-shadow) have React Native equivalents (shadowColor, shadowOffset)
- Use Dimensions API for responsive layouts
-
Iteration targets:
- First iteration: Overall layout and structure
- Second iteration: Colors and typography
- Third iteration: Spacing and sizing refinement
- Fourth+ iterations: Fine details and polish
References
FAQ
What does the aesthetic-analysis skill do?
Analyze and extract design patterns from visual examples. Deconstructs design systems, color palettes, typography, and layout principles from reference materials.
How do I install aesthetic-analysis?
Run npx skills add https://github.com/qodex-ai/ai-agent-skills --skill aesthetic-analysis in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/aesthetic-analysis/ (personal) or .claude/skills/aesthetic-analysis/ (project).
Which AI agents can use aesthetic-analysis?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is aesthetic-analysis safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains aesthetic-analysis?
It is published by qodex-ai in qodex-ai/ai-agent-skills. It has 190 recorded installs.
More from qodex-ai/ai-agent-skills
word-document-processor
qodex-ai/ai-agent-skills
Comprehensive word document processing with full format support. Handles creation, editing, formatting preservation, tracked changes, and metadata management.
multi-agent-orchestration
qodex-ai/ai-agent-skills
Design and coordinate multi-agent systems where specialized agents work together to solve complex problems. Covers agent communication, task delegation, workflow orchestration, and result aggregation. Use when building coordinated agent teams, complex workflows, or systems requiring specialized expertise across domains.
financial-analysis-agent
qodex-ai/ai-agent-skills
Create agents for financial analysis, investment research, and portfolio management. Covers financial data processing, risk analysis, and recommendation generation. Use when building investment analysis tools, robo-advisors, portfolio trackers, or financial intelligence systems.
legal-document-analyzer
qodex-ai/ai-agent-skills
Build agents for legal document analysis, contract review, and compliance checking. Handles document parsing, risk identification, and legal research. Use when creating contract analysis tools, legal research assistants, compliance checkers, or document review systems.
ecommerce-platform-specialist
qodex-ai/ai-agent-skills
Provide expert guidance on Shopify e-commerce platform. Advises on store setup, products, customization, and optimization.
spreadsheet-processor
qodex-ai/ai-agent-skills
Process and manipulate spreadsheet documents. Creates, edits, analyzes, and transforms Excel files with formula and formatting support.
Popular frontend & design skills
setup-matt-pocock-skills
mattpocock/skills
Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
frontend-design
anthropics/skills
Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.
hyperframes-animation
heygen-com/hyperframes
All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.
prototype
mattpocock/skills
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
hyperframes-core
heygen-com/hyperframes
The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.
vercel-react-best-practices
vercel-labs/agent-skills
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.