Penpot 디자인
Penpot MCP 전용 — 별도 요청이 없는 한 HTML/CSS를 병행하지 않습니다. high_level_overview를 한 번 읽고, 포커스된 페이지를 검사한 후(shapeStructure, components/tokens) 쓰기 작업을 수행하세요.
먼저 물어볼 것
- 모드:
mockup또는design? - 지침: 무엇을 만들거나 변경할지. 요청이 있을 때만 여러 변형 대안을 제시합니다.
- 플랫폼: 프로젝트 규칙이 설정되어 있으면 이를 사용하고, 그렇지 않으면 질문합니다. 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 고충실도; 내보내기 확인됨