Communitygithub.com

Penpot モックアップ

ユーザー中心のワークフロー、忠実度レベル、6段階のプロセス、アウトサイドインのキャンバス構築により、Penpot で UI モックアップを計画・構築します。モックアップ作成、画面モックアップ、ワイヤーフレームからモックアップへの変換、ロー/ハイファイ UI、プラットフォーム固有のレイアウト、または Penpot でのモックアップデザインのベストプラクティスに使用します。

Penpot モックアップ とは?

このスキルは、Penpot で UI モックアップを効果的に設計するための体系的な方法論を提供します。ユーザー中心のアプローチに基づき、まず目標、対象ユーザー、忠実度(低/高)、プラットフォームを明確にした上で、ワイヤーフレーム、グリッドシステム、カラー&タイポグラフィ、UI コンポーネント、詳細の洗練という6段階のワークフローを順に実行します。Penpot MCP ツール(`penpot-design`)と連携し、キャンバス上では「コンテナ → 子シェル → ネストされた要素」というアウトサイドインの順序で構築することを必須とします。これにより、構造とビジュアルの一貫性を保ちながら、迅速な反復と高品質なモックアップ作成が可能になります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cucoreanu/personal-skills/tree/HEAD/skills/penpot-mockup

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Penpot モックアップ は何をしますか?

Penpot でモックアップをデザインするための方法論です。penpot-design(コンポーネント、フレックス、API、アウトサイドインツリー)と共に Penpot MCP を使用して実行します。書き込みの前に high_level_overview を一度読んでください。

最初に確認すること

以下のいずれかが不足している場合は停止します:

  1. 目標と範囲 — ウェブサイト、モバイルアプリ、デスクトップアプリ、レスポンシブのいずれですか? どの画面またはフローですか?
  2. 対象ユーザー — 誰がこれを使用しますか?(例:高齢ユーザー → 大きな文字、シンプルなナビ)
  3. 忠実度 — 低(構造、レイアウト、フロー)または 高(色、タイポグラフィ、画像、洗練)
  4. プラットフォーム — モバイル、ウェブ、デスクトップ、またはレスポンシブ。プロジェクトルールが設定されている場合はそれに従い、そうでなければ質問します。決して推測しません。
  5. 指示 — 何を構築/変更するか。頼まれた場合のみ、複数の代替案を提示します。

モックアップ vs ワイヤーフレーム vs プロトタイプ

段階目的Penpot の焦点
ワイヤーフレームレイアウト、階層、ユーザーフロー — 視覚的な仕上げは不要単純なシェイプ、プレースホルダー、実際のスペーシング
モックアップビジュアルデザイン — ルック&フィール、UI の詳細このスキル
プロトタイプインタラクティブ性 — クリック、フロー、状態ユーザーが依頼した場合のみ;状態にはバリアントを使用

特に指定がない限り、静的なビジュアルモックアップをデフォルトとします。

忠実度

低忠実度(ローファイ) — 構造とフローを迅速に検証します。単純な塗りつぶし、プレースホルダー、グリッドに揃えられたレイアウト。洗練の前にレイアウトとユーザーフローを反復します。penpot-design の mockup モードに対応します。

高忠実度(ハイファイ) — クライアント受け渡し可能、または開発者への引き渡し用。カラーパレット、タイポグラフィ、画像、ブランド化されたコンポーネント。penpot-design の design モードに対応します。

6段階のワークフロー

この順序で作業します。構造が検証される前に洗練に進まないでください。

  1. 目標と範囲の定義 — 目的、対象ユーザー、プラットフォームの制約。
  2. ワイヤーフレーム — セクション、コンテンツエリア、ナビ、CTA の概要をプレースホルダーで作成。階層とフローに焦点を当てます。
  3. グリッドシステム — 要素を揃える;一貫したスペーシング(penpot-design に従い 8dp スケール)。視覚的階層を確立(見出し > 補足テキスト)。
  4. カラーとタイポグラフィ — 限定的なパレット;読みやすい書体(サイズ、行間、文字間隔);十分なコントラスト。mockup-practices.md を参照。
  5. UI コンポーネント — ボタン、入力フィールド、ナビバー、アイコン。2回以上現れるものはコンポーネントに。状態はバリアントに。ユーザビリティのために配置とサイズが重要です。
  6. 詳細の洗練 — 画像、アイコン、スペーシング、コントラスト。export_shape で書き出して確認します。

キャンバス構築(必須)

上記の方法論は何を決定するかです。Penpot で描画する際は、penpot-design のアウトサイドインの順序に従ってください — 異なるレイヤー順序を考案しないでください:

  1. 画面/コンテナボード(空+フレックス)
  2. 直接の子セクションシェル(ヘッダー、ボディ、フッター…)を Z 順に
  3. 各セクションのコンポーネント、次にそれらのコンポーネントの要素を再帰的に

決してリーフ要素を先に作成してからラップしないでください。完全なルール:../penpot-design/references/build-order.md。

ベストプラクティス

  • ユーザー中心 — ユーザーの目標に合わせてデザインする;ペルソナとジャーニーの摩擦点を考慮する。
  • アクセシビリティ — 読みやすい書体、十分なコントラスト、色だけで意味を伝えない;該当する場合はキーボード操作可能な構造。
  • 視覚的一貫性 — 1つのスタイルガイド:すべての画面でタイポグラフィ、色、スペーシング、アイコンを統一。
  • 現実世界を考慮 — 画面サイズと向きを考慮する;プラットフォームがマルチデバイスの場合はレスポンシブレイアウト。
  • 反復的なフィードバック — 主観的な洗練よりも、レイアウト、書体、色、フローに関する実用的なフィードバックを優先する。

コアコンポーネントチェックリスト

各画面モックアップは以下に対処する必要があります:

  • レイアウトと構成(グリッド、配置、階層)
  • カラーとタイポグラフィ(パレット、読みやすい書体)
  • UI コンポーネントとアイコン(CTA、入力、ナビ — コンポーネント化)
  • 画像とメディア(関連性があり、邪魔にならない)
  • ブランディング(ロゴ、色、書体がブランドと一貫している)

陥りやすい罠

課題対応
詳細を入れすぎてしまうレイアウトとフローが検証されるまではローファイを維持する
制約(時間、技術、予算)MVP 機能に集中する;デザインシステムのコンポーネントを再利用する
ステークホルダーとの認識のずれ根拠を説明する;決定をユーザーの目標に結びつける

詳細なリファレンス:mockup-practices.md。

完了

  • 目標、対象ユーザー、忠実度、プラットフォーム、指示が確認済み
  • 構造が洗練に先行(ワイヤーフレーム → グリッド → トークン → コンポーネント → 詳細)
  • キャンバスがアウトサイドイン(コンテナ → 子シェル → ネストされた要素)
  • ユーザー中心、アクセシブル、視覚的に一貫性がある
  • penpot-design に従ったコンポーネント/バリアント;書き出し確認済み

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

Designs UI in Penpot via MCP with component discipline, flex alignment, outside-in build order, mockup/design modes, and optional skill updates from user feedback. Use for Penpot mockups, high-fidelity designs, Penpot MCP work, or component/variant refactors 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.

関連スキル