Communitygithub.com

ulasalyesil/personal-website-v2

デザインインタビューを実施し、一時的なデザインラボで5つの異なるUIバリエーションを生成し、フィードバックを収集し、実装計画を立案します。ユーザーがUIデザインの選択肢を探求したり、既存のコンポーネントを再設計したり、比較するための複数のアプローチで新しいUIを作成したい場合に使用します。

personal-website-v2 とは?

このスキルは、デザインインタビュー、バリエーション生成、フィードバック収集、リファイン、プレビュー、最終決定を含む、完全なデザイン探索ワークフローを実装します。ユーザーがUIデザインの選択肢を探求したり、既存のコンポーネントを再設計したり、複数のアプローチを比較して新しいUIを作成したい場合に特に役立ちます。対応プラットフォームはClaude Codeです。 スキルの動作は以下の通りです。まず、プロジェクトのパッケージマネージャー、フレームワーク(Next.js、Viteなど)、スタイリングシステム(Tailwind CSS、MUIなど)を自動検出し、既存のデザインメモリがあれば読み込みます。次に、スコープ、ユーザー、制約などを尋ねる構造化インタビューを実施し、デザインブリーフを作成します。そして、検出されたプロジェクト固有のビジュアルスタイル(色、タイポグラフィ、間隔など)を使用して、5つの明確に異なるUIバリアントを生成する一時的なデザインラボをセットアップします。インタラクティブなフィードバックシステムにより、ユーザーは各バリアントにコメントでき、最後にユーザーが最終デザインを確認すると、一時ファイルはすべて削除され、実装計画が生成されます。キャンセルされた場合は即座にクリーンアップされ、アーティファクトは残りません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/design-lab

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

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

ドキュメント

デザインラボスキル

このスキルは、インタビュー、バリエーション生成、フィードバック収集、リファイン、プレビュー、および最終決定を含む、完全なデザイン探索ワークフローを実装します。

重要: クリーンアップ動作

処理終了時は、以下の場合に関わらず、すべての一時ファイルを削除する必要があります。

  • ユーザーが最終デザインを確認した場合 → クリーンアップ後、計画を生成
  • ユーザーが中断/キャンセルした場合 → 即座にクリーンアップ、計画は生成しない

.claude-design/ または __design_lab ルートを残してはいけません。 ユーザーが「キャンセル」「中止」「停止」「やっぱりいい」などと言った場合、確認してから一時アーティファクトをすべて削除します。


フェーズ0: 事前検出

インタビューを開始する前に、以下を自動検出します。

パッケージマネージャー

プロジェクトルートのロックファイルを確認します。

  • pnpm-lock.yaml → pnpm を使用
  • yarn.lock → yarn を使用
  • package-lock.json → npm を使用
  • bun.lockb → bun を使用

フレームワーク検出

設定ファイルを確認します。

  • next.config.js、next.config.mjs、または next.config.ts → Next.js
    • app/ ディレクトリが存在するか確認 → App Router
    • pages/ ディレクトリが存在するか確認 → Pages Router
  • vite.config.js または vite.config.ts → Vite
  • remix.config.js → Remix
  • nuxt.config.js または nuxt.config.ts → Nuxt
  • astro.config.mjs → Astro

スタイリングシステム検出

package.json の依存関係と設定ファイルを確認します。

  • tailwind.config.js または tailwind.config.ts → Tailwind CSS
  • @mui/material が依存関係にある → Material UI
  • @chakra-ui/react が依存関係にある → Chakra UI
  • antd が依存関係にある → Ant Design
  • styled-components が依存関係にある → styled-components
  • @emotion/react が依存関係にある → Emotion
  • .css または .module.css ファイル → CSS Modules

デザインメモリチェック

既存のデザインメモリファイルを探します。

  • docs/design-memory.md
  • DESIGN_MEMORY.md
  • .claude-design/design-memory.md

見つかった場合は読み取り、デフォルト値の事前入力と重複する質問のスキップに使用します。

ビジュアルスタイルの推測(重要)

汎用的または定義済みのスタイルは使用しないでください。プロジェクトからビジュアル言語を抽出します。

Tailwind が検出された場合、tailwind.config.js または tailwind.config.ts を読み取ります。

// 以下を抽出して使用:
theme.colors      // カラーパレット
theme.spacing     // スペーシングスケール
theme.borderRadius // 角丸の値
theme.fontFamily  // タイポグラフィ
theme.boxShadow   // エレベーションシステム

CSS 変数が存在する場合、globals.css、variables.css、または :root 定義を読み取ります。

:root {
  --color-*     /* カラートークン */
  --spacing-*   /* スペーシングトークン */
  --font-*      /* タイポグラフィトークン */
  --radius-*    /* 角丸トークン */
}

UI ライブラリが検出された場合(MUI、Chakra、Ant)、テーマ設定を読み取ります。

  • MUI: theme.ts または createTheme() の呼び出し
  • Chakra: theme/index.ts または extendTheme() の呼び出し
  • Ant: ConfigProvider の theme プロパティ

常に既存のコンポーネントをスキャンしてパターンを理解します。

  • 2~3個のボタンを見つける → それらのスタイリングパターンを記録
  • 2~3個のカードを見つける → パディング、ボーダー、シャドウを記録
  • 既存のフォームを見つける → 入力スタイル、ラベルの配置を記録
  • 既存のタイポグラフィを見つける → 見出しサイズ、本文テキストを記録

推測したスタイルはデザインブリーフに保存し、すべてのバリアントで一貫して使用します。


フェーズ1: インタビュー

すべてのインタビューステップで AskUserQuestion ツールを使用します。デザインメモリが存在する場合は、それに基づいて質問を調整します。

ステップ1.1: スコープとターゲット

以下の質問をします(複数の質問を1つの AskUserQuestion にまとめることができます)。

質問1: スコープ

  • ヘッダー: "スコープ"
  • 質問: "単一のコンポーネントをデザインしますか、それともページ全体をデザインしますか?"
  • 選択肢:
    • "コンポーネント" - 再利用可能なUI要素(ボタン、カード、フォーム、モーダルなど)
    • "ページ" - 完全なページまたは画面レイアウト

質問2: 新規またはリデザイン

  • ヘッダー: "タイプ"
  • 質問: "これは新しいデザインですか、それとも既存のもののリデザインですか?"
  • 選択肢:
    • "新規" - ゼロから作成する
    • "リデザイン" - 既存のコンポーネント/ページを改善する

「リデザイン」が選択された場合、以下を質問します。 質問3: 既存のパス

  • ヘッダー: "場所"
  • 質問: "既存のUIのファイルパスまたはルートは何ですか?"
  • 選択肢: (ユーザーが「その他」で入力できるようにする)

ターゲットが不明な場合、リポジトリのパターンに基づいて名前を提案し、確認を取ります。

ステップ1.2: 問題点とインスピレーション

質問1: 問題点

  • ヘッダー: "問題"
  • 質問: "現在のデザインの最大の問題点は何ですか(または、この新しいデザインで避けるべきことは何ですか)?"
  • 選択肢:
    • "情報が多すぎる/密集している" - 情報過多でスキャンしにくい
    • "階層が不明確" - 主要なアクションが明確でない
    • "モバイルでの操作性が悪い" - 小さな画面でうまく動作しない
    • "古い見た目" - ブランドと一致していない、または時代遅れ
  • multiSelect: true

質問2: ビジュアルインスピレーション

  • ヘッダー: "ビジュアルスタイル"
  • 質問: "どの製品やブランドをビジュアルインスピレーションの参考にすべきですか?"
  • 選択肢:
    • "Stripe" - クリーン、ミニマル、信頼性
    • "Linear" - 情報量が多く、キーボードファースト、デベロッパー向け
    • "Notion" - 柔軟性、コンテンツ重視、遊び心
    • "Apple" - プレミアム、余裕がある、洗練
  • multiSelect: true

質問3: 機能インスピレーション

  • ヘッダー: "インタラクション"
  • 質問: "どのようなインタラクションパターンを模倣すべきですか?"
  • 選択肢:
    • "インライン編集" - モーダルなしでその場で編集
    • "プログレッシブディスクロージャー" - 必要に応じて詳細を表示
    • "楽観的更新" - 即時フィードバック、バックグラウンドで同期
    • "キーボードショートカット" - パワーユーザーの効率性

ステップ1.3: ブランドとスタイルの方向性

質問1: ブランドを表す形容詞

  • ヘッダー: "ブランドトーン"
  • 質問: "希望するブランドの雰囲気を表す3~5つの形容詞は何ですか?"
  • 選択肢:
    • "ミニマル" - クリーン、シンプル、すっきり
    • "プレミアム" - 高級感、洗練、上品
    • "遊び心" - 楽しい、親しみやすい、取っつきやすい
    • "実用主義" - 機能的、効率的、無駄がない
  • multiSelect: true

質問2: 密度

  • ヘッダー: "密度"
  • 質問: "どの情報密度を好みますか?"
  • 選択肢:
    • "コンパクト" - より多くの情報を表示、間隔を詰める
    • "快適" - バランスの取れた間隔、スキャンしやすい
    • "ゆったり" - 余白が多く、集中しやすい

質問3: ダークモード

  • ヘッダー: "ダークモード"
  • 質問: "ダークモードは必要ですか?"
  • 選択肢:
    • "必要" - ダークモードをサポートする必要がある
    • "不要" - ライトモードのみ
    • "あれば良い" - 簡単にできるならサポート、必須ではない

ステップ1.4: ペルソナとジョブ理論

質問1: 主要ユーザー

  • ヘッダー: "ユーザー"
  • 質問: "主なエンドユーザーは誰ですか?"
  • 選択肢:
    • "開発者" - 技術的、キーボード指向
    • "デザイナー" - ビジュアル重視、細部にこだわる
    • "ビジネスユーザー" - 効率重視、技術的でない
    • "エンドコンシューマー" - 一般ユーザー、技術レベルは様々

質問2: コンテキスト

  • ヘッダー: "コンテキスト"
  • 質問: "主な使用コンテキストは何ですか?"
  • 選択肢:
    • "デスクトップ優先" - 主に大きな画面で使用
    • "モバイル優先" - 主にスマートフォンで使用
    • "両方同等" - すべてのデバイスで適切に動作する必要がある

質問3: 主要タスク

  • ヘッダー: "主要タスク"
  • 質問: "ユーザーが完了しなければならない上位3つのタスクは何ですか?"
  • (ユーザーが「その他」で入力できるようにする - 自由記述)

ステップ1.5: 制約

質問1: 保持必須要素

  • ヘッダー: "保持"
  • 質問: "保持しなければならない要素はありますか?"
  • 選択肢:
    • "既存のコピー/ラベル" - 現在のテキストを維持
    • "現在のフィールド/入力" - フォーム構造を維持
    • "ナビゲーション構造" - 現在のナビゲーションを維持
    • "なし" - すべて自由に変更

質問2: 技術的制約

  • ヘッダー: "制約"
  • 質問: "技術的な制約はありますか?"
  • 選択肢:
    • "新しい依存関係は追加しない" - 既存のライブラリのみ使用
    • "既存のコンポーネントを使用" - 現在のデザインシステムを基に構築
    • "アクセシブルである必要がある(WCAG)" - 厳格なアクセシビリティ要件
    • "なし" - 特別な制約はなし
  • multiSelect: true

フェーズ2: デザインブリーフの生成

インタビュー後、構造化されたデザインブリーフをJSONとして作成し、.claude-design/design-brief.json に保存します。

{
  "scope": "component|page",
  "isRedesign": true|false,
  "targetPath": "src/components/Example.tsx",
  "targetName": "Example",
  "painPoints": ["情報が多い", "主要アクションが不明確"],
  "inspiration": {
    "visual": ["Stripe", "Linear"],
    "functional": ["インライン検証"]
  },
  "brand": {
    "adjectives": ["ミニマル", "信頼性"],
    "density": "comfortable",
    "darkMode": true
  },
  "persona": {
    "primary": "開発者",
    "context": "desktop-first",
    "keyTasks": ["チェックアウト完了", "注文確認", "割引適用"]
  },
  "constraints": {
    "mustKeep": ["既存のフィールド"],
    "technical": ["新しい依存関係は追加しない", "WCAGアクセシブル"]
  },
  "framework": "nextjs-app",
  "packageManager": "pnpm",
  "stylingSystem": "tailwind"
}

続行する前に概要をユーザーに表示します。


フェーズ3: デザインラボの生成

ディレクトリ構造

すべてのファイルを .claude-design/ の下に作成します。

.claude-design/
├── lab/
│   ├── page.tsx                 # メインラボページ(フレームワーク固有)
│   ├── variants/
│   │   ├── VariantA.tsx
│   │   ├── VariantB.tsx
│   │   ├── VariantC.tsx
│   │   ├── VariantD.tsx
│   │   └── VariantE.tsx
│   ├── components/
│   │   └── LabShell.tsx         # ラボレイアウトラッパー
│   ├── feedback/                # インタラクティブフィードバックシステム
│   │   ├── types.ts             # TypeScriptインターフェース
│   │   ├── selector-utils.ts    # 要素識別
│   │   ├── format-utils.ts      # フィードバックフォーマット
│   │   ├── FeedbackOverlay.tsx  # メインオーバーレイコンポーネント
│   │   └── index.ts             # モジュールエクスポート
│   └── data/
│       └── fixtures.ts          # 共有モックデータ
├── design-brief.json
└── run-log.md

フィードバックシステムのセットアップ(重要 - 絶対にスキップしないでください)

FeedbackOverlay はデザインラボの主要機能です。 これがないと、ユーザーはインタラクティブなフィードバックを提供できません。FeedbackOverlay なしでデザインラボを生成しないでください。

信頼性戦略: 異なるプロジェクト設定間でのインポートパスの問題を回避するため、FeedbackOverlay は ルートディレクトリに直接(例: app/design-lab/FeedbackOverlay.tsx)、.claude-design/ の下には作成しません。これにより、単純な相対インポート(./FeedbackOverlay)が常に機能することが保証されます。

ルートディレクトリに必要なファイル:

app/design-lab/           # または app/__design_lab/(アンダースコアが機能する場合)
├── page.tsx              # バリアントを含むメインラボページ
└── FeedbackOverlay.tsx   # 自己完結型オーバーレイコンポーネント(テンプレートからコピー)

テンプレートソース: design-and-refine/templates/feedback/FeedbackOverlay.tsx

このアプローチの理由:

  • .claude-design/ のパスは、バンドラ設定によっては失敗する可能性がある
  • 同じディレクトリからの相対インポートは常に機能する
  • ルートディレクトリはクリーンアップ時に削除される

ルート統合

Next.js App Router: .claude-design/lab/ からインポートする app/__design_lab/page.tsx を作成します。

Next.js Pages Router: .claude-design/lab/ からインポートする pages/__design_lab.tsx を作成します。

Vite React:

  • React Router が存在する場合: /__design_lab へのルートを追加
  • ルーターがない場合: クエリパラメータ ?design_lab=true に基づいて App.tsx に条件付きレンダリングを作成

その他のフレームワーク: 検出されたフレームワークに最も適した一時ルートを作成します。

バリアント生成ガイドライン

重要: UX、インタラクション、モーションのベストプラクティスについては DESIGN_PRINCIPLES.md を読んでください。ただし、定義済みのビジュアルスタイルは使用しないでください。 プロジェクトから推測します。

普遍的な原則を適用します(DESIGN_PRINCIPLES.md より):

  • UX: ニールセンのヒューリスティック、認知的負荷の低減、プログレッシブディスクロージャー
  • コンポーネントの動作: ボタンの状態、フォームの構造、カードの構造
  • インタラクション: フィードバックパターン、状態処理、楽観的更新
  • モーション: タイミング(150~300ms)、イージング(イーズアウトで出現、イーズインで終了)
  • アクセシビリティ: フォーカス状態、ARIAパターン、タッチターゲット(44px以上)

プロジェクトからビジュアルスタイルを推測します:

  • 色 → Tailwind設定、CSS変数、または既存のコンポーネントから
  • タイポグラフィ → コードベース内の既存の見出し、本文から
  • 間隔 → プロジェクトの間隔スケールまたは既存のパターンから
  • 角丸 → 既存のカード、ボタン、入力から
  • シャドウ → 既存の浮揚コンポーネントから

各バリアントは異なるデザイン軸を探求する必要があります。小さなバリエーションを作成しないでください。意味的に異なるものにしてください。 すべてのバリアントに プロジェクトの既存のビジュアル言語 を使用します。

バリアントA: 情報階層重視

  • コンテンツの階層を再構築(何が最も重要か?)
  • ゲシュタルトの近接性を適用 - 関連項目を近くにグループ化
  • ビューごとに1つの主要アクション
  • 既存のタイポグラフィスケールを使用して明確なレベルを作成

バリアントB: レイアウトモデルの探求

  • 異なるレイアウトアプローチを試す(カード vs リスト vs テーブル vs 分割ペイン)
  • DESIGN_PRINCIPLES からカード構造またはテーブル動作パターンを適用
  • 各ブレークポイントでのレスポンシブ動作を検討
  • プロジェクトの既存のグリッド/レイアウトシステムを使用

バリアントC: 密度のバリエーション

  • ブリーフが「快適」の場合は、よりコンパクトなバージョンを試す
  • ブリーフが「コンパクト」の場合は、よりゆったりしたバージョンを試す
  • プロジェクトの既存の間隔トークンを使用 - 単に異なる方法で適用する
  • トレードオフを示す:表示データの多さ vs スキャンのしやすさ

バリアントD: インタラクションモデル

  • 異なるインタラクションパターン(モーダル vs インライン vs パネル vs ドロワー)
  • フィードバックパターンを適用:即時 → 進行中 → 完了
  • 必要なすべての状態を実装(ローディング、エラー、空、無効)
  • 非破壊的なアクションには楽観的更新を検討

バリアントE: 表現の方向性

  • インタビューでユーザーが説明したブランドの方向性を押し出す
  • プロジェクトの既存のデザイントークンの異なる使用方法を探る
  • シャドウ、ボーダー、背景色の使用量を増減
  • 意味を追加する場所にモーションを適用(ホバー、フォーカス、トランジション)

ラボページの要件

デザインラボページには以下を含める必要があります。

  1. ヘッダー を含む:

    • デザインブリーフの概要(ターゲット、スコープ、主要要件)
    • レビュー手順
  2. バリアントグリッド を含む:

    • 明確なラベル(A、B、C、D、E)
    • 各バリアントの簡単な根拠(「なぜこれが存在するのか」)
    • 実際にレンダリングされたバリアント

…

[翻訳のため省略]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

関連スキル