Communitygithub.com

앱 디자인 스튜디오

앱 이름이나 웹사이트/웹 앱 아이디어를 완전한 고해상도 UI 디자인 저장소(페이지/화면, 모든 상태(로딩, 빈 화면, 오류, 오프라인), 대화상자, 시트, 컴포넌트, 상호작용)로 바꿔주며, 고정된 디자인 시스템과 측정 가능한 사용성 게이트를 포함합니다. 모바일 앱, 웹사이트, 웹 앱/포털/대시보드 세 가지 대상을 지원하며, 각 대상마다 고유한 프로필과 표현을 사용합니다. 사용자가 앱 이름이나 아이디어를 주면서 화면, 페이지, UI 디자인, 디자인 저장소, 목업, 화면 목록을 원하거나 개발자/디자이너에게 전달할 디자인을 요청할 때 사용하세요. 또한 생성된 기존 화면 세트의 사용성(대비, 대상 영역, 상태)을 감사하거나 수정할 때도 사용하며, 아름다움은 유지합니다.

앱 디자인 스튜디오란 무엇인가요?

App Design Studio는 하나의 앱 이름이나 웹사이트/웹 앱 아이디어만으로 완전한 고해상도 UI 디자인 저장소를 생성하는 AI 에이전트 스킬입니다. 이 스킬은 모바일 앱(세로 화면: 스플래시, 온보딩, 인증, 홈, 설정), 웹사이트(가로 데스크탑 페이지 + 좁은 반응형 레이아웃), 웹 앱/포털/대시보드의 세 가지 대상을 지원하며, 각 대상에 맞는 전용 프로필과 용어를 사용합니다. 핵심 강점은 디자인 시스템을 먼저 고정한 후 모든 화면에서 일관성을 유지하고, 측정 가능한 사용성 게이트(터치 대상 48dp 이상, 본문 텍스트 16sp 이상, 명암비 4.5:1 등)를 적용하여 아름다움과 사용성을 동시에 보장한다는 점입니다. Workflow(S0-S9)는 인테이크, 화면 인벤토리 구축, 3가지 디자인 방향 제시 및 사용자 선택, 토큰 생성, 컴포넌트 보드, 화면 및 상태 생성, 자체 비평 및 게이트 실행, 내보내기, 사용자 검토의 단계로 구성되며, 각 단계에서 스크립트 기반 검증과 사람의 취향 판단을 결합합니다. 주로 Claude Code, Codex, Cursor와 같은 AI 에이전트 플랫폼에서 사용되며, 생성된 디자인은 개발자에게 전달하거나 Compose/Flutter/React Native 코드 또는 Figma 브릿지에 사용할 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/zohaibmushwani/agent-skills/tree/HEAD/skills/app-design-studio

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

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

문서

앱 디자인 스튜디오은(는) 무엇을 하나요?

목표: 하나의 앱 이름으로 아름답고 동시에 사용 가능한, 모든 화면에서 일관되고 디자이너, Compose/Flutter/React Native를 만드는 에이전트, 또는 Compose-to-Figma 브릿지에 바로 전달할 수 있는 디자인 저장소를 만듭니다.

이 스킬이 존재하는 이유: 이미지 모델은 개별 화면은 매력적으로 그리지만 화면 간 드리프트가 발생하고, 상태를 깜빡하며, 사용성을 조용히 망가뜨립니다(작은 글씨, 낮은 명암비, 작은 터치 대상). 해결책: 먼저 디자인 시스템을 고정하고, 그로부터 생성한 후, 스크립트로 측정 가능한 것과 측정 불가능한 것(취향)을 루브릭과 사람의 선택으로 확인합니다.

대상 = 프로필 (먼저 결정, S0에서; 사용자가 website/portal/dashboard라고 말했을 때 조용히 기본값으로 넘어가지 않음)

대상방향 / 크기이 문서들(그리고 대상 표현을 위해 이것만) 읽기
mobile (앱)세로 9:19.5 화면, 한 가지 크기screen-taxonomy.md, design-bible-template.md의 모바일 블록, prompt-templates/README.md, dp/sp 단위의 최소값
web 종류 site (웹사이트, 랜딩, 스토어, 블로그)가로 데스크탑 16:10 (1440x900) 페이지 + 동일 페이지의 좁은 390px 반응형 레이아웃web-design.md, prompt-templates/web.md, design-bible-template.md의 웹 블록, px 단위의 최소값
web 종류 app (포털, 대시보드, 관리자, SaaS)가로 데스크탑 우선; 그 다음 좁은 레이아웃. 사용자가 휴대폰이 주 기기라고 말한 경우에만 "mobile_first": true로 설정하고 좁은 레이아웃을 기본으로 함site와 동일
both하나의 공유 바이블과 토큰, 두 개의 프로필두 세트 모두, 하나의 프롬프트 안에 절대 섞지 않음

inventory.json에 "platform": "mobile" | "web"을 설정합니다. 프롬프트는 정확히 하나의 프로필 어휘로 작성됩니다.

키워드 위생 (이 섹션이 존재하는 이유): 이미지 모델은 주어진 단어를 따릅니다. "portrait", "phone", "status bar", "9:19.5", "bottom navigation", "thumb zone", "Android/iOS" 또는 "app screen"이 포함된 웹사이트 프롬프트는 휴대폰 화면으로 돌아옵니다. 웹 프롬프트는 "website page", "landscape desktop 16:10, 1440 wide", "header with links", "sidebar", "browser-less"를 사용합니다. 좁은 레이아웃은 "narrow responsive layout, 390px wide"라고 부르며, 절대 "phone screen"이라고 부르지 않습니다. python scripts/prompt_lint.py <design-dir>는 prompts/ 내에서 다른 프로필의 단어를 사용하는 모든 프롬프트를 실패 처리합니다. 배치를 보내기 전에 실행하세요.

출력 규칙 (항상)

  • 이미지는 UI 그 자체이며, 가장자리까지: 기기 프레임, 휴대폰/노트북 목업, 브라우저 크롬, 추가 배경, 주변 캔버스가 없습니다. (사용자가 보드를 요청한 경우에만 프레젠테이션 프레임.) 모바일: 세로 화면. 웹: 가로 데스크탑 페이지와 나열된 곳의 좁은 레이아웃; 긴 페이지는 같은 너비의 하나의 긴 이미지 또는 2-3개의 섹션 이미지로.
  • 이 스킬의 예시는 패턴을 설명하기 위한 것이지 내용이 아닙니다: 이름, 내용, 색상표, 유형 또는 레이아웃을 프롬프트에 복사하지 마세요(references/design-craft.md의 편향 방어 장치).
  • 고해상도: 실제 카피, 실제 아이콘, 실제 이미지. 로렘 입숨이나 플레이스홀더 브랜드 이름은 사용하지 않습니다.
  • 전체 세트에 걸쳐 하나의 디자인 시스템. 화면마다 새로운 스타일을 절대 만들지 않습니다.
  • 두 가지 프롬프트 모드(references/design-craft.md): brief (짧은 의도 + 중요한 몇 가지 사실 + 느낌; 첫 번째 렌더링과 S2 방향에 기본값, 가장 독특한 결과 제공) 및 locked (정확한 문자열, 개수, 바이블 블록; 선택 후 형제 화면 및 수정용). 먼저 brief로 렌더링하고, 보고, 일치해야 하는 것을 locked합니다. 모델은 아름다움보다 일관성에서 훨씬 더 많이 실패하지만, 첫 번째 렌더링을 지나치게 제약하면 기계적으로 만듭니다.
  • 편집, 재시도하지 않음: 잘못된 문자열 하나를 해당 변경만 지정하는 편집 패스로 수정; 전체 재시도는 이미 승인된 모든 것을 버립니다.
  • 실제 브랜드, 로고 또는 실제 사람의 얼굴은 사용하지 않음; 가상 이름과 일반 마크만. 절대 API 키를 저장소에 작성하지 않습니다.
  • 사용자가 작성하는 언어로 답변(종종 로마자 우르두어/힌글리쉬); 파일과 프롬프트는 영어로 유지합니다.

워크플로 (S0-S9)

사용자의 프로젝트 폴더 design/<app-slug>/에서 작업합니다(레이아웃: references/repo-layout.md). design/<app-slug>/STATUS.md에서 단계 상태를 추적합니다. 결과를 바꾸는 경우에만 사용자에게 질문합니다(S0에서 최대 3개 질문); 그렇지 않으면 합리적인 기본값을 선택하고 그렇게 말합니다.

S0 인테이크. 앱/사이트 이름, 한 줄 목적, 대상, 대상 + 종류(위 표; "website", "portal", "dashboard" 또는 "landing"이라는 단어가 나타나고 대상이 불분명한 경우 질문), 플랫폼 느낌(모바일 기본값: Android + iOS 중립, Material 3 지향; 웹: 중립), 톤 단어, 라이트/다크(기본값: 라이트 + 다크 토큰, 화면은 라이트로). BRIEF.md를 작성합니다(문제, 대상, 범위, 비목표); 사용자가 응답하지 않으면 기다리지 않고 맨 위에 당신이 내린 판단을 명시합니다. references/aesthetic-vs-usability.md를 한 번 읽습니다.

S1 화면 인벤토리. references/screen-taxonomy.md(웹: references/web-design.md 섹션 4)에서 inventory.json을 구축합니다: 고정 핵심(스플래시, 언어, 온보딩, 권한, 인증, 홈, 설정) + 이 앱에 특화된 기능 화면 + 세부 사항 + 상태 + 대화상자 + 시트 + 컴포넌트. 각 항목은 id, 그룹, 목적, 상태, 우선 순위를 가집니다. 사용자에게 간결한 목록을 보여줍니다; 이미지 크레딧을 소비하기 전에 확인합니다.

S2 디자인 계획 + 바이블 + 3가지 방향 (인간 게이트). 먼저 방향당 10줄의 디자인 계획(references/design-craft.md 섹션 2)을 작성하고 일반적인 기본값에 대해 자체 검토합니다. 그런 다음 세 가지 짧은 대안(다른 분위기, 색상표 논리, 유형, 모양 언어)으로 바이블(references/design-bible-template.md)을 작성합니다. 각 바이블은 모든 채워진 색상(on-primary, on-accent, 배지 텍스트)의 텍스트 색상과 플랫폼의 상태 표시줄(Android: 시간 왼쪽, 아이콘 오른쪽; iOS: 9:41 스타일)을 지정합니다. 렌더링하기 전에 각 방향의 색상표를 작은 토큰 파일에 넣고 scripts/contrast_check.py를 실행합니다: 실패하는 대비로만 좋아 보이는 방향은 사람의 선택에 도달해서는 안 됩니다. 각 프롬프트를 먼저 prompts/<id>.<direction>.md에 작성하고 정확히 해당 파일의 텍스트를 보냅니다(저장된 프롬프트가 재현 가능한 것입니다). 방향당 하나의 히어로 화면을 렌더링합니다(웹: 동일한 페이지, 데스크탑 및 모바일). 세 가지 모두를 하나의 Codex 호출로 배치합니다. 멈추고 사용자가 선택하도록 합니다 - 취향은 스크립트가 판단할 수 없는 유일한 것이므로, 이것이 인간이 결정하는 지점입니다. 선택을 DESIGN.md에 기록합니다.

S3 토큰. 선택된 방향에서 tokens.json을 작성합니다(색상 라이트/다크, 유형 스케일, 간격 4/8 그리드, 반경, 고도, 아이콘 크기, 터치 대상). scripts/contrast_check.py tokens.json을 실행하고 지금 실패하는 쌍을 수정합니다 - 40개 화면을 나중에 수정하는 것보다 저렴합니다.

S4 컴포넌트 보드. 토큰에서 컴포넌트 시트(버튼, 입력, 칩, 카드, 목록 행, 네비게이션, 상단 바, 토스트, 대화상자, 시트)를 생성합니다. 이 이미지는 이후 모든 생성에 전달되는 시각적 참조이며, 화면의 일관성을 유지합니다.

S5 화면. references/prompt-templates/를 사용하여 인벤토리 순서로 화면을 생성합니다. 모든 프롬프트는 고정된 바이블 블록으로 시작한 다음, 정확한 문자열과 개수, 그리고 명시적인 "추가하지 말 것" 목록으로 이어집니다. 작업에 따라 엔진을 선택합니다: 전체 화면의 경우 텍스트 지원 모델(gpt-image/Codex, Nano Banana, Stitch) 또는 HTML-렌더링 경로(정확한 텍스트 및 개수, 그다음 스크린샷; 21개 화면 PDF 리더 세트에서 종단 간 테스트 완료: tokens.json CSS 변수와 Iconify 아이콘으로 html/<group>/<id>.html을 작성한 다음, node scripts/render_screens.mjs <design-dir>이 PNG와 실제 DOM에서 측정된 <id>.spec.json을 작성하고 run_gates.py가 감사합니다. Node + playwright 필요, 로컬에 설치되지 않은 경우 env PLAYWRIGHT_MODULE/CHROME_PATH) - FLUX/Runware는 UI 텍스트와 개수를 왜곡하므로 화면 내부의 아티스트용으로만 사용합니다. 아이콘은 Iconify MCP를 사용하여 아이콘 스타일을 하나의 패밀리로 유지합니다. 도구가 지원하는 경우 컴포넌트 보드를 스타일 참조로 전달합니다. screens/<group>/<id>.png 및 <id>.spec.json(요소 크기, 글꼴 크기, 색상, 상호작용 플래그 포함 - 스키마는 references/repo-layout.md에 있음)으로 저장합니다.

S6 상태, 대화상자, 시트. 동일한 프롬프트, 동일한 바이블. 빈 상태는 다음 작업을 안내합니다. 오류는 빈 상태와 시각적으로 다릅니다. 로딩은 실제 레이아웃과 일치하는 스켈레톤을 사용합니다.

S7 자체 비평, 판결 및 프롬프트 로그. 사용자에게 보여주기 전에 모든 렌더링을 직접 비평합니다(references/critique-template.md: 증거를 포함한 사용성 통과/실패 + 미학 루브릭, reports/critique/<id>.md에 작성); 4.0 미만 또는 사용성 실패는 사용자에게 묻지 않고 편집 패스로 수정하거나 거부하고 재생성하는 것을 의미합니다. 생성된 모든 이미지를 살펴본 후 판결(수락 / 수정 / 거부)을 작성하고 기록합니다: python scripts/prompt_log.py add <design-dir> --id ... --image ... --prompt ... --mode brief|locked|edit --verdict ... --tags ... --reason ...; 거부된 이미지는 rejected/로 이동합니다. prompt_log.py summary는 프롬프트 모드별 수락률과 반복되는 실패 태그를 보여줍니다; 두 번 거부된 모든 태그는 references/design-craft.md "Learned lessons"에 한 줄이 됩니다(이것이 스킬이 개선되는 방식입니다). 그런 다음 python scripts/run_gates.py design/<app-slug>를 실행합니다. 대비, 토큰 린트, 요소 감사(터치 대상, 최소 텍스트 크기), 상태 커버리지를 실행하고 reports/gates.md를 작성합니다. 그런 다음 각 화면을 references/aesthetic-vs-usability.md의 루브릭으로 점수를 매깁니다(PNG를 열고 살펴봅니다 - 기억으로 점수를 매기지 않음). 실패한 화면을 최대 각각 2번 재생성합니다. 그래도 실패하면 루프 대신 사용자에게 플래그를 지정합니다.

S8 내보내기. 저장소를 조립합니다(references/repo-layout.md): PNG, 명세, 토큰, DESIGN.md, 인벤토리, 흐름 맵, copy/strings.json, 보고서. 선택적 추가 항목, 사용자가 원할 때만: (a) 정확한 CSS 값을 위한 HTML 진실 레이어(references/image-qa-loop.md), (b) 에셋 저장 - 아이콘, 기능 그래픽, HTML 텍스트로 렌더링된 헤드라인이 있는 스토어 스크린샷, references/store-asset-specs.md에 대해 scripts/validate_assets.py로 검증됨. 마케팅 스토어 스크린샷(상위 차트 앱과 같은 헤드라인 주도 세트)의 경우 이 화면을 입력으로 store-screenshots 스킬을 사용합니다. 선택적 핸드오프: 토큰/명세는 Compose 코드 + Figma 브릿지에 공급됩니다. HANDOFF.md에 명시합니다.

S9 사용자 검토. 연락처 시트와 게이트 보고서를 제시합니다. 실제 앱이 존재하기 전에 생성된 모든 것은 concept로 레이블이 지정됩니다(개념 상점 그래픽을 실제 캡처로 제시하지 않음).

판단 가이드 (미학 대 사용성)

최소값은 대상에 따라 다릅니다: 모바일 = 아래 dp/sp 숫자; 웹 = references/web-design.md 섹션 3의 px 최소값(44px 히트 영역, 본문 >= 16px, 65ch 줄, 390에서 가로 스크롤 없음). 사용성을 바닥, 미학을 천장으로 취급합니다. 바닥 숫자는 측정 가능하므로 협상 불가능: 터치 대상 >= 48dp (44pt iOS), 본문 텍스트 >= 16sp 및 12sp 미만 없음, 명암비 4.5:1 (큰 텍스트 및 아이콘의 경우 3:1), 화면당 하나의 기본 작업, 하단 엄지 영역의 키 작업, 4/8 간격 그리드. 바닥 위에서는 개성을 쏟아붓습니다: 독특한 유형 쌍, 통제된 악센트, 흐름당 하나의 기억에 남는 일러스트레이션이나 이미지 순간, 넉넉한 간격. 충돌할 때(예: 창백한 회색 우아한 레이블), 사용성이 이기고 우아함은 다른 곳(두께, 간격, 크기 대비)에서 회복하며, 바닥을 낮추지 않습니다.

피해야 할 것 ("AI 특유의 표현")

첫 번째 프롬프트를 작성하기 전에(references/design-craft.md, references/interaction-and-density.md, references/ai-tells-avoid.md를 읽습니다. 간략 설명은 밀도 대상을 명시: 적은 단어, 넉넉한 공간, 하나의 기본 작업). 짧은 버전: 보라-파랑 그라데이션, 이유 없는 유리 카드, 상자-속-상자 중첩, 가짜 차트 스팸, 12개 위젯 홈, 일반 아이콘 팩 혼합, 작은 장식용 레이블, 로렘 입숨, 작은 편집으로 복제된 화면.

참조 맵

  • references/screen-taxonomy.md - 어떤 화면/상태/대화상자/시트가 있고 언제 있는지(MOBILE 대상만 해당).
  • references/web-design.md - 웹사이트/웹 앱 대상: 뷰포트, px 최소값, 페이지 분류, 레이아웃, 웹 AI 특유의 표현.
  • references/prompt-templates/web.md - 웹 FORMAT/CONTENT 블록 및 페이지 유형별 프롬프트.
  • references/aesthetic-vs-usability.md - 다이얼, 바닥, 루브릭, 재생성 규칙.
  • references/design-bible-template.md - 모든 프롬프트에서 반복되는 블록.
  • references/prompt-templates/ - 화면 유형별 프롬프트.
  • references/design-craft.md - brief vs locked 프롬프트, 디자인 계획, 일반적인 기본값, 한 곳에서의 대담함, 카피 규칙, 비평 루프.
  • references/ai-tells-avoid.md - 안티 패턴.
  • references/repo-layout.md - 폴더 레이아웃 및 JSON 스키마.
  • references/image-qa-loop.md - 이미지별 확인/편집 루프, 선택적 HTML 진실 레이어, strings.json.
  • references/store-asset-specs.md - Play/App Store 크기 및 규칙 (제출 전에 공식 페이지를 다시 확인).
  • references/interaction-and-density.md - 단어/밀도 예산, 점진적 공개, 가시적인 상호작용 상태, 검토 질문 (모든 브리프 및 비평에 사용).
  • references/critique-template.md - 이미지별 자체 비평 및 수정 루프.
  • scripts/prompt_log.py - 판결 로그 + 학습 내용 요약 (S7 참조).
  • assets/ - 예시 tokens.json, inventory.json, spec.json, DESIGN.md 골격.
  • scripts/ - 결정론적 게이트 (Python 스크립트, scripts/README.md 참조).

Individual skills in this repo

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

screenshot-to-compose

Turn app design screenshots (JPG/PNG, often AI-generated) or Figma frames into a native Kotlin Jetpack Compose UI that matches them, design-first. Measures pixels and colours (px to dp), writes screen/asset inventories and a design system with observed vs inferred values, builds Iconify icons into VectorDrawables, generates artwork instead of cropping the screenshots, implements MVI screens, then compares emulator or Roborazzi renders against the reference. Use whenever the user supplies screenshots, mockups or a design repository and wants them built as an Android Compose app, says "make this screen in Compose", "match the design", "px to dp", "screenshot to code", or wants a whole app UI built design-first, even if they never say "Compose".

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.

관련 스킬