Communitygithub.com

ulasalyesil/personal-website-v2

既存の表面層を下層の決定に対して監査し、語彙、オブジェクトの一貫性、完全性、フィードバック、階層、アクセシビリティに関する表面決定のインベントリを作成します。

personal-website-v2 とは?

このスキルは、概念モデル、ブレッドボード、ユーザーニーズなど下層で決定された内容を、実際にユーザーが体験する表面層(画面UI、音声、物理デバイス、サービス接触点)が正しく反映しているかを包括的に監査します。語彙の一致、オブジェクトの一貫性、完全性チェック、感情的なトーン、エラーメッセージの質、階層と強調、アクセシビリティの7つの側面から評価し、表面層のみで修正可能な問題と、下層を再検討すべき根本的な問題を区別します。主にパート1(監査)とパート2(決定インベントリ)で構成され、Figma、コード、プロトタイプなど様々な媒体に対応します。Claude Code、Cursor、CodexなどのAIエージェントが設計レビューやUX監査を体系的に行うためのフレームワークを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/layers-surface

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

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

ドキュメント

/layers-surface

フレームワークのコンテキストとして/layers-introが読み込まれていることを前提とします。

表面層は、下層で決定されたすべてが、実際に人が触れるもの(言葉、音、視覚、物理的なアフォーダンス、動き、フィードバック)になる場所です。これは最も媒体固有の層ですが、最初に行うべき最も重要な決定は普遍的です。つまり、表面が画面、音声インターフェース、物理デバイス、サービス接触点のいずれであっても適用されます。

表面の違反は、多くの場合、より深い問題の症状です。このスキルは、表面で修正できる問題と、下層を再検討する必要がある問題を区別します。

この層で行う必要がある決定:

  • 表面は概念モデルの語彙とオブジェクトを尊重していますか?
  • ブレッドボードのすべてのアフォーダンスが存在していますか?また、モデルに裏付けられていない表面コンテンツはありませんか?
  • 表面は、ユーザーが行っているジョブに適した感情的なレジスターを伝えていますか?
  • ユーザーは何が起こったか、何が進行中か、何が間違ったかをどのように知るのでしょうか?
  • 最も目立つものは何ですか?また、そうあるべきですか?
  • すべての情報は、それを必要とするユーザーにとってアクセス可能ですか?

方法:

方法いつ使うか
実際の媒体で直接作業する(コード、本番UI)実際のインタラクションに関する本当のフィードバックが必要なとき。モックアップでの見た目と実際の動作のギャップを回避します。
高忠実度モックアップ(Figmaなど)レイアウト、視覚的階層、視覚的形態を探るとき。特に新しいパターンやステークホルダーの調整に。
デザインシステム / コンポーネントライブラリ製品に確立されたコンポーネントとトークンがある場合。表面の決定はシステムを拡張するものでなければならず、矛盾してはなりません。
スタイルタイルレイアウトにコミットせずに早期にビジュアル言語を確立するため。初期のトーン調整にはハイファイよりも高速です。
プロトタイプインタラクションの振る舞い(遷移、フィードバックのタイミング、フロー)をテストするため。静的なモックアップでは伝えられません。
コピーファースト言語が主要なデザイン素材である場合 — メッセージング、オンボーディング、エラー状態。コンテナをデザインする前にコピーを書きましょう。

品質のシグナル — 良い表面決定の特徴:

  • すべての用語が概念モデルのユビキタス言語と一致している
  • すべてのオブジェクトがコンテキスト間で一貫した表現を持っている — 変身者でもマスクされたものでもない
  • ブレッドボードのすべてのアフォーダンスが存在している。すべての表面要素にモデルが背後にある
  • 感情的なレジスターがユーザーニーズからの感情的・社会的ジョブと一致している
  • エラーメッセージは3つのことを行う:診断(何が起こったか)、説明(なぜ)、回復(次に何をすべきか)。「問題が発生しました」は3つすべてに失敗している
  • 目立つことは重要度を反映している — フローがユーザーに気づかせたいものが際立っている
  • アクセシビリティの決定は明示的に行われており、デフォルトのままにされていない

ガイド付きセッション

このスキルには2つのパートがあります。必要なものを教えてください:

  • 監査 — 既存の表面作業を下層の決定に対して評価する(フェーズ1~5)
  • 決定インベントリ — 未解決の表面決定を整理する(フェーズ6~10)

何を持っているか説明するか、「ガイドしてください」と言って始めてください。

質問: 「このセッションの作業はどこに保存すればよいですか?」(オプションについては/layers-introを参照)

質問:

  1. どの製品または機能に取り組んでいますか?
  2. どの媒体ですか — 画面UI、音声/会話、物理、サービス接触点?
  3. 下層から何を持っていますか?概念モデル(オブジェクト+ユビキタス言語)?ブレッドボードまたはフロー?感情的・社会的ジョブを含むジョブストーリー?

パート1 — 監査

フェーズ1 — 表面のフレーミング

既存の表面作業(動作するコード、デプロイされたUI、コピー、ビジュアルデザイン)は存在しますか?それとも表面はまだ開始されていませんか?まだ開始されていない場合は、パート2に進んでください。

フェーズ2 — 語彙と言語

概念モデルからユビキタス言語のリストを取得します。デザイナーに表面のコピー(ラベル、見出し、ボタンテキスト、エラーメッセージ、通知、ヘルプテキスト)を共有してもらいます。

すべての用語を確認します。フラグ:

  • 直接的な違反 — モデル用語が誤ってまたは一貫性なく使用されている(ある場所では「アカウント」、別の場所では「ワークスペース」)
  • リストにない用語 — 表面にあるがユビキタス言語にない単語。モデルに追加する新しい用語か、表面的なノイズか?
  • トーンの不一致 — 技術的には正しいが、感情的・社会的ジョブに対してトーンが間違っている

各違反に対して: 表面修正(コピーの書き直し)か、より深い修正(概念モデルの語彙の更新)か?

フェーズ3 — オブジェクトの一貫性

概念モデルの各オブジェクトについて: 表面のどこに現れますか?いくつの形式で現れますか?

  • 変身者 — 同じオブジェクトがコンテキストによって大幅に異なる視覚的または構造的形式で現れる
  • マスクされたオブジェクト — オブジェクトが、ユーザーがそのオブジェクトタイプとして認識できない形式で現れる

それぞれについて: これは表面の決定(一貫した扱いを確立する)か、概念モデルの問題(モデル内でもオブジェクトのアイデンティティが不明確)か?

フェーズ4 — 完全性チェック

ブレッドボードを取得します。各場所とアフォーダンスについて:

  • ブレッドボードのすべてのアフォーダンスが表面に存在していますか?
  • 対応するブレッドボード要素のない表面コンテンツはありますか?

ブレッドボードになかった追加は、しばしばインタラクション層の決定が漏れたものです — フラグを立て、/layers-interaction-flowを再検討することを推奨します。

フェーズ5 — 感情的なレジスター

ジョブストーリー、特に感情的・社会的ジョブに戻ります。

「ユーザーはここでどのような感情的なジョブを行っていますか?単なる機能的なタスクではなく、どのように感じたいと思っていますか?」 「どのような社会的ジョブが関係していますか? — どのように見られたいと思っていますか?」

一般的な不一致:

  • 表面がユーザーのジョブ(「同僚を助ける」)よりも製品の利点(「紹介を得る」)を強調している
  • ユーザーのジョブが関係的であるときに、コピーがインタラクションを取引的にフレーミングしている
  • ユーザーが安心や自信を必要としているときに、トーンが専門的/臨床的に感じられる

パート2 — 決定インベントリ

フェーズ6 — フィードバックとエラー

各重要なアクションと状態遷移について:

  • 「ユーザーは自分のアクションが機能したことをどのように知るのですか?」
  • 「ユーザーは何かが進行中であることをどのように知るのですか?」
  • 「ユーザーは何かが間違ったこと、そしてそれについて何をすべきかをどのように知るのですか?」

エラーメッセージは、診断、説明、次に何をすべきかをユーザーに伝えなければなりません。3つすべてを満たしていないすべてのエラー状態にフラグを立てます。各ギャップに対して決定を生成します: 「[X]をユーザーに伝える方法を決定する必要があります。オプションは[Y]です。」

フェーズ7 — 階層と強調

各主要な場所について:

  • 「ユーザーがここで気づいたり行動したりする必要がある最も重要なことは何ですか?」
  • 「現在の表面はそのことを最も目立たせていますか?」
  • 「目立つべきでないものが視覚的に目立っていますか?」

これらは、媒体固有になる前に最初に行う媒体非依存の決定(何を主要にするか)です(視覚的、聴覚的、触覚的にそれを主要にする方法)。

フェーズ8 — アクセシビリティ

宣言された媒体に関連する考慮事項にフラグを立てます:

  • 画面UI: 色のコントラスト、テキストサイズ、タッチターゲット、キーボードナビゲーション、インタラクティブ要素と画像のスクリーンリーダーラベル、フローステップ間のフォーカス管理
  • 音声/会話: すべての情報が口頭で伝えられる(「左側のボタンをクリック」ではない)、視覚的なコンテキストなしでのエラー回復
  • 物理: 到達可能性、触覚による識別、様々な照明での視認性、細かい運動精度を必要としない操作

アクセシビリティ決定のリストを生成します: 「[X]が[Y]のユーザーに対してどのようにアクセス可能になるかを決定する必要があります。」

フェーズ9 — 一貫性

  • 類似したものは類似した方法で扱われていますか?(同じアクションは同じように見え振る舞う;同じオブジェクトタイプは一貫して表現されている)
  • 異なるものは異なる方法で扱われていますか?(主要 vs. 副次、破壊的 vs. 安全)
  • この表面はその媒体の慣習に従っていますか?プラットフォームの規範に違反することはコストがかかる決定です — 時には価値があり、常に意図的です。

区別: 内部の不整合(表面内で修正) vs. 慣習の違反(意図的な選択か見落とし — どちらか判断)。

フェーズ10 — 未解決の決定

まだ行うべきすべての表面決定の統合リストを生成します:

  • 最初に解決すべきクロスレイヤーの問題 — 根本が下層にあるもの。個別にリストアップ。表面が正しくなる前に、関連するスキルを再検討する必要がある。
  • 今すぐ行うべき表面決定 — 決定は何か?オプションは何か?どのような制約が適用されるか(下層、媒体、ブランド/一貫性から)?
  • 延期 — 今すぐ行う必要はないが、追跡すべきもの

完了

以下を生成:

  1. 監査結果 — 語彙の違反、マスク/変身オブジェクト、完全性のギャップ、感情的なレジスターの不一致 — それぞれ表面修正または深層の問題に分類
  2. 決定インベントリ — すべての未解決の表面決定、グループ化および優先順位付け済み
  3. クロスレイヤーの問題 — 表面が正しくなる前に下層で解決すべき事項
  4. うまくいっていること — すでに適切に行われている表面決定。改訂で失わないようにする

次のように締めくくる: 「表面はユーザーが遭遇する層です。下層で決定されたすべては、ここで尊重されるか、ここで損なわれるかのどちらかです。概念モデルまたはインタラクション構造に重要な変更があった後は、このスキルを再検討してください。」

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

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

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

関連スキル