Communitygithub.com

Penpot 設計技能

透過 MCP 在 Penpot 中設計 UI,遵循元件紀律、彈性佈局對齊、由外而內的建構順序、草稿/設計模式,並可根據使用者回饋選擇性地更新技能。適用於 Penpot 草稿、高擬真設計、Penpot MCP 工作,或 Penpot 中的元件/變體重構。

Penpot 設計技能 是什麼?

此技能藉由 MCP 協定與 Penpot 設計工具進行深度整合,為 AI 代理提供一套結構化的設計流程。其核心價值在於強制執行「元件紀律」與「由外而內」的建構順序,確保設計一致性與可維護性。技能支援兩種工作模式:「草稿模式」注重低擬真驗證,專注於結構、層次與流程;「設計模式」則提升至較高擬真度,引入設計代碼、排版、狀態與 Chrome 元素。技能內建完善的元件與變體管理規則,例如「出現兩次即建立元件」、透過變體處理不同狀態、以及穩定的圖層命名結構。此外,它還包含一個擴展機制,允許將使用者反饋中具有通用價值的規則納入技能本身,並透過簡單的 CLI 指令重新安裝,使技能持續進化。整體而言,此技能將隨意的設計工作轉變為可重複、可擴展的工程化流程,大幅提升在 Penpot 中協作與自動化設計的生產力。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/penpot-design

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Penpot 設計

僅限 Penpot MCP — 除非被要求,否則不要並行使用 HTML/CSS。先讀取一次 high_level_overview;在寫入前檢查聚焦頁面(shapeStructure、元件/代碼)。

先詢問

  1. 模式: mockup(草稿)還是 design(設計)?
  2. 指示: 要建立/更改的內容。只有在被要求時才提供多重變體方案。
  3. 平台: 如果已設定專案規則則使用;否則詢問。絕不預設 iOS/Android/web。

缺少任一項時停止。

模式

草稿 — 低擬真驗證:結構、層次、流程;簡單填色、真實間距;除非被要求,否則不做修飾。

設計 — 較高擬真度:設計代碼、排版、狀態、Chrome。遵循相同的元件/彈性佈局規則。優先選擇群組 → 元件化 → 精煉,而非重建。

規則

元件: 出現兩次 → 建立元件/實例。相同基礎,不同狀態 → 變體(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 啟發的控制項對齊
  • 畫布由外而內建構(容器 → 子層外殼 → 巢狀元素)
  • 草稿低擬真 / 設計高擬真依模式設定;已檢查匯出

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.

相關技能