Communityコーディング&開発github.com

cbrock84/interface-craft

インターフェースの視覚的・インタラクティブな品質を高めます。レイアウト、階層、タイポグラフィ、スペーシング、密度、そして製品を一般的なものから際立たせる細部に焦点を当てます。画面が機能はするものの未完成または標準的に見える場合、レイアウトが混雑または恣意的に感じられる場合、ページに明確な焦点がない場合、またはインターフェースに信頼性を持たせたい場合に使用します。

interface-craft とは?

## 概要 `cbrock84/interface-craft` は、インターフェースの視覚的・インタラクティブな品質を向上させるためのAIエージェントスキルです。このスキルは、レイアウト、階層構造、タイポグラフィ、スペーシング、密度など、完成品とプロトタイプを分ける細部に焦点を当てます。特に、画面が「機能するが未完成に見える」場合や「レイアウトが混雑・恣意的に感じられる」場合に有効です。 ## 主な機能 - **診断ファースト**: 再スタイリングの前に画面の目的(主要アクション)を明確にするよう促します。 - **品質の定義**: 階層(サイズ・ウェイト・スペースを優先)、スペーシングのリズム(近接性)、タイポグラフィ(1~2ファミリー、実用的なスケール)、表面の抑制(ボーダー・シャドウ・塗りは1つまで)、整列を重視します。 - **密度の決定**: 情報密度の高いツールとマーケティングページで異なるアプローチを明確にします。 - **状態の完成**: ローディング、空、エラー、オーバーフロー状態の処理を徹底します。 - **ダークモード**: パレットとして定義(反転ではない)。背景に純黒ではなく濃いグレー、テキストに純白ではなく少し暗い白を使用し、彩度を下げたアクセントカラーを推奨します。 - **アクセシビリティの基盤**: テキストコントラスト比の遵守、色だけに依存しない情報伝達、キーボード操作の保証、タッチターゲットの十分なサイズ、アニメーション設定の尊重、適切なセマンティック要素の使用を必須とします。 - **禁止事項**: 階層問題を視覚的重みで解決しない(削除する)、本文を中央寄せしない、ホバー状態にはフォーカス状態を必ず実装します。 ## 利用方法 このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)のスキル定義として使用できます。SKILL.md に記載されたガイドラインに従い、エージェントはインターフェースの改善提案を詳細に行います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/interface-craft

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

ドキュメント

インターフェースクラフト

ほとんどのインターフェースはアイデアではなく実行で失敗します—ほぼ一貫したスペーシング、 ほぼ明確な階層、ほぼ適切なタイポグラフィ。

再スタイリング前の診断

画面が何のためなのかを問いかけてください。1つのプライマリアクション、多くても1つのセカンダリアクションです。プライマリアクションを名付けられない場合、レイアウトの問題は製品の問題であり、スタイリングでは修正できません。

実際に品質として伝わる要素

階層。 視聴者が何も読む前にどこを見ればよいかがわかる必要があります。サイズ、ウェイト、スペースの順で実現します。色は最も弱い階層ツールであり、最も過剰に使用されています。

スペーシングのリズム。 関連するものは関連しないものよりも近くに配置し、間隔は1つのスケールから取ります。一貫性のないスペーシングは、人々が感じるが名前を付けられない欠陥です。近接性を正しくすれば、シンプルなレイアウトでもデザインされたように見えます。

タイポグラフィ。 インターフェースには1ファミリー、ページ全体で多くても2ファミリーまで。実際のスケールを設定し、そのステップを使用してサイズを発明しないでください。本文テキストは快適な文字数(おおよそ60~75文字)と、行幅が広がるにつれて大きくなる行間が必要です。

表面の抑制。 ボーダー、シャドウ、塗りはすべて要素を分離します。境界1つにつき1つだけを選びます。3つすべてを重ねると、通常の密度でインターフェースがごちゃごちゃして見えます。

整列。 すべての要素が何かと揃っています。何にも揃っていない要素は、意図的であっても間違いのように見えます。

密度は意思決定

情報密度の高いツールとマーケティングページでは、逆の扱いが必要です。これがどちらかを決定し、それにコミットしてください—データテーブルにランディングページのパディングが適用された、どちらでもない中途半端な状態はどちらにも役立ちません。

状態を完成させる

ローディング、空、エラー、オーバーフローは製品が未完成に感じられる箇所です。空の状態はデザインのチャンスです。コンテキストのないスピナーは欠陥の表明です。長い文字列、長いリスト、小さな画面はすべて処理される必要があり、願望で済ませてはいけません。

ダークモードはパレットであり、反転ではない

ライトテーマを反転させると、特徴的な悪いダークモードが生まれます:純粋な黒の背景、純粋な白のテキスト、何も効果のないシャドウ。

  • 純粋な黒ではなく非常に濃いグレーを使用し、純粋な白ではなくやや暗い白を使用します。両者の最大コントラストはハレーションを引き起こし、読むのが本当に疲れます。
  • 高低差は逆転します:ライトテーマでは浮き上がった面に影が落ちますが、ダークテーマでは明るくなります。影だけでは暗い地面では何も伝えません。
  • 白で機能した彩度の高い色は、暗い背景で振動します。アクセントカラーを再利用するのではなく、ダークパレット用に彩度を下げて明るくします。
  • 両方のパレットをトークンレベルで最初から一緒に定義します。後付けで追加するにはすべての面を監査する必要があります。

アクセシビリティの基準

これらは洗練項目ではありません—これらを下回ると、一部のユーザーはインターフェースをまったく使用できません。

  • テキストのコントラストが、実際の背景(画像上のテキストや色付きボタン内部も含む)に対して標準の比率を満たしていること。
  • 色だけで意味を伝えないこと。エラーを示す赤いボーダーには、テキストやアイコンも必要です。
  • すべてのインタラクティブ要素がキーボードで操作可能であり、適切な順序で、可視のフォーカス状態を持つこと。
  • タッチターゲットが確実にヒットできる十分なサイズであり、隣接するターゲットとの間に間隔があること。
  • prefers-reduced-motion 設定を尊重すること:無効にできないアニメーションは一部のユーザーに実際の症状を引き起こします。
  • 実際のセマンティック要素を使用すること:ボタンはボタン、見出しは順序通りに。スタイル付きのdivは支援技術からは見えません。

禁止事項

  • 同じ重みの要素が多すぎるために生じた階層問題を、視覚的な重みを追加して解決しないこと。代わりに削除すること。
  • 本文テキストを中央寄せにしないこと。
  • 対応するフォーカス状態なしにホバー状態をリリースしないこと。

Individual skills in this repo

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

cbrock84/org-design

Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the strategy. Use this to structure a new team, restructure an existing one, resolve unclear ownership between teams, plan headcount, or diagnose why a team underperforms for structural rather than individual reasons.

cbrock84/portfolio-governance

Governs the portfolio of work — intake, prioritization, stage gates, resource contention, and stopping things. Use this to set up intake and prioritization, run a stage gate, decide between competing initiatives, resolve resource contention across projects, or work out why everything is in flight and nothing is finishing.

cbrock84/product-launch

Takes something built and gets it into the market — tiering the launch to match what it actually warrants, sequencing internal readiness before external announcement, preparing sales and support to answer the questions it creates, choosing the date for a reason, and measuring adoption rather than announcement reach. Use this to plan a launch, right-size one that is consuming more than it deserves, work out why a released feature nobody uses was launched loudly, or run the weeks after launch day.

cbrock84/program-management

Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving. Use this to run a multi-team initiative, recover a program that is slipping, build a delivery plan with dependencies, structure status reporting, or diagnose why cross-team work keeps missing dates.

cbrock84/project-delivery

Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips. Use this to plan a project, build or challenge a schedule, estimate credibly, track progress meaningfully, or recover a project that is late.

cbrock84/retention

Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underneath. Use this when churn is rising or unexplained, to design a cancellation or win-back flow, to recover involuntary churn, to identify at-risk accounts before they leave, or to decide whether a retention problem is a product problem.

cbrock84/sales-enablement

Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies. Use this to create or fix sales collateral, prepare for a competitive deal, build a demo flow, document objection responses, or diagnose why a pitch is not converting.

cbrock84/tax

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Use this to work out what a new state or country obligates you to, prepare for a tax filing or audit, understand sales tax on your product, or check what a remote hire or new market triggers.

cbrock84/unit-economics

Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and the cohort behavior underneath. Use this to assess whether growth is profitable, evaluate a channel or segment, support a pricing decision, judge how fast the business can afford to grow, or diagnose why revenue growth is not producing profit.

cbrock84/video-content

Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watched. Use this to script a video, plan a series, fix retention or click-through problems, design thumbnail and title concepts, or turn written content into video. For a YouTube channel specifically — idea selection, retention teardowns, and channel-level strategy — use `youtube-producer`.

cbrock84/visual-content

Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the generation prompts where they are AI-produced. Use this to turn a written piece into a visual format, design a carousel or infographic, create social graphics, or fix visuals that are not stopping the scroll.

関連スキル