chalk-logic について
Chalk Logicは、アイデアを抑制の効いた、通常は文字を含まないチョーク画に変換するスキルです。画像生成や検査が使えない場合はプロンプトのみを出力し、二つの表示サイズで確認して最大二回修正します。
主な機能
- 01単一の命題に基づく構図設計
- 02緑の黒板と白いチョークの視覚ルール
- 03六つの構図タイプと形式の指針
- 04画像プロンプトと詳細なレシピの作成
- 05二つのサイズでの検査と最大二回の修正
活用シーン
- 01一つのプロセスや関係の図解
- 02簡潔な循環図や分岐図の作成
- 03画像ツールが使えない場合のプロンプト作成
- 04視覚ルールに沿ったイラストの確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ calicastle/ skills --skill chalk-logicインストール後、Claude Code で/chalk-logicを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSEagents/openai.yamlreferences/example-index.mdrepair-playbook.md詳細
Chalk Logic
1 つのアイデアを、均一な緑の黒板に描かれた、静かで白いチョークの命題へと変換します。画像の生成と確認が可能な場合は、デフォルトで画像を生成してください。それ以外の場合は、コンパイル済みのプロンプトと手順を返してください。
視覚的な要件
各箇条書きは、生成ルールであると同時に品質確認の基準として扱ってください。
- 1 つの命題: 1 つのプロセス、関係、構造、循環、蓄積、減衰、または観察に関する前提を伝えます。ひと目でわかる読み進め方を 1 つ設けます。
- 静かな画面: 黒板の約 65%~75% を空白に保ちます。単一の簡素な連続体や観察を描く場合は、空白を 76%~86% に増やします。ゆとりのある外周の余白を確保し、概念を担うモチーフはコンパクトにまとめます。
- 均一な黒板: キャンバスの端から端まで、平坦で乾いた、彩度を抑えた教室の黒板の緑で満たします。サムネイルサイズでも目立たない、ごく微細なマットな粒子感を加えます。画面に含めるのは、黒板と概念を担うチョークのモチーフのみです。
- 鉱物チョークの描線: 温かみのある白い鉱物チョークだけで描きます。コントラストは、薄い下描きや背景情報、読み取りやすい構造、そしてごく少数の明るい接点という、抑制された 3 段階にします。筆圧の変化、やや途切れた線の縁、ときおり重なる描線、小さな粉の付着を表現します。
- 一貫した描線: 意味を持つ経路は、連続した動きとして描きます。素材感による途切れは、線の縁や端に限ります。交差は、明確な因果関係や構造的な意味がある場合にのみ使います。
- 正確さと手描き感: 構図は意図的に整え、描線には人の手の温かみを残します。認識可能な形は、観察したシルエットと機能的な構造に基づいて描き、抽象的な形は具体的な空間的挙動に基づいて描きます。
- 文字なしをデフォルトに: テキスト、文字、数字、数式、文字らしき記号、署名、ロゴ、透かしは一切描きません。ユーザーが明示的にテキストを求めた場合に限り、指定された文言そのままを、短いフレーズ 1 つ、または合計 6 語までの短いラベル 3 つ以内で使います。
- 独自のトポロジー: ステップ 3 で定めるアンカーデルタを満たし、概念独自の仕組みに基づいて構図を組み立てます。
- 2 段階の明瞭さ: サムネイルサイズで命題を読み取れるようにし、フルサイズで確認すると控えめな素材のディテールを楽しめるようにします。
- 意図ある抑制: すべての描線を命題に役立てます。意図した読み取りを保てる範囲で、構造的な形は最小限にします。
フォーマット
- デフォルトの横長イラストには
16:9を使います。 - 開いた循環やコンパクトな蓄積には
1:1を使います。 - 分岐を描く研究図、分解図、ポスターには
4:5を使います。 - 長い変化を超横長の画面にすると効果的な場合に限り、約
2.2:1を使います。 - ユーザーが指定した寸法を厳守し、その寸法に合わせて構図を作成します。
構図の種類
主要な種類を必ず 1 つだけ選びます。
| 種類 | 適した内容 | 基本的な表現 |
|---|---|---|
| 方向性のある進行 | 変化、減衰、蓄積 | 左から右、または斜めに進む単一の連続体。間隔、密度、スケール、反復、筆圧で変化を表現します |
| 開いた循環 | 再帰、段階、睡眠、再生 | 大きな中央の空白を囲む、数や大きさが均等でない 3~5 個の段階を、不完全なループまたは戻る動き 1 つでつなぎます |
| 起点から枝分かれ | 仕組み、分散、選択肢 | まとまった起点 1 つから、交差しない非対称な軌跡を 3~5 本伸ばし、見分けのつく形で差をつけます |
| 軸に沿った観察 | 構造、解剖、組み立て | 認識可能な物体を、共通の軸に沿って少数の正確なパーツ数に分け、位置合わせの線は控えめに添えます |
| 環境内の流れ | 吸収、移動、成長 | 抑制された境界または領域 1 つと、密度や筆圧で示す連続した因果経路 1 つを描きます |
| 静かな情景 | 内省、注意、欠如、間 | 広大な画面に、中心から外れたコンパクトな物体の集まりを 1 つ配置します。図解の補助要素は使わず、配置と余白で印象を伝えます |
手順
1. 概要を確定する
コンセプト、意図する説明、感情的な温度感、出力形式、テキストの方針、実行モードを特定します。出力形式は、指定がある場合は正確なピクセル寸法で、ない場合は比率で表します。画像生成と画像の確認の両方が可能な場合に限り、実行モードを rendered に設定します。
ユーザーが現在の会話で画像を禁止している場合は、rendered を選択する前に、独立した新しいワーカーを1つ用意します。アンカーの閲覧、生成、候補の閲覧、修正、画像の品質確認はすべてそのワーカーを介して行います。ワーカーには、テキストによる所見とローカルファイルのパスのみを返すよう求めます。要求された場合、または必要な機能や独立したワーカーが利用できない場合は、prompt-only を使用します。
完了条件:概要の6つの値と実行コンテキストがすべて明示されていること。画像を会話に含めない rendered の実行では、独立したワーカーが用意されていること。利用できない機能がある場合は、納品時にその旨が記録されていること。
2. 読み取りの流れを整理する
構図の系統を1つ選び、見る人が最初に何に出会い、何が変化または関連し、最後にどこへ注意が向かうかを示す、内部向けの視覚的な文を1つ記述します。意味を担わせる意味の担い手として、間隔、密度、スケール、反復、圧力、オブジェクトの配置などから1つ選びます。
完了条件:その文が、まとまりのある命題1つ、順序のある読み取りの流れ1つ、主要な系統1つ、名前を付けた意味の担い手1つを含み、無関係な筋書きを含まないこと。
3. 品質の基準を定める
references/example-index.md を最後まで読みます。アンカーの選択ルールに従って、項目を1つまたは2つ選びます。新しい構図に共通するアンカーとの差分を1つ記録します。
- 選んだ各アンカーについて、保持する識別特性を3つ、観察可能な対象側の根拠とともに記録します。
- 新しい構図のトポロジーを1つ定めます。
- 主題、形式、視点、方向、数、焦点の位置、意味の担い手から、独立した対象軸を正確に2つ選びます。
- 選んだ各アンカーについて、そのアンカーの元の値を、同じ対象トポロジーと2つの対象軸の値に対応付けます。各対象は、そのアンカーの元の値とは観察可能な形で異なる必要があります。
rendered の実行では、選んだローカルのサンプルだけを視覚的に確認します。prompt-only の実行では、テキストのインデックスで十分です。サンプルは品質の根拠として扱い、画像生成の入力にはしません。ユーザーが画像を会話に含めないよう求めた場合は、ステップ1で用意した独立したコンテキスト内で確認し、ファイルリンクのみを返します。
完了条件:アンカーが1つまたは2つ選ばれていること。各アンカーについて、保持する観察可能な特性が3つ記録され、共通のトポロジーと2つの独立した対象軸への対応付けが記録されていること。3つの対象値がすべての対応付けで同一であり、対応するすべての元の値と観察可能な形で異なること。さらに、rendered の実行では、選んだすべてのアンカーを視覚的に確認していること。
4. レシピを明示する
各軸について、次から値を正確に1つ選びます。
- 形式
- 系統
- 命題
- 読み取りの流れ
- 意味の担い手
- トポロジー
- モチーフの配置
- 認識の手がかり、または抽象的なマークの語彙
- 数または状態:意味のある場合は正確な値、そうでない場合は
not fixed - アンカーとの差分の対象:ステップ3で選んだ2つの対象値。アンカー名や由来は含めません。
- 余白の対象
- チョークのコントラスト階層
- ムード
- テキスト:
wordless、または指定された文言そのものと、そのスケールおよび配置
完了条件:14の軸すべてに1つずつ選択肢があり、いずれも同じ命題を支えていること。
5. 画像プロンプトを作成する
ピクセルに反映すべき情報だけを含む、簡潔な4段落を記述します。
- キャンバス、比率、均一な緑色のボード、余白の目標を明記します。
- 命題、ファミリー、意味を担う要素、トポロジー、意味のある場合は正確な個数、読み進める順序、認識の手がかり、配置、および両方のアンカー変更の目標値を明記します。
- 温かみのある白色のチョークの表現、3段階のコントラスト、一貫した線の表現、ムードを明記します。
- テキストの方針と、誤読を防ぐために必要な対象固有の除外事項だけを明記します。
内部タイトル、手順、ファイル名、出典情報、アンカー分析、QA メモは画像プロンプトに含めず、外部に記載します。
完了条件:レシピのすべての軸が、プロンプト内でピクセル上の目標特性として表現されていること。固定の個数や状態がある場合は明記されていること。要求されたテキストがある場合は、正確な文言、サイズ、配置が含まれていること。プロンプトが1つの視覚的な命題を表していること。ボード、チョーク、線、ムード、テキストの各ゲートが明示されていること。
prompt-only の場合はステップ6と7を省略し、ステータスを PROMPT_ONLY としてステップ8に進みます。
6. 候補を1つ生成する
ステップ1で選択した実行環境と組み込みの画像生成機能を使用します。画像を扱わない会話では、隔離されたワーカーが画像を含むすべての操作を実行します。機能が対応している場合は、要求されたピクセル寸法で正確に生成します。対応していない場合は、同じネイティブ比率で生成し、比率が完全に一致する場合に限ってリサンプリングします。どちらの方法でも要求された寸法を満たせない場合は prompt-only に切り替え、機能に関するメモを記録します。ユーザーが参考画像を提供した場合は、要求された方向性の手がかりにのみ使用し、独自のトポロジーを維持します。
完了条件:正確な寸法が要求された場合、ファイルのメタデータが要求されたピクセル寸法の両方と完全に一致すること。比率が要求された場合、ファイルのメタデータが要求された比率と一致すること。
7. 点検して修正する
ステップ1で選択した実行環境で、候補を原寸とサムネイルの両方で点検します。視覚的な契約の箇条書き、14個すべてのレシピ軸、記録された各アンカー差分を確認します。レシピに not fixed と記載されている場合に限り、Exact counts を N/A と記録します。該当しないその他のゲートも N/A と記録します。
複数のゲートに不合格がある場合は、次の優先順位で最初の不合格を選択します。
- 要求された形式
- テキストの方針
- 命題
- ファミリー
- 読み進める順序
- 因果関係の順序
- 意味を担う要素
- 正確な個数
- 認識の手がかり
- トポロジーとアンカー変更の目標
- 維持されたアンカー特性
- 余白の目標
- モチーフの配置
- サムネイルでの明瞭さ
- 原寸での素材の細部
- 一貫したストローク
- 均一なボード
- ミネラル感のある手描き表現
- チョークのコントラスト階層
- ムード
- 作為の抑制
選択したゲートを references/repair-playbook.md に渡し、その修正方法を修正パス1に適用します。21個すべてのゲートを再点検します。パス2では、同じ優先順位で残っている不合格のうち最初のものを選択し、対応する修正方法を適用します。Topology and anchor-change targets が選択されたゲートである場合に限り、トポロジーを置き換えます。21個すべてのゲートを再点検し、パス2の後で停止します。
2つ目の新しい隔離サブエージェントを利用できる場合は、最終的な視覚QAに使用します。候補とゲートのみを渡し、テキストのみで所見を返すよう依頼します。以前の判断はそのコンテキストに含めません。画像を扱わない実行では、隔離されたワーカーがこのディスパッチを担当し、判定のみを返します。
完了条件:すべてのゲートを漏れなく点検していること。すべて合格した場合は DONE に設定します。修正上限に達した場合は DONE_WITH_CONCERNS に設定し、残っている不合格のゲートをすべて列挙します。
8. 納品
レンダリングを行った場合は、ユーザーの表示設定に応じて、承認済みの画像または通常のファイルリンクを提示し、その後に正確なプロンプトの順序、完全なレシピ、ステータスを示します。プロンプトの順序には、初回生成プロンプトと、すべての修正指示を順番どおりに含めます。プロジェクトに関連する画像は、納品前にユーザーのワークスペースに保存します。バンドルされた参照画像を生成物として提示してはいけません。プロンプトのみの実行では、画像を付けずに、コンパイル済みプロンプト、完全なレシピ、PROMPT_ONLY ステータスを納品します。プロンプトのみでの実行がユーザーのリクエストではなく、機能上のフォールバックである場合は、簡潔な機能に関する注記を一つ追加します。
完了条件:レンダリングを行った実行には、確認済みの候補、正確なプロンプトの順序、14項目すべてのレシピ軸、DONE または DONE_WITH_CONCERNS が含まれます。DONE_WITH_CONCERNS には、残っている失敗ゲートもすべて含めます。プロンプトのみの実行には、コンパイル済みプロンプト、14項目すべてのレシピ軸、PROMPT_ONLY、および必要な機能に関する注記が含まれます。
出力形式
PROMPT_ONLY の場合は、Image 行を省略します。使用しない修正行と条件付きフィールドはすべて省略します。
**Image**
[Chalk Logic illustration](absolute-image-path)
**Exact prompt sequence**
```text
Initial: [exact generation prompt]
Repair 1: [exact instruction, when used]
Repair 2: [exact instruction, when used]
```
**Recipe**
- Format: [ratio or dimensions]
- Family: [family]
- Proposition: [visual sentence]
- Reading path: [choice]
- Semantic carrier: [spacing/density/scale/repetition/pressure/object arrangement]
- Topology: [spatial structure]
- Motif placement: [choice]
- Recognition cues or marks: [choice]
- Counts or states: [exact values/not fixed]
- Anchor-change targets: [target value 1; target value 2]
- Quiet space: [percentage]
- Chalk hierarchy: [three levels]
- Mood: [emotional temperature]
- Text: [wordless or exact wording, scale, and placement]
- Status: [DONE/DONE_WITH_CONCERNS/PROMPT_ONLY]
[Concerns: required only for DONE_WITH_CONCERNS]
[Capability note: only when PROMPT_ONLY is a fallback]