Pixel Print Kit は何をしますか？
画像を入力すれば、印刷可能なキットが出力されます。スクリプトがピクセルグリッドを検出し（または通常画像をピクセル化し）、パレットを整理し、manifold3dで各色ごとに水密なジオメトリを構築し、スライサーが読み取るのと同じ方法で結果をチェックします。
クイックスタート
SKILL_DIR = このファイルを含むフォルダ（利用可能な場合は ${CLAUDE_SKILL_DIR}）。パスは引用符で囲んでください。
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png # 45mmキーチェーン、色ごとに1パーツ
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png --product magnet --style swap # シングルノズルプリンター
python "$SKILL_DIR/scripts/pixelkit.py" logo.png --pixels 32 --max-colors 4 --render # ロゴをピクセル化、レンダリング追加
初回のみ: python -m pip install manifold3d numpy pillow（不足があるとスクリプトが表示します）
出力先 pixelkit-out/<name>/: stl/（色ごとに1ファイル）、<name>.3mf（1オブジェクト、色ごとに1パーツ、スロット順に 01_black、02_... と命名）、guide.md（フィラメント、設定、カラーチェンジ高さ）、kit.json、preview.png（フラットカラーチェック）、--render 付きで: hero.jpg、top.jpg、turntable.mp4。
プロダクトとスタイルの選択
| ユーザーが欲しいもの | フラグ |
|---|---|
| キーチェーン（デフォルト） | --product keychain（45mm、2.2mmの輪郭、Ø4.2mmのリング穴） |
| 冷蔵庫マグネット | --product magnet（10x2mmマグネット用ポケット追加；--magnet 8x3 で変更） |
| コースター | --product coaster（95mm丸型） |
| 壁飾り / サインプレート | --product plaque（120mm角丸長方形） |
| アート単体 | --product tile（輪郭なし） |
| AMS / マルチマテリアルあり | --style ams（デフォルト）：色をフラッシュ、トップレイヤーのみ変更 |
| シングルノズル、AMSなし | --style swap：1つのボディ、各色を1つの高さステップに；ガイドに各フィラメント交換のレイヤーを記載 |
便利なオプション: --size 60（完成時の外形サイズ、mm）・--grid-gap 0.3（ピクセル間の溝、非常に「ドット絵」らしく）・--raise 0.6（ams：色を浮き上がらせる）・--shape silhouette|rect|round・--border 0・--hole 0・--hole-pos left|center|right・--base-color "#hex"（輪郭色）・--order "#a,#b,..."（swap：下から上へ）・--max-colors 4（ユーザーのAMSスロット数に合わせる）・--keep-bg（不透明背景をアートの一部として保持）。
ワークフロー
- [ ] pixelkit.py を実行し、コンソール出力を確認: グリッドサイズ、色 -> フィラメント、チェックOK
- [ ] preview.png を確認: パレットは適切か？（アンチエイリアスによる不要な色があれば `--merge` を上げるか `--max-colors` を下げる）
- [ ] ピクセルサイズが 0.8mm以上あることを確認（警告が出た場合 -> `--size` を大きくするか `--pixels` を減らす）
- [ ] `--render` を実行し、hero.jpg / top.jpg を納品前に確認する
- [ ] ユーザーに伝える: 寸法、フィラメントスロット、swap の場合は guide.md のカラーチェンジ高さ
チェック（「開いたエッジ 0」「重なり 0」）は必ずパスしなければなりません。失敗した場合、スクリプトは終了コード 2 で終了します。不合格のキットを引き渡さないでください。
経験則
- 本物のピクセルアートはピクセル化した写真より優れています。 ログの場合、幅24～40ピクセル、色数3～5が最適です。
- 色 = フィラメント数。
--max-colorsはユーザーのAMSスロット数以下に抑えてください。推奨PLA色名は近似値なので、ユーザーに実際のスプールと比較してもらってください。 - スワップ順序： 濃い色を下にするとほとんどのアートでうまくいきます（輪郭を最初に）。明るい細部は上に置くと鮮明に残ります。
- 小さなピクセル： 40mm未満のキーチェーンで32px以上あると、細かい部分がもろくなります。サイズを大きくするか、アートを簡略化してください。
- ゲームやブランドのピクセルアート は他人の知的財産です。個人での印刷は問題ありませんが、販売はしないでください。
いつ何を読むか
references/print-notes.md- スライサーの手順（Bambu/Orca/Prusa）、公差、マグネット、トラブルシューティング。