aesthetic-analysis — Claude Code skill: design analysis
The aesthetic-analysis skill studies a visual reference and helps rebuild its layout, colors, and typography in React Native. Use it for landing page redesigns based on a site or image.
LicenseRef-Proprietary 193 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill aesthetic-analysis -a claude-codeWhat aesthetic-analysis does
The skill asks for a reference and a target file when the request does not include them. It then examines page structure, interactive elements, colors, fonts, spacing, components, and responsive behavior. For a live page, the workflow uses Playwright MCP to open the URL and capture a full-page screenshot.
The agent reads the target file and builds the result with React Native components. It compares an implementation screenshot with the reference, records visible gaps, and makes focused revisions to layout, color, type, sizing, and detail. The instructions also call for the project’s StyleSheet.create() pattern from CLAUDE.md, with Expo and React Native used for the mobile layout.
A live reference needs Playwright MCP, so the capture and interaction stage depends on it. Web fonts may require expo-font or Google Fonts, while effects such as box-shadow need React Native-specific alternatives.
What it helps with
- inspect a landing page from a URL or image
- rebuild a reference layout in a React Native file
- match the reference colors, fonts, and spacing
- compare the implementation with a captured screenshot
- refine mobile UI details after visual review
Example prompts for the agent
- Use Playwright MCP to study this URL and rebuild it in
app/landing.tsx, then compare the result with a screenshot. - Analyze this reference image and adapt
app/(tabs)/index.tsxto its layout, colors, and typography. - Capture the finished page, list the visual differences from the reference, and apply targeted fixes.
How to install aesthetic-analysis
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill aesthetic-analysis -a claude-code2Manually: put the files in place
~/.claude/skills/aesthetic-analysis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/aesthetic-analysis/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill aesthetic-analysis -a codex2Manually: put the files in place
.agents/skills/aesthetic-analysis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill aesthetic-analysis -a cursor2Manually: put the files in place
.cursor/skills/aesthetic-analysis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/aesthetic-analysis2Manually: put the files in place
.github/skills/aesthetic-analysis/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill aesthetic-analysis -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/aesthetic-analysisManually: put the files in place
.devin/skills/aesthetic-analysis/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill aesthetic-analysis -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about aesthetic-analysis
How do I install aesthetic-analysis in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill aesthetic-analysis -a claude-code, then check ~/.claude/skills/aesthetic-analysis/SKILL.md.
What does aesthetic-analysis do?
It studies a website or image as a visual reference, then guides the implementation of its structure and styling in a target React Native file. It also compares the result with a screenshot and directs follow-up changes.
What is needed to inspect a live website?
The live-site workflow needs Playwright MCP to open the page, interact with it, and capture a screenshot. Web fonts in React Native may require expo-font or Google Fonts.