Community이미지github.com

screenshot-to-compose

디자인 스크린샷(JPG/PNG, AI 생성 포함)이나 Figma 프레임을 원본 디자인과 일치하는 네이티브 Kotlin Jetpack Compose UI로 변환합니다. 픽셀 단위까지 측정하고, 설계 시스템을 구축하며, MVI 패턴으로 화면을 구현하고, 최종 렌더링 결과를 참조 이미지와 비교합니다.

screenshot-to-compose란 무엇인가요?

이 스킬은 디자이너나 개발자가 제공한 앱 디자인 스크린샷, 목업, 또는 Figma 프레임을 그대로 재현하는 안드로이드 Jetpack Compose UI를 생성하는 데 사용됩니다. 사용자가 '이 화면을 Compose로 만들어 줘', '디자인에 맞춰 줘', 'px를 dp로 변환해 줘' 등의 요청을 하거나, 앱 전체 UI를 디자인 중심으로 구축하고자 할 때 활성화됩니다. 스킬은 먼저 저장소의 아키텍처와 기존 컴포넌트를 분석한 후, 모든 참조 이미지를 문서화하고, `measure_image.py` 스크립트로 픽셀 단위를 dp로 변환하며 색상을 샘플링합니다. 측정된 값은 '관찰된 값(observed)'과 '추론된 값(inferred)'으로 구분하여 기록하고, Material 3 기반의 테마와 아이콘, 아트워크를 자동 생성합니다. 마지막으로 `compare_side_by_side.py` 스크립트로 렌더링된 화면을 원본과 나란히 비교하여 레이아웃, 간격, 색상 등의 차이를 찾고 수정하는 과정을 반복합니다. 이 스킬은 Cursor, Claude Code, Codex 등 여러 AI 에이전트 환경에서 사용할 수 있도록 설계되었으며, 특히 Android Compose 프로젝트에서 디자인 충실도를 최우선으로 하는 워크플로우를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zohaibmushwani/agent-skills/tree/HEAD/skills/screenshot-to-compose

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

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

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

문서

screenshot-to-compose은(는) 무엇을 하나요?

디자인을 Compose에서 눈대중 없이 충실히 재현합니다. 참조 이미지가 곧 승인 테스트이므로, 사용하는 모든 숫자는 관찰된 값(이미지에서 측정)이거나 추론된 값(추측임을 명시)이어야 하며, 완성된 화면은 마지막에 참조 이미지와 비교됩니다.

디자인이 입력으로 주어질 때

  • 스크린샷/목업만 있는 경우: 아래 모든 단계를 따릅니다.
  • Figma 프레임이 있는 경우: 측정 단계를 건너뛰고(Figma에서 값을 읽어옴) 나머지 단계를 진행합니다.
  • 디자인이 아직 없는 경우: 먼저 app-design-studio 스킬을 사용하고, 그 후에 이곳으로 돌아옵니다.

워크플로우

docs/design/ 디렉토리에서 파일 단위로 작업하며, 공통 기반이 마련된 후에 한 화면씩 진행합니다. 전체 화면 인벤토리를 이해하기 전에는 어떤 것도 구현하지 마십시오.

  1. 검사. 저장소를 먼저 읽습니다(아키텍처, 테마, 공유 컴포넌트, 기존 화면). 잘 동작하는 것은 유지합니다. 가정 사항을 기록합니다.
  2. 인벤토리. 참조 이미지를 수정 없이 docs/design/reference/에 복사합니다(케밥-케이스 이름 사용). SCREEN_INVENTORY.md를 작성합니다: 각 이미지 -> 화면 + 상태, 화면 간 링크, 누락된 참조(링크되었지만 이미지가 없는 화면), 픽셀 크기 및 종횡비. 로딩, 빈 상태, 에러, 오프라인, 권한, 프리미엄 등 모든 상태를 포함합니다.
  3. 측정. scripts/measure_image.py shot.png --frame-dp 390 --sample x,y ...를 실행하여 px->dp 스케일과 색상 샘플을 얻습니다(references/measuring.md 참조). 픽셀은 dp가 아닙니다: 별도 지시가 없으면 390 dp 프레임을 기준으로 하며, dp = px / (imageWidthPx / 390) 공식을 사용합니다. 관찰된 값과 추론된 값을 별도 컬럼에 기록합니다.
  4. 설계 시스템. 측정된 색상을 Material 3 역할, 타이포그래피 스케일, 도형, 간격에 매핑하여 테마를 구성합니다. 화면은 테마 토큰만 사용합니다(화면에 직접 16진수 색상, 크기, 둥글기 사용 금지). 라이트/다크 모드를 모두 정의하고, 라이트만 있는 경우 레이아웃을 변경하지 않고 다크 모드를 유도합니다.
  5. 에셋(references/assets.md). 아이콘: 하나의 패밀리를 선택하여 Iconify에서 가져오고 scripts/svg_to_vectordrawable.py로 변환합니다. 아트워크: 직접 생성하며, 스크린샷에서 잘라내지 않습니다. 텍스트, 버튼, 카드, 링, 차트는 항상 Compose로 구현하고 이미지를 사용하지 않습니다. 출처, 라이선스, 모델, 프롬프트를 ASSET_INVENTORY.md에 기록합니다.
  6. 계획. 화면별로 사전에 결정할 사항: 뒤로가기 동작, 네트워크/오프라인 클래스, 권한, 작은 폰에서 스크롤 또는 맞춤, 모션. SCREEN_IMPLEMENTATION_PLAN.md를 작성하고 빌드 순서를 정합니다. (이에 대한 품질 규칙은 android-compose-quality-gate 스킬에 있습니다.)
  7. 구현 공통 기반을 먼저 만든 후 화면을 구현합니다: 불변 UI 상태 위의 무상태(stateless) 컴포저블, 인텐트가 있는 ViewModel, 파일당 하나의 컴포저블, 모든 텍스트는 문자열 리소스 사용. 독립적인 모듈만 파일이 겹치지 않도록 병렬화합니다. 카드, 타일 또는 빡빡한 텍스트를 만들기 전에 references/compose-lessons.md를 읽습니다.
  8. 비교(references/verification.md). 화면을 렌더링하고(에뮬레이터 스크린샷 또는 Roborazzi), scripts/compare_side_by_side.py로 참조 이미지와 동일한 너비로 나란히 배치한 후 레이아웃, 간격, 타이포그래피, 색상, 도형, 에셋의 차이를 나열하고 수정한 후 반복합니다. 그 다음 작은 기기(360 x 526 dp), 긴 텍스트/독일어, RTL, 다크 모드, 글꼴 크기 1.3을 테스트합니다. 픽셀 단위의 일치를 위해 기능이나 반응성을 희생하지 마십시오.
  9. 전달. 참조 이미지, 프롬프트가 포함된 에셋, 아이콘 출처/라이선스, 인벤토리 및 비교 노트를 최신 상태로 유지합니다. 화면이 실제로 동작하고 시각적 비교를 통과했을 때만 완료된 것으로 간주합니다. 주제별로 커밋합니다.

일반적인 실패를 막는 규칙

  • 참조 스크린샷에서 이미지를 잘라내지 마십시오(저해상도, 압축됨, UI가 내장됨).
  • 네이티브 UI를 이미지로 대체하지 마십시오.
  • 참조가 모호할 때 디자인을 임의로 만들지 마십시오: 가장 합리적인 추론을 하고 추론된 컬럼에 기록하며 참조에 가깝게 유지합니다.
  • 실행 및 비교 전에는 화면이 완료되었다고 주장하지 마십시오.
  • 저장소나 문서에 비밀(API 키)을 포함하지 마십시오; 이미지 서비스 키는 환경 변수에서 가져옵니다.

파일

  • references/measuring.md - px에서 dp로 변환, 색상 샘플링, 관찰된 값과 추론된 값 표.
  • references/assets.md - Iconify에서 VectorDrawable로 변환, 이미지 생성 순서 및 리뷰, 내보내기 크기, 기타 출처.
  • references/compose-lessons.md - 실제 시간을 소모했던 결함: 형제 카드 비율, 내부 측정 크래시, 너비 임계값, 자동 크기 조절 텍스트.
  • references/verification.md - 에뮬레이터와 Roborazzi 비교 루프 및 기기 매트릭스.
  • scripts/measure_image.py, scripts/svg_to_vectordrawable.py, scripts/compare_side_by_side.py (Python 3 + Pillow).

Individual skills in this repo

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

app-design-studio

Turn an app name or a website / web-app idea into a complete high-fidelity UI design repository - pages or screens, every state (loading, empty, error, offline), dialogs, sheets, components, interactions - with a locked design system and measurable usability gates. Three targets, each with its own profile and wording - mobile app (portrait screens: splash, onboarding, auth, home, settings), website (landscape desktop pages plus a narrow responsive layout), web app / portal / dashboard. Use whenever the user gives an app name or idea and wants screens, pages, UI design, a design repo, mockups, a screen inventory, or a design to hand to developers/designers, even if they never say "skill" or "Figma". Also use to audit or fix an existing set of generated screens for usability (contrast, targets, states) while keeping them beautiful.

store-screenshots

Create App Store and Google Play marketing screenshot sets that look like top-chart apps - a headline-led story of 5-8 frames with a poster-style first frame, zoomed real UI fragments, a dominant brand colour, panoramic links between frames, social proof and human touches - generated frame by frame with Codex (GPT Image) using the app's real screens as reference images, text-checked and edit-passed, then fitted to the exact store sizes. Use whenever the user wants store screenshots, "App Store screenshots", "Play Store images", listing graphics, a screenshot redesign or "before/after" for a store page, or wants their app's store page to convert better, even if they only say "screenshots" for an app. Takes real app screens (for example from app-design-studio) as input.

관련 스킬