Communitygithub.com

펜팟 디자인 (Penpot Design)

MCP를 통해 Penpot에서 UI를 디자인합니다. 컴포넌트 규율, 플렉스 정렬, 외부-내부 빌드 순서, 목업/디자인 모드를 지원하며, 사용자 피드백에 따른 선택적 스킬 업데이트가 가능합니다. Penpot 목업, 고충실도 디자인, Penpot MCP 작업, 컴포넌트/변형 리팩터에 사용하세요.

펜팟 디자인 (Penpot Design)란 무엇인가요?

이 스킬은 Penpot MCP를 통한 UI 디자인 워크플로우를 안내하는 전문 프롬프트입니다. 주로 Penpot MCP 환경에서만 작동하며, 요청이 없는 한 HTML/CSS를 병행하지 않습니다. 디자이너와 개발자 모두가 일관된 컴포넌트 규율(중복 시 컴포넌트화, 상태에 따른 변형 사용)과 레이아웃 규칙(플렉스/그리드, 8dp 스케일, Material 정렬 가이드라인)을 따르도록 돕습니다. 또한 외부-내부(Outside-In) 빌드 순서를 강제하여 컨테이너부터 자식 요소로 점진적으로 구조를 완성해 나가며, 목업(저충실도)과 디자인(고충실도) 두 가지 모드를 지원합니다. 피드백이 일반적인 규칙으로 가치 있다고 판단되면 스킬 자체에 반영할 수 있는 확장성 메커니즘도 제공합니다. 이 스킬은 Claude Code, Cursor, Codex 등 Penpot MCP와 연동되는 모든 AI 어시스턴트에서 사용할 수 있습니다.

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

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

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

문서

Penpot 디자인

Penpot MCP 전용 — 별도 요청이 없는 한 HTML/CSS를 병행하지 않습니다. high_level_overview를 한 번 읽고, 포커스된 페이지를 검사한 후(shapeStructure, components/tokens) 쓰기 작업을 수행하세요.

먼저 물어볼 것

  1. 모드: mockup 또는 design?
  2. 지침: 무엇을 만들거나 변경할지. 요청이 있을 때만 여러 변형 대안을 제시합니다.
  3. 플랫폼: 프로젝트 규칙이 설정되어 있으면 이를 사용하고, 그렇지 않으면 질문합니다. iOS/Android/web을 절대 추측하지 마세요.

위 중 하나라도 누락되면 중단합니다.

모드

Mockup — 저충실도 검증: 구조, 계층, 흐름; 단순한 채우기, 실제 간격; 요청이 없으면 다듬지 않음.

Design — 고충실도: 토큰, 타이포그래피, 상태, 크롬. 동일한 컴포넌트/플렉스 규칙을 따릅니다. 재구축보다는 그룹화 → 컴포넌트화 → 정제를 선호합니다.

규칙

컴포넌트: 두 번 이상 나타나면 → 컴포넌트/인스턴스. 동일한 기반에 다른 상태 → 변형(Active, State, Size, …). 메인에서 구조 설정; 복사본에서 재정의; 포크 시에만 detach(). 이름: Toolbar/Button; 레이어: background, icon, label (변형 간 안정적). 깊이 ≤ 4; 메인 안에 메인 없음.

레이아웃: 플렉스/그리드; 자식이 있으면 penpotUtils.addFlexLayout 사용. 간격: 8dp 스케일 (반 단위 4). 컨트롤: material-alignment.md. 활성 = 변형/스타일, 레이아웃 이동 금지. Z-순서: 배경 → 콘텐츠 → 오버레이.

빌드 트리: 외부-내부만 — 컨테이너(빈 상태 + 플렉스) → 직접 자식 셸(Z-순서) → 각 자식 요소로 재귀. 기존 리프를 감싸지 마세요. 자세한 내용: build-order.md.

프로세스: 라이브러리: 토큰 → 원자 → 변형. 그런 다음 빌드 트리로 화면 조립. 기존 작업: 그룹화 → createComponent → 중복을 인스턴스로 대체. export_shape로 확인. 대규모 재작성 전에 계획을 세우세요.

API: penpot-api.md. 심층 분석: 저장소 research/penpot-design-practices.md.

확장성

피드백이 프로젝트별이 아닌 일반적인 Penpot 규칙이 될 수 있다면, *"작업을 마친 후 penpot-design에 추가할까요?"*라고 질문하세요.

  • 예: 작업 중에 문구를 기록하고, 작업 완료 후 personal-skills/skills/penpot-design/를 편집한 후 재설치:
    npx skills add cucoreanu/personal-skills --skill penpot-design
    
    그런 다음 변경된 내용을 확인합니다.
  • 아니오: 세션 전용. 사용자가 지금 요청하지 않는 한 작업 중에 스킬을 편집하지 마세요.

완료

  • 모드, 지침, 플랫폼(필요시) 확인됨
  • 중복은 컴포넌트, 상태는 변형
  • 플렉스/그리드 + Material 기반 컨트롤 정렬
  • 캔버스가 외부-내부로 구축됨 (컨테이너 → 자식 셸 → 중첩 요소)
  • 모드에 따라 Mockup 저충실도 / 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

Plans and builds UI mockups in Penpot with user-centered workflow, fidelity levels, a six-step process, and outside-in canvas assembly. Use when creating mockups, screen mockups, wireframe-to-mockup work, low/high-fidelity UI, platform-specific layouts, or mockup design best practices 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.

관련 스킬