| disable-model-invocation | true |
| name | design-audit |
| description | Audits visual design for AI-generated aesthetic patterns and produces improvement plans. Use when reviewing UI design, checking if a website looks "AI-generated", auditing .pen files for generic aesthetics, or improving visual identity. Also use when "AI purple", "looks generic", "soulless design", "design review", "AI์ค๋ฌ์ด", "๋์์ธ ์ ๊ฒ", "๋์์ธ ๊ฐ์ฌ", or "escape AI aesthetic". Do NOT use for code review (use code-review) or accessibility audit. |
| argument-hint | [url | .pen-path | screenshot-path | css-glob] |
Design Audit
๋์์ธ์ "AI์ค๋ฌ์"์ 8๊ฐ ์นดํ
๊ณ ๋ฆฌ๋ก ์ ๋ ์ ๊ฒํ๊ณ , ๊ฐ์ ๊ณํ์ ์์ฑํ๋ค.
์์ธ ์ ์ฐจ๋ INSTRUCTIONS.md๋ฅผ ์ฐธ์กฐํ์ธ์.
Input Detection
$ARGUMENTS ๋๋ ๋ํ ๋งฅ๋ฝ์์ ๋์์ ๊ฐ์งํ๋ค.
| Input | Detection | Capture Tool |
|---|
URL (http://, https://) | regex | agent-browser open + screenshot + snapshot -i |
| .pen file | extension .pen | mcp__pencil__get_screenshot + batch_get + search_all_unique_properties |
| Image (.png/.jpg/.webp) | extension | Read (๋ฉํฐ๋ชจ๋ฌ ์ง์ ๋ถ์) |
| CSS/Tailwind files | glob pattern | Grep (color, font, effect ํจํด) |
| No input | โ | AskUserQuestion์ผ๋ก ๋์ ํ์ธ |
๋ณต์ ์์ค ์ ๊ณต ์ ๋ชจ๋ ์์ค์์ ์์ง ํ ๊ต์ฐจ ๊ฒ์ฆํ๋ค.
Workflow
Phase 1: Capture
์
๋ ฅ ํ์
์ ๋ฐ๋ผ ์๊ฐ + ๊ตฌ์กฐ ๋ฐ์ดํฐ๋ฅผ ์์งํ๋ค.
- URL: agent-browser๋ก full-page screenshot + accessibility snapshot + CSS ํจํด grep
- .pen: pencil MCP๋ก screenshot + ๋์์ธ ํ ํฐ ์ธ๋ฒคํ ๋ฆฌ (์์, ํฐํธ, ๊ฐ๊ฒฉ, ๋ผ์ด๋ฉ)
- Image: Read๋ก ์ง์ ์๊ฐ ๋ถ์ (๊ตฌ์กฐ ๋ฐ์ดํฐ ์์ โ "Visual-only audit")
- CSS: Grep์ผ๋ก color/font/effect/layout ํจํด ์ถ์ถ
Phase 2: Audit
resources/01-ai-aesthetic-checklist.md๋ฅผ ๋ก๋ํ์ฌ 8๊ฐ ์นดํ
๊ณ ๋ฆฌ๋ณ 0-3์ ์ฑ์ :
- Color Palette โ AI Purple Problem, gradient ๋จ์ฉ, neon accent
- Typography โ ์ ๋ค๋ฆญ ํฐํธ(Inter/Roboto), ๊ณ์ธต ๋ถ์ฌ
- Surface Treatment โ ๊ณผ๋ํ smoothness, ์ง๊ฐ ๋ถ์ฌ
- Imagery โ Glowing orb, chrome 3D, ์คํก ๋๋
- Layout Regularity โ ์๋ฒฝํ ๋์นญ, 3-column grid ๋ฐ๋ณต
- Visual Effects โ Glassmorphism/glow/blur ๊ณผ์
- Brand Identity โ Generic SaaS template ๋๋
- Copy & Content โ AI slop copy, generic CTA, empty state ๋ถ์ฌ
์ด์ /24 โ ๋ฑ๊ธ:
| ์ด์ | ๋ฑ๊ธ | ์๋ฏธ |
|---|
| 0โ4 | Authentic | AI ํจํด ์ต์, ๊ณ ์ ์์ด๋ดํฐํฐ |
| 5โ10 | Mixed | ์ผ๋ถ ํจํด ์กด์ฌ, ๋ถ๋ถ ๊ฐ์ ๊ถ์ฅ |
| 11โ17 | AI-Adjacent | ์๋นํ AI ์ํฅ, ์ฐ์ ๊ฐ์ ํ์ |
| 18โ24 | AI-Saturated | ๊ฐํ AI ์์ฑ ๋๋, ์ ๋ฉด ์ฌ๊ฒํ |
์ ๋ ๋ถ์ ํต์ฌ: ๊ฐ์ ํต์ผ์ด ๋ฌธ์ ๊ฐ ์๋๋ผ "Custom vs Default" ๊ตฌ๋ถ์ด ํต์ฌ. Tailwind/ํ๋ ์์ํฌ default์ ์๋ ดํ๋๊ฐ, ์๋์ ๋์์ธ ์์คํ
์ธ๊ฐ.
Phase 3: Report
์ ์ 2+ ์นดํ
๊ณ ๋ฆฌ์ ๋ํด resources/02-improvement-patterns.md๋ฅผ ๋ก๋ํ์ฌ ๊ตฌ์ฒด์ ๊ฐ์ ์์ ํฌํจํ ๋ฆฌํฌํธ๋ฅผ ์์ฑํ๋ค.
๋ฆฌํฌํธ ๊ตฌ์กฐ:
- Summary โ ์ ์ฒด ์ธ์ 2-3๋ฌธ์ฅ
- Scores โ 8๊ฐ ์นดํ
๊ณ ๋ฆฌ ์ ์ ํ
์ด๋ธ
- Findings โ ์ฐ์ ์์ ์, Evidence + Pattern + Improvement
- Improvement Plan โ Quick Wins (1-2h) โ Structure (2-4h) โ Identity (4-8h)
Core Principles
- Evidence-based โ ๊ตฌ์ฒด์ ์์(hex, ํด๋์ค๋ช
, ์คํฌ๋ฆฐ์ท ์์ญ)๋ฅผ ๊ทผ๊ฑฐ๋ก ์ฑ์ . ์ฃผ๊ด์ ๋๋ ๋ฐฐ์
- Severity-ranked โ 3์ Critical โ 2์ High โ 1์ Low. ๊ฐ์ฅ ํฐ ์ํฅ๋ถํฐ
- Actionable โ ๋ชจ๋ finding์ ๊ตฌ์ฒด์ ์์ ๋ฐฉ์ ํฌํจ
- Non-dogmatic โ ๋งฅ๋ฝ์ ๋ฐ๋ผ AI ํจํด์ด ์๋์ ์ผ ์ ์์. Flagํ๋ condemnํ์ง ์์
- Brand-aware โ ๊ธฐ์กด ๋ธ๋๋ ์๋๋ฅผ ํ์
ํ ํ ์ ์. ๋ธ๋๋ ํ๊ดด์ ์ ์ ๊ธ์ง
Examples
URL ์ ๊ฒ
User: /design-audit https://example-saas.com
โ Phase 1: agent-browser screenshot + snapshot โ Phase 2: 7-category scoring โ Phase 3: report with findings
.pen ํ์ผ ์ ๊ฒ
User: /design-audit ~/Documents/project.pen
โ Phase 1: pencil screenshot + search_all_unique_properties โ Phase 2: scoring โ Phase 3: report
์์ฐ์ด ํธ๋ฆฌ๊ฑฐ
User: "์ด ์ฌ์ดํธ ๋๋ฌด AI์ค๋ฌ์ด๋ฐ ์ด๋ป๊ฒ ๊ณ ์น ์ ์์๊น?"
โ URL ๋๋ ๋์ ํ์ธ โ full audit workflow