Communitygithub.com

Penpot デザイン

コンポーネント規律、フレックス配置、外部優先ビルド順、モックアップ/デザインモード、ユーザーフィードバックによるオプションのスキル更新により、MCP 経由で Penpot の UI をデザインします。Penpot モックアップ、高忠実度デザイン、Penpot MCP 作業、または Penpot でのコンポーネント/バリアントのリファクタリングに使用します。

Penpot デザイン とは?

このスキルは、AI エージェントが Penpot デザインツール (MCP プロトコル経由) と対話するためのガイドラインとワークフローを定義します。モックアップ (低忠実度) とデザイン (高忠実度) の 2 つのモードを区別し、起動時にユーザーにモードと指示の確認を求めます。コンポーネント管理の厳格なルールを定めています。2 回以上使用される要素はコンポーネント化し、状態のバリエーションはバリアントとして表現し、命名規則やレイヤー構成を標準化します。レイアウトはフレックスボックス/グリッドを基本とし、8dp スケールのスペーシングと「マテリアルアライメント」参照ファイルに従ったコントロール配置を推奨します。ビルド順序は「外部優先」で、コンテナ→直下の子シェル→子要素の順に階層的に構築します。処理の流れは、ライブラリ (トークン→アトム→バリアント) から始め、その後画面を組み立てます。既存の作業はグループ化してからコンポーネント化し、重複をインスタンスで置き換えます。また、ユーザーフィードバックに基づいてスキル自体を拡張するメカニズムも提供し、汎用的なルールはタスク完了後にスキルファイルに追加して再インストールできます。

対応~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、コンポーネント/トークン) を検査します。

最初に確認すること

  1. モード: mockup または design?
  2. 指示: 何を構築/変更するか。複数のバリアント案は 依頼があった場合のみ 提示します。
  3. プラットフォーム: プロジェクトルールが設定されていればそれに従い、それ以外は確認します。iOS/Android/Web を推測してはいけません。

いずれかが不足している場合は停止します。

モード

Mockup — 低忠実度の検証: 構造、階層、フロー。シンプルな塗り、実際のスペーシング。依頼がない限り磨き上げは行いません。

Design — 高忠実度: トークン、タイポグラフィ、状態、クローム。同じコンポーネント/フレックスのルールに従います。再構築よりも、グループ化 → コンポーネント化 → 洗練を優先します。

ルール

コンポーネント: 2 回以上表示される → コンポーネント/インスタンス。同じ基礎で異なる状態 → バリアント (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.

関連スキル