Community이미지github.com

plugin87/image-to-code

참조 이미지, 스크린샷 또는 목업을 토큰 기반의 접근성 있는 코드로 변환합니다. — 참조에서 디자인 시스템(팔레트, 타이포그래피 스케일, 간격, 반경, 레이아웃 아키타입)을 추론하여 3계층 토큰에 매핑하고, 이를 재구성한 후 키트의 게이트를 통해 검증합니다. 사용자가 디자인/스크린샷을 제공하고 일치하는 UI 코드를 원할 때 사용하세요.

image-to-code란 무엇인가요?

이 스킬은 시각적 참조(이미지, 스크린샷, 목업)를 일회성 복사본이 아닌 실제 디자인 시스템으로 재구성합니다. 개발자는 이미지에서 색상 팔레트, 타이포그래피 스타일, 간격 및 밀도, 반경과 깊이, 레이아웃 아키타입을 체계적으로 분석하고, 이를 3계층 DTCG 디자인 토큰으로 변환하여 단일 theme.css 파일에 저장합니다. 추론된 값이 접근성 기준(AA 대비)을 충족하는지 대비 검증 스크립트로 확인하며, 브랜드 자산이나 저작권 있는 이미지를 재현하지 않고 시스템의 디자인 언어에 집중합니다. 지원되는 플랫폼은 Claude Code와 같은 AI 에이전트 환경으로, `design-tokens` 스킬, 대비 검증 스크립트, 레이아웃 측정 및 하드코드 린트 도구 등과 함께 사용됩니다. 사용자는 이 스킬을 통해 디자인 참조 이미지에서 일관된 디자인 시스템을 추출하여 토큰 기반의 접근성 높은 UI 코드를 자동 생성할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/plugin87/ux-ui-agent-skills/tree/main/.claude/skills/image-to-code

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

스킬: 이미지를 코드로

참조 이미지의 디자인을 진정한 디자인 시스템으로 재구성하세요. 일회성 복사본이 아닌 시스템(색상/타이포그래피/간격 언어)을 일치시키고, 저작권이 있는 이미지나 브랜드 에셋은 절대 가져오지 마세요.

단계

  1. 디자이너처럼 참조를 읽어보세요. 다음을 추론하고 기록하세요:
    • 팔레트 — 1개의 주요 표면 패밀리, 텍스트 색상, 1개의 주요 액션 + 최대 1개의 강조색 (임의의 hex를 추측하지 말고 색상을 샘플링하세요).
    • 타이포그래피 — 패밀리 느낌(기하학적/그로테스크/세리프), 스케일 점프, 디스플레이 대 본문 대비, 두께.
    • 간격 및 밀도 — 기본 단위, 섹션 리듬, 카드 패딩; 넉넉함 대 좁음.
    • 반경 및 깊이 — 반경 언어(날카로움/부드러움/필), 그림자 대 가는선 구분.
    • 레이아웃 아키타입 + 순서 — 전체 너비 히어로 / 비대칭 분할 / 벤토 / 에디토리얼 스택 (taste/design-taste.md → 변형 규칙).
  2. 가까운 시스템이 있으면 앵커로 삼으세요. taste/aesthetic-systems.md / python3 scripts/design_systems.py search <term>을 탐색하고 해당 레시피를 채택하여 결정을 안정화하세요.
  3. 추론된 값으로 토큰 테마를 구축하세요. 3계층 DTCG로 (design-tokens 스킬); 단일 theme.css를 생성하세요. 모든 색상 쌍을 scripts/contrast.py / scripts/validate_contrast.py (라이트 + 다크)로 검증하세요 — AA를 통과하지 못한 샘플링된 브랜드 색상은 조정됩니다; 취향이 POUR보다 우선하지 않습니다.
  4. 레이아웃 및 컴포넌트를 토큰 기반으로 재구축하세요. frameworks/adapter-protocol.md + components/*를 통해: 하나의 공유 프리미티브 레이어, 모든 8가지 상태, a11y 연결, 이모지 없음 (lucide), 단일 테마. design-taste.md를 적용하여 일반적인 수준으로 퇴보하지 않도록 하세요.
  5. 참조와 대비하여 검증하세요. 렌더링하고 스크린샷을 찍어 참조와 나란히 비교하세요; node scripts/measure_render.mjs, lint_hardcodes.py, taste_audit.mjs, npm run verify를 실행하세요.

검증 (완료 조건)

  • npm run verify가 100% 통과 (토큰 해결, 대비 AA 라이트+다크, 하드코드/이모지 없음, 실제 렌더링 WCAG).
  • 재구축된 UI는 하나의 추론된 토큰 테마를 사용합니다 — 섹션별 팔레트는 없습니다.
  • 결과 스크린샷이 참조의 디자인 언어와 시각적으로 일치합니다.

정직한 한계: 이는 픽셀 단위 복사본이 아닌 디자인 시스템을 일치시킵니다. 참조의 사진, 로고 또는 저작권이 있는 텍스트를 재현하지 마세요 — 대신 자체 콘텐츠나 일반적인 플레이스홀더로 대체하세요.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

plugin87/design-tokens

Generate, extend, or audit design tokens in DTCG format with the 3-tier architecture (primitive → semantic → component). Use when the user wants a color palette, type scale, spacing/shadow/radius/motion tokens, multi-brand theming, or wants to validate token files. Covers colors, typography, spacing, shadows, borders, breakpoints, motion, gradients, opacity, blur, sizing, states, theming.

plugin87/governance

Govern how the design system evolves — SemVer for tokens/components, the contribution workflow, deprecation policy, and change communication. Use when the user wants to add/promote/deprecate a component or token, decide a version bump, set up a contribution process, or keep the system from fragmenting.

plugin87/performance

Optimize UI performance against Core Web Vitals — LCP, INP, CLS — with loading/code-split strategy, layout-shift prevention, and animation performance rules. Use when the user wants to improve speed, fix jank or layout shift, hit Web Vitals budgets, or make a UI feel fast on low-end devices.

plugin87/prototype

Move an idea up the fidelity ladder (content-first → wireframe → low-fi → high-fi → code) with a validation plan at each level, plus user-journey mapping and usability-testing scripts. Use when the user wants to prototype, wireframe, map a user flow, or plan/run usability testing.

plugin87/redesign

Upgrade an existing website or app to premium quality without breaking functionality — audit the current design, identify generic/AI tells, then apply taste and system rules surgically. Use when the user wants to improve, modernize, polish, or "make better" an existing UI/codebase.

plugin87/token-build

Set up or run the token build pipeline — transform the DTCG tokens/*.json (source of truth) into platform artifacts (CSS variables, Tailwind @theme, JS/TS, iOS Asset Catalog, Android, Compose) with Style Dictionary / Tokens Studio / W3C DTCG export. Use when the user wants to generate platform theme files from tokens, wire token CI, or multi-platform token output.

plugin87/ux-writing

Write or review UI copy — buttons, errors, empty states, microcopy, notifications, labels — using the voice & tone system (clear, concise, useful, human, honest) with the what→why→how error formula and inclusive-language rules. Use when the user needs interface copy, error messages, empty-state text, or a copy review.

관련 스킬