Community画像github.com

coloring-book

ユーザーが塗り絵本やローコンテントブックを作りたい、または「(テーマの)塗り絵本を作って」と依頼した際に、テーマに沿った白黒線画のページを生成し、Amazon KDP に出品する準備を支援します。

coloring-book とは?

このスキルは、ユーザーが指定したテーマに基づいて塗り絵本の制作から KDP アップロード準備までを支援する、完全なワークフローを提供します。ステップ①では、指定されたページ数(デフォルト96ページ)に応じたシーンプロンプトと予備シーンを生成し、ステップ②では、Gemini API、無料の Gemini アプリ、またはローカルの ComfyUI/FLUX などの画像生成手段をユーザーが選択し、実際に画像を生成します。ステップ③では、専用の QC スクリプト(qc_page.py)で各画像の線の太さ、空白の有無などを自動チェックし、不合格の画像は最大3回再生成してから予備シーンに差し替えます。ステップ④では、合格した画像から内用PDFと表紙PDFを生成し(make_pdf.py)、最後のステップ⑤では、ユーザー自身がログインしたブラウザで KDP のフォームに必要事項を入力するよう誘導します。このスキルは、Claude Code などのコマンドラインAIエージェント環境で動作することを想定しており、各ステップでユーザーに進行状況を報告し、人間の判断が必要な箇所では必ず停止して確認を求めることで、安全かつ透明性の高い制作プロセスを実現します。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Owen-gh/coloring-book-skill/tree/HEAD

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

ドキュメント

coloring-book:テーマから塗り絵本を作る(KDP 出品準備を含む)

最初にお読みください(声明)

  • これは個人のワークフローのデモであり、一人(私たち)が実際に2冊の本を作成した手順を記録したものです。法律的な助言ではなく、KDP 公式のサポート方法でもありません。
  • 開始前にユーザーは自分で KDP の規約を読み、確認してください:アカウントの使用、サードパーティツールの使用、AI 生成コンテンツの開示、コンテンツのガイドライン。規約は変更される可能性があるため、その時点の KDP 公式説明を基準としてください。
  • 私たちの知る限り、KDP には公開されている書籍アップロード API はありません。アップロード工程はユーザー自身がログインしたブラウザで Web フォームに入力し、ユーザーがその場で確認してから送信します。いかなるアカウントの結果も保証しません。
  • 本ファイル内の数字はすべて「私たちが記録した値であり、ご自身で確認してください」という意味です(または「私たちが実測した」と明記)。明記されていない値を事実としてユーザーに伝えないでください。
  • AI 開示:本のイラストは AI 生成です。KDP は正直な申告を求めています。あなた(AI)はユーザーに隠蔽させたり、ユーザーの代わりに「通りが良い」回答を考えたりしてはいけません。

あなたが行うこと(概要)

ユーザーが「(テーマの)塗り絵本を作って」とだけ言ってきた場合、以下の手順 ① から ⑤ を順番に実行し、各ステップの終了時にユーザーに進捗を1行報告します。各ステップで「人が行うべきこと」に遭遇したら、一旦停止してユーザーに依頼し、代わりに行わないでください。

ステップ内容詳細ファイル
① シーンテーマに基づき N ページ分のシーンプロンプトと予備シーンを生成references/prompt-principles.md
② 画像生成画像生成方法を選択し、各ページの画像を生成本ファイル「ステップ ②」
③ QCすべての画像を測定し、不合格は再描画、予備と差し替え、すべて完了するまで繰り返しreferences/qc-rules.md、scripts/qc_page.py
④ 製本内用 PDF と表紙 PDF を生成references/book-spec.md、scripts/make_pdf.py
⑤ アップロードユーザーがログインしたブラウザで KDP フォームに入力するよう誘導references/kdp-upload-fields.md

事前準備

  • Python 3 と Pillow、numpy、scipy が必要です(qc_page.py は numpy/scipy を使用、make_pdf.py は Pillow のみを使用)。パッケージが不足している場合は、ユーザーの同意を得てからインストールし、仮想環境内でインストールしてください。
  • PDF の確認には pdfinfo、pdftoppm(poppler)を使用できます。Pillow は PDF の書き出しのみ可能で、PDF を開くことはできません。
  • スクリプトは python scripts/xxx.py で実行します。パスはこのスキルフォルダを基準とします。

ステップ 0:開始確認(ユーザーに一度にまとめて質問)

  1. テーマは何ですか?(曖昧な場合は、2~3 の方向性を提示して選んでもらってください。自分で勝手に決めないでください)
  2. ページ数:デフォルトは 96 ページ、8×8 インチ正方形(= 47 枚のイラスト;私たちの2冊ともこの仕様です)。「ページ」は印刷されるページ数、「イラスト数」= ページ数 / 2 - 1(KDP 最低 24 ページ = 11 枚のイラスト);ユーザーが「24 ページ」と言った場合、どちらを指しているか確認してください。
  3. どの画像生成方法をお持ちですか?(Gemini API、無料 Gemini アプリ手動、またはローカル GPU ComfyUI/FLUX 類)→ ステップ ② を参照。 3b. 誰が塗るのか?疎(子ども向け) または 密(大人向け) の二択(QC の --mode sparse|busy に対応、デフォルトは疎)。子ども向け版は私たちは1冊も作ったことがありません。画像を確認してください。
  4. 著者名(表紙に印刷する名前)と書名:ユーザーが決定します。
  5. ユーザーの KDP アカウントで税金と支払い情報はすでに設定されていますか?(設定されていない場合は、先に自分で設定するよう伝えてください。最初の4つのステップには影響しません)
  6. 今週すでに何冊の KDP ペーパーバックを作成しましたか?(私たちの記録では制限:週に最大 2 冊。kdp-upload-fields.md を参照。KDP のその時点の規定を基準としてください。)

作業フォルダを作成(名前は任意)し、その中に以下を含めます:scenes.json、spares.json、book.json、raw/、pages/、log.csv、needs_human.txt。3 つの記録ファイルのフォーマットテンプレートは references/templates/ にあります(book.json、log.csv、needs_human.txt)。各フィールドの文字数上限は references/kdp-upload-fields.md を参照してください。

ステップ ①:シーンプロンプト

references/prompt-principles.md に従います:

  • N ページ分のシーン文を生成(N = ページ数 / 2 - 1、96 ページ = 47 個)+約 1/6 の予備シーン(私たちは 47 のメインシーンに対して 8 つの予備シーンを用意しました)。
  • シーン文 = 固定の接頭辞 + そのページのシーン文(場所はテーマに応じて決定し、{theme}/{place} プレースホルダーを使用し、特定の町の名前などに固定しない)+ Square 1:1 image.。接頭辞の核:黒太線、カラー・影・グレースケール・ハッチング・ベタ黒ブロックなし、文字・人物なし、物は少なく大きく、ページ全体に塗るものがあること、同じオブジェクトの繰り返し禁止。
  • 主人公、場所は全書で重複しないようにします。構図と季節はローテーション。オブジェクトの数は徐々に増やします。
  • scenes.json(文字列の配列)と spares.json に保存します。シーンリストをユーザーに見せて、OKが出るのを待ってから画像生成を開始します(画像生成は費用または GPU 時間がかかります)。

ステップ ②:画像生成

選択方法(ユーザーに確認後、いずれかを選択):

  • A. Gemini 画像モデル(API または Web):私たちは実際に Nano Banana 2.1(モデルコード gemini-nano-banana-2.1)を使用しました。アスペクト比 1:1(正方形)、画像生成後に 2400 px に縮小します。API ルートでは並行して複数枚生成可能(私たちは 4 並列)。Web ルートではユーザーがプロンプトを貼り付け、あなたがファイル整理を支援します。ユーザー自身が API キーを提供するかログインする必要があります。キーは環境変数にのみ保存し、ファイルに書き込んだりチャットに貼り返したりしないでください。
  • C. 無料の Gemini アプリ(手動):あなたが各ページの完全なプロンプトを生成し、ユーザーが Gemini アプリに貼り付けて、画像を指定のフォルダ(raw/)に保存します。あなたは各画像に対してステップ ③ の QC を実行します。不合格の場合は、理由(qc_page.py が出力する平易な一文)をユーザーに伝え、再生成を依頼してください。注意:これは手動です。無料枠には1日あたりの上限があります(上限はご自身で確認してください。私たちは検証していません)。アプリのモデルは私たちのものと異なる可能性があります。品質は画像を確認してください。QC、製本、アップロードは引き続きあなたが行います。全自動ではありません。画像枚数が多いと非常に時間がかかります。
  • B. ローカル GPU(ComfyUI + FLUX 類モデル):私たちは FLUX.2 Klein 4B と別の flux3 ワークフローを試しました。出力サイズは 1088 x 1088。私たちの記録:Klein は中程度のディテールのページで線が細くなりがち(計測 2–4 px、しきい値 4.5)でした。線が細すぎるページには「黒線を外側に 1 px 拡張、最大 3 回」の後処理を施してから線幅を再測定しました。私たちが実際に出版した2冊の本の画像は、すべて Gemini ルートで生成されたものです。 ローカルルートで本を出版したことはなく、未検証と見なします。Gemini が利用可能な場合は優先的に使用してください。
  • 費用:このスキルを使用するために、いかなる画像生成ソフトウェアのサブスクリプションも必要ありません。Gemini API は従量課金制(Web 版はご自身のプランに依存)。ローカル GPU はサブスクリプション不要ですが、自身の GPU と電気代が必要です。スキルファイルの実行には Claude Code(Anthropic のプランに依存)が必要です。費用はご自身で評価してください。
  • 最小仕様(私たちが実測):正方形 1:1。元画像は少なくとも約 1000 px(ローカル版は 1088、Gemini デフォルトサイズは検証時 1024、最終版では 2400 に拡大、線は滑らかで QC に合格可能)。最終ページは 2400 x 2400 px(8 インチ × 300 dpi)、純粋な白黒。
  • 表紙メイン画像:同じモデルでカラーの正方形画像をもう1枚生成します。私たちは 2K サイズを使用し、プロンプトでは「上部 25% は落ち着いたクリーム色の空白、文字なし、人物なし」と指定しました。検証時に遭遇した問題:単に "top 25% blank" と書いただけでは、モデルが画像を上下2段に分割してコピーすることがありました。「single continuous scene (not split, not tiled)… compose in the lower three quarters; the top quarter is a flat plain cream color」と書き直すことで正常になりました。画像生成後は必ず自分で画像を確認し、上部に本当に空白があることを確認してから、make_pdf.py に渡してください。
  • 選択 A でユーザーが API を持っていない場合:制限を回避する方法を提案しないでください。代わりに、使用権限のある Web 版を使って1枚ずつ画像を生成し、ファイルを raw/ に保存するよう依頼し、あなたが QC を引き継いでください。
  • AI 画像サービスを使用する前に、ユーザー自身がそのサービスの利用規約で商用利用と書籍出版が許可されていることを確認するよう依頼してください(私たちが使用した Gemini、FLUX.2 Klein 4B はそれぞれ独自の規約があり、FLUX.2 Klein 4B は Apache-2.0 と読み取りました。ユーザーは自身で再確認する必要があります)。

ステップ ③:QC、すべて完了するまで

ユーザーには以下の4点のみ伝えます:

  1. 白黒のみで、灰色や大きな黒ブロックがないこと。
  2. 線が十分に太いこと。
  3. ページ全体が空白でないこと:9分割の各マスに何かがあり、各マスに少なくとも3つの塗れる領域があること。
  4. 不合格の場合は自動で再描画(各ページ最大3回、それでもダメなら予備シーンに差し替え)。 (スクリプトはさらに多くの詳細項目をチェックしますが、逐一説明する必要はありません。)

各ページ:

最大3回:
  画像生成 -> raw/sNN_try.png
  python scripts/qc_page.py [--mode sparse|busy] raw/sNN_try.png   # 不合格の場合は平易な理由を出力
  プログラムが PASS したら、あなた自身が画像を確認:主人公の頭や体がはっきりしているか、丸いオブジェクトと融合していないか(references/qc-rules.md)
  すべて PASS:python scripts/qc_page.py --finalize raw/sNN_try.png pages/cNN.png ; log に記録 ; break
  それ以外:log に記録(理由を含む);元画像を破棄;同じシーン文で再描画(手動ルート:ユーザーに再生成を依頼)
3回すべて不合格:spares.json の次の予備シーンに差し替え;予備を使い切っても不合格:needs_human.txt に記録し、次のページへ進む
  • 合格させるために自分でしきい値を変更したり、不合格の画像を手動で選んで pages/ に入れたりしないでください。 needs_human.txt が空でない場合はそこで停止し、ユーザーに判断を仰いでください。
  • 並行して複数枚の画像生成が可能です。記録は明確に(時間、ページ番号、試行回数、結果、理由)。
  • すべて完了したら、ユーザーに全体の接触一覧表を見せて、OKが出たらステップ ④ に進んでください。
  • 私たちの実測参考:47 ページの本で、log は合計 90 エントリ、各ページの最後に PASS が1件あり、途中で予備シーンに8回差し替えました。不合格や予備への差し替えは想定内であり、正常です。

ステップ ④:製本、PDF 生成

references/book-spec.md に従います(私たちの実測仕様:8×8 インチ、96 ページ、300 dpi、白紙白黒内用、片面印刷 – 各画像の後に空白ページ、表紙は 0.125 インチの塗り足しを含む、背幅 = ページ数 × 0.002252 インチ)。

  • 例:python scripts/make_pdf.py pages/ out/ --title "..." --subtitle "..." --author "..." --blurb "..." --cover-art cover.png 出力:out/interior_upload.pdf、out/cover.pdf、out/cover_preview.png。
  • --pages は偶数である必要があります。画像数は pages/2 - 1 である必要があります(検証用に2枚の画像がある場合は --pages 6 を指定;不足すると「画像は N 枚しかありません」と報告されます)。KDP ペーパーバックには最低ページ数があります(私たちの記録では 24 ページ。ご自身で確認してください)。6 ページの検証用書籍はアップロードできません。スクリプトはページを自動的に複製してページ数を調整することはなく、またそうすべきでもありません。
  • スクリプトの動作:内用タイトルページは自動的に改行(4行を超える場合は文字を削減)。表紙の書名/サブタイトル/著者名は背景に応じて濃い/薄い文字色を自動選択し、半透明の下地を追加。背文字は --pages が 79 以上の場合のみ配置(私たちの記録値。公式ページでは 79 または 80 と記載。ご自身で確認してください)。それ以下の場合は空白にしてヒントを表示。背文字の方向(時計回り、上から下に読む)はご自身で確認してください。それでも表紙プレビューで位置を確認する必要があります。
  • 自分でスクリプトを書くこともできます。同じ仕様に従っている限り問題ありません。完了したら自分で開いて一度確認し、プレビューをユーザーに見せてください。
  • 書名、サブタイトル、著者名、説明、キーワード(7組)、カテゴリ(2つ)を book.json に書き込み、ユーザーに確認してもらいます(形式は kdp-upload-fields.md を参照)。文字はすべてプログラムでレイアウトし、モデルに文字を描かせないでください。

ステップ ⑤:アップロード(あなたがその場で見守り、確認してから送信)

references/kdp-upload-fields.md に従います。重要なポイント:

  1. まず停止:ユーザー自身で kdp.amazon.com にログイン(パスワードと 2FA を含む)し、税金と支払い情報が設定されていることを確認するよう依頼してください。これらはユーザー自身が行います。ユーザーにパスワード、Cookie、確認コード、ID 書類をあなたに渡させないでください。また、それらを記録しないでください。
  2. ユーザーがログインしているブラウザで(例:ブラウザ自動化ツールを使用)、Bookshelf → Create → Paperback と進み、1フィールドずつ book.json の値を入力します。各ページの入力が完了するたびに、「このページではこれこれの項目を入力しました」と簡潔に報告し、ユーザーが画面で確認します。
  3. 著作権表示(Publishing Rights)のラジオボタン:ユーザー自身に選択させ、ユーザー自身にクリックさせてください。
  4. AI 生成コンテンツの開示:正直に申告してください。 私たちの2冊の場合:画像は大部分が AI 生成で、修正は最小限だったため、「AI 画像 = Many AI-generated images, with minimal or no editing」と入力し、ツール欄には実際のツール名を入力しました。内用のテキストは手動でレイアウトしたタイトルページのみです。あなたの状況は正直に入力し、ユーザーに確認させてください。
  5. 内用と表紙をアップロードしたら、Launch Previewer を実行して Approve してください(私たちの実測:この手順を実行しないと次に進めません)。
  6. Publish ボタンの前で停止し、ユーザーにすべてのフィールドとプレビューを確認させます。ユーザーが押すかどうかを決定します。
  7. 週ごとの数量制限をリマインドしてください(私たちの記録では週に最大 2 冊。KDP のその時点の規定を基準としてください)。一度に1冊のみ作成します。ユーザーが不在の状態でバッチアップロードしないでください。
  8. ページがテンプレートと異なる場合、または CAPTCHA、リスク警告、アカウント警告が表示された場合:停止してユーザーに確認してください。回避方法を考えないでください。

ユーザーへの報告時の口調

  • 「私たちが行った手順では…」「私たちが実測したところ…」という表現を使い、「KDP が許可している」「公式サポート」「アカウント停止にならない」「全自動アップロード」とは言わないでください。
  • できないこと、検証していないことは、検証していないと伝えてください。
  • 最終納品物:pages/(確定ページ)、out/interior_upload.pdf、out/cover.pdf、book.json、log.csv、(存在する場合)needs_human.txt、および「ユーザー自身が行うべきこと」のリスト。

付録:私たちが検証していないこと(ユーザーに主張しないでください)

  • 他のサイズ、生成紙、ハードカバー、8.5×11 インチの完成本。
  • 「かわいい動物シーン」スタイル(マンダラ、写実、人物)以外でのしきい値の妥当性。「疎(子ども向け)」のデフォルト設定では1冊も作成したことがありません。
  • 「主要 AI 自身が画像を見る」構造チェックと、別途ビジュアルモデルに画像を見せた結果との一致。
  • 販売数、ランキング、収益:いかなる保証も提供しません。

関連スキル