Communitygithub.com

Craft

ビジュアルデザインを作成するためのエントリポイントです。「料金ページをデザインして」といった指示を、完成されたレビュー済みのデザインに変換します。プロジェクトのブリーフをもとに、すべての状態をカバーし、方向性が未確定の場合のみオプションを提示し、デザインシステムのコンポーネントのみを使用し、結果を表示する前に自己チェックを行います。

Craft とは?

Craftは、AIエージェント(Claude Code、Cursor、Codexなど)が視覚的なデザインタスクを実行するための最上位スキルです。このスキルは、「料金ページを作成して」「オンボーディングフローをデザインして」といった抽象的な指示を、具体的なデザイン成果物に変換します。Craftは、プロジェクトルートの`DESIGN.md`からブリーフを読み込み、デザインシステム(トークン、コンポーネント、ガイド)を参照し、関連する画面を確認した上で、タスクのスコープを明確に定義します。 このスキルの特徴は、単なる描画ツールではない点です。`craft-states`(状態の列挙)、`craft-explore`(方向性の探索)、`craft-system`(システムの拡張)、`craft-critique`(自己レビュー)といったサブスキルを決められたタイミングで呼び出すことで、体系的かつ高品質なデザインを保証します。例えば、空の状態やエラー状態など、主要な状態だけでなくすべての状態を網羅する必要がある場合や、デザインシステムにない新しいコンポーネントが必要な場合に、適切なサブスキルを自動的に起動します。 Craftは、デザインツール(Figmaなど)のアダプターに対応しており、利用可能なツールに応じて最適な描画方法(HTMLでのプロトタイピングも含む)を選択します。また、コードとデザインの矛盾を検出し、コードを優先する厳格なルールを持っており、デザインの品質と一貫性を維持します。セッション終了時には、決定事項を`DESIGN.md`の決定ログに追記し、次のセッションでも一貫したデザインが継続できるようにします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft

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

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

ドキュメント

Craft は何をしますか?

概要

ビジュアルなものを作るための玄関口です。「料金ページをデザインして」を、完成されレビューされたデザインに変えます。プロジェクトのブリーフから作業を始め、すべての状態をカバーし、方向性が未確定の場合にのみオプションを提供し、デザインシステムの部品のみを使用し、結果を表示する前に自身の作業をチェックします。他のデザインスキルを決められたタイミングで呼び出しますが、それらを置き換えるものではありません。

使用するタイミング

  • 「<ページ、画面、フロー、要素>をデザイン/作成/モックアップ/再デザインして」、/craft(Claude Codeプラグインでは/craft:craft)。
  • 複数のページを一度に(「オンボーディングをデザインして:ウェルカム、サインアップ、確認」)。

使用してはいけないタイミング

  • ユーザーが正確に指定した小さな編集(値、ラベル、サイズが一つ):直接実行します。
  • レビューのみ(「これの何が問題?」):craft-critiqueを使用します。オプションのみ:craft-exploreを使用します。

開始前の準備

  • references/adapters/にあなたのツールにマッチするアダプターがない場合、あなたのツールで同じ動詞を実行し、手動でマッピングしたことを伝えてください。デザインツールがまったくない場合は、HTML(html.md)で構築します。画像しかない場合は、画像から読み取った値は概算であることを伝えてください。

ストップは現実のものです

ストップとは:あなたのターンを質問で終了し、待つことを意味します。これは常に可能であり、ワンショットやヘッドレスセッションでも、あなたの最後のメッセージが質問になります。セッションが「待てない」または「ラウンドトリップを節約するため」という理由で、ユーザーに代わってストップを決定しないでください。 自分で決定すると、5秒の回答が数時間のやり直しに変わります。

手順

  1. コンテキスト。
    • プロジェクトルートのDESIGN.mdを読みます。これが存在しない、またはProductセクションがない場合(同期のみのレコード)→ 必須サブスキル:craft-setup を実行し、その後ここに戻ります。
    • デザインシステム(トークン、コンポーネント、ガイド)と、これに関連する画面を読みます。
    • ブリーフとコードが矛盾する場合(ブリーフがティールと言い、トークンが青と言う場合):コードに従い、その旨を1行で伝え、矛盾をDESIGN.md › Open questionsに追加し、どちらが間違っているかを更新する提案をします。ページ自身のCSS内でトークンを上書きしないでください。
    • デザインツールのガイドとコードが異なり、design-sync.jsonが存在する場合、ガイドを古いと見なさないでください。それを使って分類します:コードが変更された → 描画する前にガイドを更新する提案をします;ガイドが変更された → ユーザーの変更がエクスポートを待っている状態なので、ガイドを使用して描画し、保留中のエクスポートについて言及します。
  2. 言葉でスコープを定義します。 作成する各ページまたは要素を、それぞれの役割と次のアクションとともにリストアップします。
    • 曖昧な言葉は、一つの解釈を明確に述べます(「料金ページ = パン屋の価格リストであって、サブスクリプションプランではない」)。
    • 複数のアイテムがある場合、またはリクエストが曖昧な場合は、リストを確認してストップします。 明確なアイテムが一つなら、そのまま進みます。
  3. 各アイテムについて、順番に:
    1. 必須サブスキル:craft-states。 記述された状態リストとそのストップが最初に来ます。
    2. 方向性が未確定? ユーザーがアイデアを求めた場合、またはブリーフもシステムも選択しない構造的に異なる二つのレイアウトが考えられる場合にのみ → 状態を描画する前に必須サブスキル:craft-explore を実行します。複数ページの場合、スコープのストップで、どのページ(もしあれば)にオプションを与えるかを尋ねます;デフォルトでページごとにオプションのラウンドを実行しないでください。その後、選択された方向性で状態が描画されます。既存のパターンに従う画面は、直接描画に進みます。
    3. システムの部品とトークンのみを使用して、主要な状態を描画し、その後他の状態を描画します。新しいもの(コンポーネント、色、スケールにないサイズ)→ それを使用する前に必須サブスキル:craft-system(追加モード)を実行します。コードには存在するがツールに描画されていないコンポーネント(インデックスで「コードのみ」)→ 必須サブスキル:craft-sync(1コンポーネントのインポート)を実行し、そのコンポーネントのみを最初に描画します。ユーザーがインポートを拒否した場合(DESIGN.mdを参照)、インポート前に一度尋ねます;それでも拒否する場合は、コードの値を使用してボード上に直接構築し、その旨をメモします。類似品を描画したり、ページ内に新しい値をハードコードしたりしないでください。
    4. 自己チェックモードでの必須サブスキル:craft-critique をすべてのボードに対して実行します:レンダリングし、このタスクのスコープ内で見つかった問題を修正し、再度レンダリングします。
  4. クローズ。
    • 以下のサマリーとともに結果を表示します。
    • 決定事項をDESIGN.md › Decisions logに追加します(日付、決定、理由)。
    • 回答が得られた質問は、Open questionsから削除します。

クロージングサマリー(最終メッセージの形式)

作成したもの: <ページ/要素> — <場所: ファイルまたはボード>
決定事項: <各決定、理由とともに1行>(DESIGN.md › Decisions logにも同様)
システム変更: <追加または変更された部品/トークン> — 影響範囲: <画面>
自己チェックで修正: <craft-critiqueがあなたが見る前に変更した内容>
未解決の質問: <ユーザーがまだ決定すべきこと>

ルール

ルール理由
毎回、まずDESIGN.mdを確認ブリーフなしでは、すべての画面が独自のスタイルを発明する
複数アイテムの場合、作業前にスコープを確認誤った解釈で3ページ構築するのは3ページの無駄
描画前に状態リストを取得(craft-states経由)ハッピーパスは多くの状態のうちの一つ
方向性が未確定の場合のみオプションを提供解決済みのパターンにオプションを出すのはユーザーの注意を無駄にする
システムの部品とトークンのみを使用;新しいものはcraft-system経由ページ内のハードコードされた値が、ドリフトの始まり
コードは古いブリーフに勝つ;それをメモし、上書きしないトークンが出荷されるもの;ブリーフは決定によって更新され、黙っては更新されない
表示前に自己チェックユーザーはデザインをレビューすべきであり、ミスを探すべきではない
決定事項はDESIGN.mdに記録次のセッションのデザインは、記憶ではなくそれらから始まる

完了条件

確認されたスコープ内のすべてのアイテムの状態が描画され自己チェックされ、システム変更がcraft-systemを経由し、クロージングサマリーが提供され、DESIGN.mdのDecisions logが更新されたとき。

よくある間違い

考え現実
「3ページは十分明確だから、そのまま作ってしまおう」まずリストを確認してください。1メッセージの手間です。
「ここではボタンを52pxにしよう。トークンは44だけど、このオーディエンスはもっと大きく必要だ」それはシステムの決定です。craft-systemを通じて提案し、その後、すべての場所でそれを使用してください。
「ブリーフがティールと言っているから、このページのCSSで青を上書きしよう」コードが優先です。矛盾を報告して尋ねてください;トークンをローカルでパッチしないでください。
「表示して、彼らに何が問題か教えてもらおう」まずcraft-critiqueを自己チェックモードで実行し、何を修正したかを伝えてください。
「決定事項は私のメッセージに書いてあるから、それで十分だ」メッセージはスクロールして見えなくなります。DESIGN.mdに追加してください。
「このセッションは答えを待てないから、自分で判断してリストアップしよう」ターンを質問で終了することがストップです。そうしてください;最初の未解決のストップを超えて何も構築しないでください。
「ラウンドトリップを節約するために、両方のストップを1つのメッセージに入れよう」問題ありません、その後ストップすれば。両方を尋ね、何も構築せず、待ってください。

Individual skills in this repo

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

関連スキル