사용 가이드로 건너뛰기
penpot-uiux-design작성자 GitHub

Penpot UI/UX Design 스킬.

UI 디자인을 위한 Claude Code 및 Codex skill: MCP 도구를 통한 Penpot의 전문 UI/UX 디자인, 컴포넌트 및 디자인 시스템.

  • Web & UI
  • 디자인 파일
github/awesome-copilot · skills/penpot-uiux-design/SKILL.mdSKILL.md
--- name: penpot-uiux-design description: Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material … --- ## Available MCP Tools ## MCP Server Setup ## Core Design Principles ## Design Workflow ## Design System Handling ## Key Penpot API Gotchas
업스트림 파일에서 읽은 전문 및 섹션 제목 2026-09-14 · 전체 12,103자

01 기능

Claude Code와 Codex에서 penpot-uiux-design Skill이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

penpot/penpot-mcp 서버를 통해 Penpot에서 실제 인터페이스를 디자인하는 가이드로, 에이전트가 Penpot plugin API를 구동하는 디자이너와 개발자를 위해 작성되었습니다. 일반적인 조언 대신 실제 작업 순서를 명시합니다: MCP 서버가 이미 실행 중인지 확인하고, 파일에 이미 존재하는 색상, 텍스트 스타일, 컴포넌트를 파악하고, penpotUtils.shapeStructure로 계층 구조를 검사한 다음, board, rectangle, text를 생성하고 addFlexLayout 컨테이너를 적용합니다.

이 Skill은 대체용 8px 간격 및 타이포그래피 스케일, 모바일 375x812 및 대시보드 1440x900 레이아웃, 버튼·폼·내비게이션 체크리스트, WCAG 대비 및 터치 타깃 한도, board 배치 간격, width와 height가 읽기 전용인 것과 같은 Penpot API 함정, analyzeDescendants·fontSize 필터링·export_shape을 통한 검증을 제공합니다.

산출물

  • plugin 컨텍스트에서 실행된 JavaScript로 생성된 새로운 또는 수정된 Penpot 디자인입니다.
  • 추측하지 않고 디자인을 직접 확인하기 위해 사용하는, 선택한 shape의 PNG 또는 SVG 렌더입니다.
  • 핸드오프를 위해 자식 요소를 포함하여 선택 항목에서 추출한 CSS입니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    서버 실행 여부 확인

    첫 단계는 penpot_api_info에 시험 호출을 해보는 것으로, 연결이 이미 작동 중인데 설치 과정을 다시 안내받는 일이 없도록 합니다.

  2. 02
    기존 디자인 시스템 찾기

    그림을 그리기 전에 브랜드 가이드라인에 대해 질문하고, 이미 사용 중인 컴포넌트, 색상, 패턴을 파악하기 위해 현재 파일을 읽습니다.

  3. 03
    페이지 구조 검사

    shapeStructure는 기존 계층 구조를 반환하므로, 새 요소를 캔버스에 이미 있는 것과 상대적으로 배치할 수 있습니다.

  4. 04
    요소 생성

    Board, rectangle, text는 서술로 설명되는 것이 아니라 Penpot plugin 컨텍스트에서의 plugin 호출을 통해 만들어집니다.

  5. 05
    내보내기로 검증

    모든 변경은 내보내기로 마무리되어, 결과를 코드만 믿는 것이 아니라 이미지로 직접 확인합니다.

02 적합성 확인

penpot-uiux-design 스킬을 사용할 때

이런 종류의 UI 디자인 작업에는 Claude Code 또는 Codex에서 penpot-uiux-design 스킬을 사용하십시오. 적합성과 한계는 스킬 자체 파일에서 가져온 것입니다.

적합한 경우

  • 새로운 웹, 모바일 또는 데스크톱 인터페이스를 시작하며 실제 Penpot 파일로 만들고자 하는 사람.
  • 전체 제품이 재사용할 컴포넌트 라이브러리와 디자인 토큰을 구축하는 작업.
  • 대시보드, 폼, 내비게이션, 랜딩 페이지와 같은 일반적인 제품 화면을 제작하는 작업.
  • 처음부터 시작하는 대신 이미 존재하는 Penpot 파일을 점검하거나 개선하는 작업.
  • iOS, Android 또는 Material Design 규칙을 따라야 하는 작업.

한계 인지하기

  • 이 Skill은 단독으로 실행될 수 없습니다: 로컬 MCP 서버가 실행 중이고 Penpot plugin UI가 연결된 상태로 표시되어야 하며, 그렇지 않으면 호출이 실패하거나 시간 초과됩니다.
  • 이는 penpot-mcp 서버를 통해 만들어진 Penpot 디자인에 한정되며, 다른 디자인 도구에는 적용되지 않습니다.
  • 체크리스트를 통과하는 것이 디자인이 실제로 작동한다는 증명은 아닙니다. 이 파일은 여전히 실제 사용자와 함께 가정을 검증해 볼 것을 요구합니다.

제공할 사항

  • 기존 디자인 시스템 또는 브랜드 가이드라인(있는 경우)토큰과 스펙을 에이전트에게 직접 알려주거나, 작업을 시작하기 전에 현재 파일에서 이를 발견하도록 두십시오.
  • 아이콘, 사진 또는 로고비주얼 에셋은 이미지 가져오기 도구를 통해 디자인에 반영됩니다.

03 스킬 내부

penpot-uiux-design 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 설치 전에 서버를 먼저 확인합니다

    먼저 도구 호출을 시도하고, 사용자가 서버가 설치되어 있지 않음을 확인해 준 경우에만 설정 절차를 진행합니다.

  2. 보드를 다른 보드 위에 겹쳐 그리지 않습니다

    보드를 생성하기 전에 기존 보드 목록을 확인하고, 새 보드는 가장 오른쪽 끝에서 간격을 두고 배치합니다. 같은 흐름 내 화면 사이에는 100px, 다른 섹션 사이에는 200px 이상을 둡니다.

  3. 속성이 아닌 메서드를 통해 크기를 조정합니다

    width와 height는 읽기 전용이므로, 크기 변경은 직접 대입이 아니라 shape.resize(w, h)를 통해 이루어집니다.

  4. insertChild로 레이어를 쌓습니다

    z-순서는 insertChild(index, shape)를 사용하며, appendChild는 레이어 순서를 지정하는 방법으로 명시적으로 배제됩니다.

  5. 기본 토큰은 대체 수단일 뿐입니다

    사용자에게 디자인 시스템이 있는 경우 그들의 색상, 여백, 타이포그래피가 우선하며, 내장 스케일은 그런 것이 없을 때만 적용됩니다.

  6. 접근성 기준을 지킵니다

    본문 텍스트의 명암비는 4.5:1, 큰 텍스트는 3:1을 유지하며, 터치 타깃은 44x44px 미만으로 내려가지 않습니다.

  7. 팔레트와 서체를 제한합니다

    주 색상 1개와 보조 색상 1개, 중립색을 사용하고, 디자인 전체에서 서체는 1~2개를 넘지 않도록 합니다.

  8. 크기 조정 후 텍스트 그로우 타입을 초기화합니다

    Penpot는 크기 조정 시 텍스트 크기 조정 동작을 재설정하므로, growType을 auto-width 또는 auto-height로 다시 설정해야 합니다.

04 활용하기

Claude Code 또는 Codex에 penpot-uiux-design 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 귀하의 에이전트에 penpot-uiux-design 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/github/awesome-copilot --skill penpot-uiux-design

skills/penpot-uiux-design/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소에서 자체 경로를 문서화할 수도 있습니다.

스킬에 첫 UI 디자인 작업 부여하기

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
Design a settings screen for [app name] in Penpot on a 375x812 board. Follow the Material Design guidelines and use our existing tokens if the file already has them, otherwise use the 8px spacing scale. It needs a header, a form with labels above the inputs plus error states, and a bottom CTA. Export the screen when you are done so I can check the contrast.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • 모든 요소가 컨테이너 내부에 위치하는지 analyzeDescendants와 isContainedIn을 결합하여 검증합니다.
  • fontSize를 기준으로 모양을 필터링하여 12px 미만인 텍스트가 없는지 확인합니다.
  • 디자인이 최종본으로 확정되기 전에 색상 대비가 WCAG AA를 충족해야 합니다.
  • 중첩 구조와 계층은 shapeStructure로 검토됩니다.
  • 본문 타이포그래피는 16px 이상을 유지합니다.
  • 로딩, 빈 상태, 오류 상태까지 고려하며, 정상 흐름만 다루지 않습니다.

OpenDesign에서 SKILL.md 링크로 penpot-uiux-design을 가져옵니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Author
GitHub
Repository
github.com/github/awesome-copilot 브랜치 main
스킬 파일
skills/penpot-uiux-design/SKILL.md 검증 시 기록된 콘텐츠 체크섬; 커밋 1899b18
License
MIT LICENSE에서 확인
리포지토리 스타
38,981 이 카탈로그에 6개의 스킬이 포함된 github/awesome-copilot 저장소 전체에 대해 2026-09-14에 촬영한 GitHub 스냅샷입니다. penpot-uiux-design의 평가 또는 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 사용 가능한 MCP 도구목적별 네 가지 도구: 코드 실행, 셰이프 내보내기, 이미지 가져오기, Penpot API 문서 조회.
  2. MCP 서버 설정먼저 실행 중인지 확인한 다음, 클론하고 빌드하고 플러그인 URL을 로드하고 VS Code를 설정하고 문제를 해결합니다.
  3. 핵심 디자인 원칙명료성과 일관성을 위한 황금 규칙, 그리고 5단계 시각적 계층 우선순위.
  4. 디자인 워크플로우디자인 시스템 확인부터 검사, 생성, flex 레이아웃, 시각적 검증까지 순서에 따른 단계.
  5. 디자인 시스템 처리토큰, 색상, 텍스트 스타일, 컴포넌트에 대해 질문하거나 파악한 뒤 답변에 따라 분기합니다.
  6. Penpot API 주요 주의점읽기 전용 지오메트리, z-순서를 위한 insertChild, 역순 flex 순서, 텍스트 크기 조정 후 growType 재설정.
  7. 새 보드 위치 지정기존 보드를 찾고, 가장 오른쪽 가장자리를 기준으로 다음 x를 계산하며, 플로우를 시각적으로 그룹화된 상태로 유지합니다.
  8. 기본 디자인 토큰시스템이 없는 디자인을 위한 8px 간격 스케일, 타이포그래피 스케일, 시맨틱 색상 역할의 기본값.
  9. 컴포넌트 체크리스트버튼, 폼, 내비게이션에 대한 체크박스 요구 사항으로, 상태, 크기, 레이블을 다룹니다.
  10. 접근성 간이 점검여섯 가지 점검: 대비, 터치 타깃, 포커스, 대체 텍스트, 제목 계층, 색상 독립성.
  11. 디자인 검토 체크리스트최종본 확정 전 계층, 여백, 타이포그래피, WCAG AA, 상태, 시스템 일관성에 대한 점검.
  12. 디자인 검증검증 방법 표와 generateStyle을 이용해 선택 영역에서 CSS를 내보내는 방법.
스킬 자체 설명
"MCP 도구를 사용하여 Penpot에서 전문적인 UI/UX 디자인을 생성하기 위한 종합 가이드입니다. 다음의 경우 이 스킬을 사용하십시오: (1) 웹, 모바일 또는 데스크톱 애플리케이션을 위한 새로운 UI/UX 디자인 생성, (2) 컴포넌트와 토큰을 사용한 디자인 시스템 구축, (3) 대시보드, 폼, 내비게이션 또는 랜딩 페이지 디자인, (4) 접근성 표준 및 모범 사례 적용, (5) 플랫폼 가이드라인(iOS, Android, Material Design) 준수, (6) 사용성을 위한 기존 Penpot 디자인 검토 또는 개선. 트리거: "UI 디자인", "인터페이스 생성", "레이아웃 구축", "대시보드 디자인", "폼 생성", "랜딩 페이지 디자인", "접근성 확보", "디자인 시스템", "컴포넌트 라이브러리"."

SKILL.md의 프론트매터 설명입니다. 전체 파일은 약 12,103자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

penpot-uiux-design 스킬에 대한 질문

이 답변은 2026-09-14 기준으로 확인한 SKILL.md 내용을 근거로 하며, 실행 기록을 바탕으로 한 것이 아닙니다.

이것을 사용하기 전에 Penpot MCP 서버를 설치해야 합니까?

아니요. 이 스킬은 penpot_api_info를 호출해 먼저 의도적으로 확인합니다. 서버가 설치되어 있지 않다는 것을 확인한 경우에만 설치 단계를 안내하며, 이후 설정 과정에서 penpot-mcp를 클론하고 npm install과 npm run bootstrap을 실행한 다음 Penpot에서 http://localhost:4400/manifest.json 의 플러그인을 로드합니다.

어떤 클라이언트를 설정합니까?

설정 섹션에는 http://localhost:4401/sse 에 penpot 서버를 등록하는 VS Code settings.json 스니펫이 나와 있습니다. 또한 설정을 변경한 후 VS Code나 Claude를 완전히 재시작하기 전까지는 도구가 나타나지 않을 수 있다는 경고도 포함되어 있습니다.

Penpot UI/UX Design

실제 UI 디자인 작업에서 penpot-uiux-design을 실행합니다.

OpenDesign을 다운로드하고 SKILL.md 링크에서 penpot-uiux-design을 가져온 다음, 위 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/github/awesome-copilot --skill penpot-uiux-design

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원