Communitygithub.com

cucoreanu/personal-skills

사용자 중심 워크플로, 충실도 수준, 6단계 프로세스, 외부-내부 캔버스 조립 방식을 사용하여 Penpot에서 UI 목업을 계획하고 구축합니다. 목업, 화면 목업, 와이어프레임에서 목업으로의 작업, 저/고충실도 UI, 플랫폼별 레이아웃, Penpot에서의 목업 디자인 모범 사례를 만들 때 사용하세요.

personal-skills란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 Penpot 디자인 도구 내에서 UI 목업을 체계적으로 계획하고 구축할 수 있도록 설계된 방법론입니다. 이 스킬은 사용자 목표, 대상 사용자, 충실도(저/고), 플랫폼(모바일, 웹, 데스크톱, 반응형)을 먼저 명확히 한 후, 구조와 흐름을 검증하는 6단계 워크플로(목표 정의 → 와이어프레임 → 그리드 시스템 → 색상 및 타이포그래피 → UI 컴포넌트 → 세부 사항 정제)를 따릅니다. 특히 와이어프레임 대비 디테일이 더해진 시각적 목업에 초점을 맞추며, Penpot 캔버스 조립 시 '외부-내부(outside-in)' 순서(컨테이너 → 섹션 셸 → 중첩 요소)를 엄격히 준수하도록 요구합니다. 이 스킬은 접근성, 시각적 일관성, 반복적 피드백을 강조하며, `penpot-design` MCP 도구와 함께 사용하도록 최적화되어 있어 AI가 사용자 입력만으로도 전문적인 UI 디자인을 생성할 수 있게 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/penpot-mockup

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

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

문서

Penpot Mockup

Penpot에서 목업 디자인을 위한 방법론입니다. penpot-design (컴포넌트, flex, API, 외부-내부 트리)와 함께 Penpot MCP를 실행하세요. 쓰기 작업 전에 high_level_overview를 한 번 읽으세요.

먼저 질문

다음 중 누락된 사항이 있으면 중단하세요:

  1. 목표 및 범위 — 웹사이트, 모바일 앱, 데스크톱 앱, 또는 반응형? 어떤 화면 또는 흐름인가요?
  2. 대상 사용자 — 누가 사용하나요? (예: 고령 사용자 → 더 큰 글꼴, 단순한 내비게이션)
  3. 충실도 — low (구조, 레이아웃, 흐름) 또는 high (색상, 타이포그래피, 이미지, 다듬기)?
  4. 플랫폼 — 모바일, 웹, 데스크톱, 또는 반응형. 설정된 프로젝트 규칙이 있으면 따르고, 없으면 질문하세요. 절대 가정하지 마세요.
  5. 지침 — 무엇을 만들거나 변경할지. 요청이 있을 때만 다중 변형 대안을 제시하세요.

목업 vs 와이어프레임 vs 프로토타입

단계목적Penpot 초점
와이어프레임레이아웃, 계층 구조, 사용자 흐름 — 시각적 다듬기 없음단순한 도형, 플레이스홀더, 실제 간격
목업시각적 디자인 — 느낌과 외관, UI 세부 사항이 스킬
프로토타입상호작용 — 클릭, 흐름, 상태사용자가 요청한 경우에만; 상태에는 변형 사용

사용자가 대화형/프로토타입 동작을 요청하지 않는 한 정적 시각적 목업이 기본입니다.

충실도

저충실도 — 구조와 흐름을 빠르게 검증합니다. 단순한 채움, 플레이스홀더, 그리드 정렬 레이아웃. 다듬기 전에 레이아웃과 사용자 흐름을 반복합니다. penpot-design에서 mockup 모드에 해당합니다.

고충실도 — 클라이언트 제공 또는 개발자 인계 준비. 색상 팔레트, 타이포그래피, 이미지, 브랜드 컴포넌트. penpot-design에서 design 모드에 해당합니다.

6단계 워크플로

이 순서대로 작업하세요. 구조가 검증되기 전에 다듬기 단계로 건너뛰지 마세요.

  1. 목표 및 범위 정의 — 목적, 대상 사용자, 플랫폼 제약 조건.
  2. 와이어프레임 — 플레이스홀더로 섹션, 콘텐츠 영역, 내비게이션, CTA 개요 작성. 계층 구조와 흐름에 집중.
  3. 그리드 시스템 — 요소 정렬; 일관된 간격 (penpot-design 기준 8dp 스케일). 시각적 계층 구조 구축 (제목 > 본문 텍스트).
  4. 색상 및 타이포그래피 — 제한된 팔레트; 읽기 쉬운 글꼴 (크기, 줄 높이, 자간); 충분한 대비. mockup-practices.md 참조.
  5. UI 컴포넌트 — 버튼, 입력 필드, 내비게이션 바, 아이콘. 두 번 이상 나타나면 → 컴포넌트. 상태 → 변형. 사용성을 위해 배치와 크기가 중요.
  6. 세부 사항 정제 — 이미지, 아이콘, 간격, 대비. export_shape로 내보내기 확인.

캔버스 조립 (필수)

위 방법론은 무엇을 결정할지에 대한 것입니다. Penpot에서 그릴 때는 penpot-design 외부-내부 순서를 따르세요. 다른 레이어 순서를 임의로 만들지 마세요:

  1. 화면/컨테이너 보드 (비어 있음 + flex)
  2. 직접 자식 섹션 셸 (헤더, 본문, 푸터, …)을 z-순서로 배치
  3. 각 섹션의 컴포넌트, 그 다음 해당 컴포넌트의 요소를 재귀적으로 배치

리프 요소를 먼저 만들고 감싸지 마세요. 전체 규칙: ../penpot-design/references/build-order.md.

모범 사례

  • 사용자 중심 — 사용자 목표를 위해 디자인; 페르소나와 여정 마찰 지점 고려.
  • 접근성 — 읽기 쉬운 글꼴, 충분한 대비, 색상만으로 의미 전달 금지; 관련 구조는 키보드 탐색 가능.
  • 시각적 일관성 — 하나의 스타일 가이드: 모든 화면에서 타이포그래피, 색상, 간격, 아이콘 통일.
  • 실제 환경 고려 — 화면 크기와 방향 고려; 플랫폼이 여러 기기일 경우 반응형 레이아웃.
  • 반복적 피드백 — 주관적인 다듬기보다 레이아웃, 글꼴, 색상, 흐름에 대한 실행 가능한 피드백 우선.

핵심 컴포넌트 체크리스트

각 화면 목업은 다음을 다루어야 합니다:

  • 레이아웃 및 구성 (그리드, 정렬, 계층 구조)
  • 색상 및 타이포그래피 (팔레트, 읽기 쉬운 글꼴)
  • UI 컴포넌트 및 아이콘 (CTA, 입력 필드, 내비게이션 — 컴포넌트화)
  • 이미지 및 미디어 (관련성 있고, 어수선하지 않음)
  • 브랜딩 (로고, 색상, 글꼴이 브랜드와 일관성)

함정

도전 과제대응
너무 일찍 많은 세부 사항레이아웃과 흐름이 검증될 때까지 저충실도 유지
제약 (시간, 기술, 예산)MVP 기능에 집중; 디자인 시스템 컴포넌트 재사용
이해 관계자 불일치근거 제시; 결정을 사용자 목표와 연결

심층 참고: mockup-practices.md.

완료

  • 목표, 대상 사용자, 충실도, 플랫폼, 지침 확인 완료
  • 다듬기 전 구조 먼저 (와이어프레임 → 그리드 → 토큰 → 컴포넌트 → 세부 사항)
  • 캔버스 외부-내부 (컨테이너 → 자식 셸 → 중첩 요소)
  • 사용자 중심, 접근 가능, 시각적으로 일관성
  • penpot-design에 따른 컴포넌트/변형; 내보내기 확인 완료

Individual skills in this repo

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

cucoreanu/personal-skills

Interviews the user one decision at a time about adapting an existing iPhone app to iPhone Duo and writes an adaptation decision record only after they confirm a shared understanding. Use when the user is designing or adapting an app for iPhone Duo, a folding iPhone, outer and inner displays, or side-placed controls.

cucoreanu/personal-skills

Monitor one GitHub PR for new review feedback, implement only meaningful fixes, and answer reviewers with evidence, friendly wit, and pushback on unrealistic or overly defensive comments. Use when the user asks to babysit, watch, or monitor Codex/reviewer comments on a PR.

cucoreanu/personal-skills

Agent-only. After the user asks to create a PR for a new or updated skill under skills/ (never this skill), check project install vs source with scripts/diff-install.mjs; if missing or stale, ask to install locally via relative symlinks. Use when authoring or changing skills in this repo, opening a skill PR, or finishing skill work.

cucoreanu/personal-skills

Designs UI in Penpot via MCP with component discipline, flex alignment, outside-in build order, mockup/design modes, and optional skill updates from user feedback. Use for Penpot mockups, high-fidelity designs, Penpot MCP work, or component/variant refactors in Penpot.

cucoreanu/personal-skills

Creates and reschedules macOS Reminders (fast nudges) and private Calendar events (time blocks). Attaches user-provided files to Calendar events the same way Calendar.app does. Default schedule: next free day starting tomorrow unless the user names an exact time. Never shares calendars or invites to anyone. Use when the user says \"remind me\", \"add a reminder\", \"move reminder\", \"reschedule reminder\", \"push that reminder to\", \"put this on my calendar\", \"schedule this\", \"block time\", \"don't let me forget\", or asks to attach an image/file to a reminder event.

cucoreanu/personal-skills

Proofreads messages and teaches reusable writing patterns. Use when the user pastes a work message, Slack draft, status update, or asks for proofreading, tone, clarity, grammar, flow, or constructive feedback on writing they will send at work.

관련 스킬