使い方ガイドへスキップ
penpot-uiux-design作者 GitHub

Penpot UI/UX Design スキル。

Claude Code と Codex の UI デザイン向けスキル: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 できること

penpot-uiux-design SkillがClaude CodeとCodexで行うこと

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

penpot/penpot-mcpサーバーを通じてPenpotで実際のインターフェースを設計するためのガイドです。エージェントがPenpotプラグインAPIを操作するデザイナーおよび開発者向けに書かれています。汎用的なアドバイスではなく、動作する手順を具体的に指定しています。MCPサーバーが既に起動しているかどうかを確認し、ファイルに既存する色、テキストスタイル、コンポーネントを発見し、penpotUtils.shapeStructureで階層を調べ、ボード、矩形、テキストを作成し、addFlexLayoutコンテナを適用します。

フォールバックとなる8pxのスペーシングとタイポグラフィのスケール、モバイル375x812とダッシュボード1440x900のレイアウト、ボタン・フォーム・ナビゲーションのチェックリスト、WCAGコントラストとタッチターゲットの制限、ボード配置のスペーシング、幅と高さが読み取り専用であるといったPenpot APIの落とし穴、analyzeDescendants、fontSizeフィルタリング、export_shapeによる検証を提供します。

生成されるもの

  • プラグインコンテキストで実行されるJavaScriptによって作成された、新規または変更済みのPenpotデザインです。
  • 推測ではなくデザインを実際に確認するために使用される、選択したシェイプのPNGまたはSVGレンダリングです。
  • ハンドオフ用に、子要素を含む選択範囲から抽出されたCSSです。
プロンプト例を見る ↗

仕組み

  1. 01
    サーバーが起動していることを確認する

    最初のステップはpenpot_api_infoへの試行呼び出しであり、接続が既に機能している場合にインストール手順を案内されることがないようにしています。

  2. 02
    既存のデザインシステムを見つける

    描画を始める前に、ブランドガイドラインについて確認し、既に使用されているコンポーネント、色、パターンを現在のファイルから読み取ります。

  3. 03
    ページ構造を調べる

    shapeStructureは既存の階層を返すため、新しい要素をキャンバス上の既存要素との関係で配置できます。

  4. 04
    要素を作成する

    ボード、矩形、テキストは、文章で説明されるのではなく、Penpotプラグインコンテキスト内のプラグイン呼び出しによって作成されます。

  5. 05
    エクスポートして検証する

    すべての変更はエクスポートで終わります。これにより結果は画像として確認され、コードだけを信用することはありません。

02 適合性を確認

penpot-uiux-design スキルを使用するタイミング

この種の UI デザインが仕事の場合、Claude Code または Codex で penpot-uiux-design スキルを使用してください。適合性と制限は、スキル自身のファイルから取得されています。

適している場合

  • 新しいWeb、モバイル、デスクトップのインターフェースを立ち上げ、実際のPenpotファイルとして構築したい方。
  • プロダクト全体で再利用されるコンポーネントライブラリとデザイントークンを構築する場合。
  • ダッシュボード、フォーム、ナビゲーション、ランディングページなど、一般的なプロダクト画面を作成する場合。
  • ゼロから始めるのではなく、既存のPenpotファイルを監査または改善する場合。
  • iOS、Android、Material Designの規約に従う必要がある作業。

境界を知る

  • 単独では動作しません。ローカルのMCPサーバーが起動しており、Penpotプラグインの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ではpenpot-uiux-designをそのSKILL.mdリンクからインポートします: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 GitHub スナップショットは 2026-09-14 に、このカタログ内の 6 つのスキルを含む github/awesome-copilot リポジトリ全体に対して取得されました。penpot-uiux-design の評価や使用回数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

SKILL.md の中身

  1. 利用可能なMCPツール4つの用途別ツール:コードの実行、シェイプのエクスポート、画像のインポート、Penpot APIドキュメントの取得。
  2. MCPサーバーのセットアップまず稼働状況を確認し、クローン、ビルド、プラグインURLの読み込み、VS Codeの設定、トラブルシューティングを行います。
  3. コアデザイン原則明確さと一貫性のための基本原則と、5段階のビジュアル階層優先順位。
  4. デザインワークフローデザインシステムの確認から検査、作成、フレックスレイアウト、ビジュアル検証までの順序立てられたステップ。
  5. デザインシステムの扱い方トークン、カラー、テキストスタイル、コンポーネントについて質問または発見し、その回答に応じて分岐します。
  6. Penpot APIの主な注意点読み取り専用のジオメトリ、z順序のためのinsertChild、反転したフレックス順序、テキストリサイズ後のgrowTypeリセット。
  7. 新規ボードの配置既存のボードを見つけ、最も右端から次のxを計算し、フローを視覚的にグループ化した状態を保ちます。
  8. デフォルトデザイントークンシステムのないデザインのための、フォールバックの8pxスペーシングスケール、タイポグラフィスケール、セマンティックなカラーロール。
  9. コンポーネントチェックリストボタン、フォーム、ナビゲーションに関するチェックボックス要件で、状態、サイズ、ラベルをカバーします。
  10. アクセシビリティのクイックチェック6つのチェック:コントラスト、タッチターゲット、フォーカス、alt テキスト、見出しの階層、色に依存しない設計。
  11. デザインレビューチェックリスト階層、スペーシング、タイポグラフィ、WCAG AA、状態、システムの一貫性に関する最終確認前のチェック。
  12. デザインの検証検証方法の表と、generateStyleを使った選択範囲からのCSSエクスポート。
スキル自身による説明
MCP ツールを使用して Penpot でプロフェッショナルな UI/UX デザインを作成するための包括的ガイド。次の場合にこのスキルを使用してください:(1)Web、モバイル、またはデスクトップアプリケーション向けの新しい 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 で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

  • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
  • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
  • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
無料ダウンロード

macOS と Windows に対応