Communitygithub.com

ハローデザインスキル

ハローは、落ち着いた光沢感と数値優先のデザインシステムです。あらゆるWebアプリ、ダッシュボード、ツール、ランディングページ、ベクターPDFに対応し、英語とクルド語(ソラニ方言)または任意のRTL文字を自然に共存させるバイリンガル設計が特徴です。

ハローデザインスキル とは?

ハローデザインスキルは、AIエージェント(Claude Code、Cursor、Codexなど)に、一貫性と表現力を両立したWeb UIデザインシステムの実装力を与えます。このスキルの核心は「テーマをコピーするテンプレート」ではなく、プロダクトごとに独自の個性(シグネチャービジュアル、アクセントの意味付け、イラスト、コピー、サウンド)を引き出す「設計方法」を提供することです。 スキルはまず設計ブリーフを作成し、プロダクトに合ったシグネチャービジュアルを選択するよう指示します(例:リング、スパークライン、メーター、棒グラフなど)。その後、トークン(トークンCSSのみが色・カーブ・半径の唯一の情報源)、タイポグラフィ(Google Sans + IBM Plex Sans Arabic)、レイアウト(docs/04, docs/07)、コンポーネント(docs/05)、モーション(控えめで1回のみ、ループなし)、RTL対応(クルド語、アラビア語、ペルシア語)、QA(9幅×2テーマ×2言語)の各ドキュメントを参照してページを構築します。 対応プラットフォームはHTML/CSS/JS(生のスターターテンプレート、ダッシュボードテンプレート、印刷用A4テンプレート)ですが、React、Next.js、Tailwind、Vue向けのガイド(docs/17)も用意されています。このスキルは、プロダクトに合わせた設計を徹底し、既存コンテンツのコピーを禁止し、QA合格をもって完成とする厳格なルールをエージェントに課すことで、高品質で独自性のあるUIを生成します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SawabS/halo-design-skill/tree/HEAD

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

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

ドキュメント

ハローデザインスキル は何をしますか?

ハローは設計の方法であり、コピーするテーマではありません。文法(トークン、タイポグラフィ、モーション、アクセシビリティ、バイリンガルレイアウト、QA)を固定し、プロダクトの個性(シグネチャービジュアル、アクセントの意味、イラスト、コピー、サウンド)はあなたに委ねます。examples/ にあるワークアウトプランと2つのテンプレートはメカニクスのデモであり、再利用するためのコンテンツではありません。

基本ルール

  1. プロダクトごとにデザインする。 まずブリーフ(templates/brief.md)を書き、このプロダクトに合ったシグネチャービジュアルを選ぶ(docs/00-creative-direction.md)。リング、エクササイズピクトグラム、ワークアウトコピーは、プロダクトが「一日の目標を達成する」ことをテーマにしている場合にのみ使用する。
  2. プラットフォーム → ハロー → 実績のあるライブラリ。メカニズムを発明してはならない( docs/16-libraries.md)。
  3. トークンが色・曲線・半径の唯一の情報源である。 tokens/tokens.css の外にカラーリテラルを記述してはならない。scripts/check_skill.py がハローのCSSに対してこれを強制する。
  4. 両方のテーマ、両方の方向、すべてのブレイクポイント を設計しテストする。
  5. 数値優先: 灰色ラベル → 大きなアクセント値 → 平易な文。ビジュアルは数値を繰り返し、決して置き換えない。
  6. モーションは控えめに: 1つのカーブ、1回だけ表示、ループなし、動きを減らす設定に安全。ライブデータはその場で更新され、決してアニメーションを再実行しない。
  7. ロゴは使わない。 ブランドスロットはプロダクト名のテキスト。ユーザーが提供した場合にのみマークを使用する。
  8. 完了=QA合格( docs/13-qa.md)。

タスクに必要なものだけ読む

ドキュメントはそれぞれ短い(各1,500トークン未満)。すべてを読む必要はなく、タスクに応じてルーティングする:

タスク読むドキュメント開始点
新しいプロダクトまたはページdocs/00, docs/02, docs/03, docs/05templates/starter.html(個人向けアプリ)または templates/dashboard.html(データ/運用)
データ量の多い画面docs/10, docs/04templates/dashboard.html
クルド語/アラビア語/ペルシア語docs/08, docs/03どちらかのテンプレート、lang=ckb を設定
電話向け調整docs/07—
モーション、リムライト、スクロールdocs/06—
サウンドdocs/14js/halo-sound.js
アイコンまたはイラストicons/README.md, docs/09icons/
印刷文書またはPDFdocs/11templates/print-a4.html
React / Next / Tailwind / Vuedocs/17—
ライブラリの選択docs/16—
Figmaまたは他ツール向けデザイントークンdocs/15, tokens/*.tokens.json—
アクセシビリティdocs/12—
テストdocs/13qa/

examples/workout-plan/index.html 全体は読まないこと(約42kトークン)。代わりに特定のパターンを検索する(grep -n "restTimer" …)。

ワークフロー

  1. ブリーフ。 templates/brief.md を記入:誰のためか、ユーザーが何を確認しに戻ってくるか、1~3つのヒーロー数値、シグネチャービジュアル、アクセントの意味、イラスト言語、モーションとサウンドの強度、サーフェス、言語、セクション。リクエストがあいまいな場合は、ブリーフを示して1つ質問する。それ以外は短い段落で説明し、構築を開始する。
  2. 基盤。 tokens/tokens.css、css/halo.css、js/halo.js(ブリーフにサウンドがある場合は js/halo-sound.js も)をリンクし、Halo.init({dict}) を呼び出す。フォント:Google Sans + IBM Plex Sans Arabic(docs/03)。
  3. セクションを構成する docs/05 のコンポーネントを使用:
    • 既存の部品でシグネチャービジュアルを構築:Halo.rings、Halo.spark、.target マーカー付き .meter、.bars、.timeline、ステータスグリッド、またはタイポグラフィックヒーロー。または docs/00 のルールに従ったものを発明する。
    • すべてのテンプレートコンテンツを置き換える。あなたのページに「リングを閉じる」や「GPUは正常」と表示されていて、プロダクトがそれに関するものでなければ、コンテンツをコピーしたことになる。
  4. 電話とラップトップを別々にバランス調整する( docs/04、docs/07)。
  5. バイリンガル: すべての文字列を辞書に入れ、docs/08 のRTLルールを適用する。自分でクルド語を書く場合は、その旨をユーザーに伝え、ネイティブによるレビューを推奨する。
  6. モーションとサウンド はブリーフが選択した強度で(docs/06、docs/14)。
  7. QA、 http経由で実行:
    python3 qa/qa_layout.py http://localhost:8000/page.html    # 9幅 × 2テーマ × 2言語
    python3 qa/qa_touch.py  http://localhost:8000/page.html    # 電話タッチスイート
    
    プロダクト固有のインタラクションチェックとaxe-coreを追加する。390と1440の両テーマでスクリーンショットをレビューする。
  8. 印刷 が必要な場合:HTML → scripts/print_pdf.py → qpdf マージ → scripts/verify_pdf.sh(画像0)。.ttf フォントを埋め込む。

デリバリー前チェックリスト

  • ブリーフが存在し、シグネチャービジュアルがプロダクトに適合している(デフォルトでリングを使っていない、コピーコンテンツではない)。
  • アクセントの意味は最大3つで、一貫して使用されている。テキストアクセントは --XT を使用。
  • トークン外のカラーリテラルなし。ユーザーが提供していないロゴなし。
  • ラップトップ:カラムのバランスが取れている、フッターが揃っている、チャートがカードを埋めている。電話:ナビゲーションコントロール ≤ 4、タップターゲット44px、320pxで横スクロールなし。
  • RTL:dir/lang、反転した山形、ミラーリングされたチャート、ラテン語用語とラテンユニットの周りに <bdi>。
  • 動きを減らす設定が尊重されている。サウンド(ある場合)にはトグルがあり、決して唯一の信号ではない。
  • 事実に基づく主張には情報源がリンクされている。破壊的なアクションには「元に戻す」機能がある。
  • qa_layout.py と qa_touch.py が合格。コンソールエラーなし。PDFはベクター形式と確認済み。

再現性

  • make setup で固定された依存関係(requirements.txt)とChromiumをインストール。
  • make check でスキル自体を検証:リンク、同期されたトークン、未使用の色なし、ロゴなし、JS構文、フロントマター。
  • make qa ですべてのテンプレートとサンプルをテスト。make assets でREADME画像を再レンダリング。make tokens でDTCG JSONを再構築。
  • CIは .github/workflows/qa.yml で同じものを実行。

ファイルマップ

パス説明
docs/00-creative-direction.md最初に読むこと。 ブリーフ、シグネチャービジュアルカタログ、アクセントの意味、イラスト言語、アンチパターン
templates/brief.md記入するブリーフ
templates/starter.html個人向けアプリのメカニクス:分割ヒーロー、リング、タスク、タイマー、シート、サウンド
templates/dashboard.htmlデータ/運用メカニクス:ステータスグリッド、スパークライン、ターゲット付きメーター、ライブ更新、静的モーション
templates/print-a4.htmlベクター印刷ページ
tokens/tokens.css(真実の情報源)+ DTCG 2025.10 JSON
css/halo.css · js/halo.js · js/halo-sound.jsコンポーネント · ランタイム · 穏やかなサウンド
icons/UIアイコン(Lucideグリッド)、グリフ、ピクトグラム文法 + ギャラリー
docs/01–17原則、色、タイポグラフィ、レイアウト、コンポーネント、モーション、電話、RTL、アイコン、データ可視化、印刷、アクセシビリティ、QA、サウンド、Figma、ライブラリ、フレームワーク
qa/ · scripts/テストスイート · 印刷、検証、トークン、アセット、自己チェック
fonts/IBM Plex Sans Arabic + Inter(TTF、OFL)オフライン、CI、印刷用
examples/workout-plan/ハローで作られた完全なプロダクト一例(サイト + 4つのベクターPDF)。参照のみ。

関連スキル