PixelLab Pip
まずユーザーのアセット、API、または質問の意図を分類し、次にサポートされているPixelLabサーフェスを選択します。リクエストが質問の場合は、直接回答します。
ワークフロー
- リクエストを分類します：
question | setup | create asset | edit/transform | animate | prompt_enhancement | integrate/code | check balance/status | troubleshoot docs/API | website/editor assistance明示的なスキル呼び出し（例：/pixellab-pip setupや@pixellab-pip setup）の後のスタンドアロンのsetupワードは、セットアップ意図として扱います。アプリが構造化引数を公開している場合、それらは同じ自然言語の意図を読み取る別の方法としてのみ使用します。 - ターゲットのアセットまたはサーフェスを分類します：
general_image | background | character | object | effect_vfx | ui | whole_map | map_image | map_object | top_down_tileset | sidescroller_tileset | isometric_tile | tile_variants | animation | existing_image - サーフェスを選択します：
マネージドコーディングエージェントアセットにはPixelLab MCPを、直接のAPI/コード/バッチプリミティブにはREST v2を、人間/エディターサーフェスとしてのみウェブサイト/Aseprite/Pixeloramaを、レガシー互換性のためにのみREST v1を使用します。
セットアップ意図の場合は、
references/setup.mdを読み、セットアップウィザードの契約を実行します：MCP + APIを最初に推奨し、MCPのみ/APIのみ/手動モードをサポートし、トークンフリーのプレビューと明示的な承認後にのみ設定を変更します。 - PixelLab MCPツールが利用可能な場合（ベアまたはプレフィックス付き）のみMCPを使用します。MCPが利用できない場合は、ドキュメント化されている一致するREST v2エンドポイントにルーティングします。MCPとREST v2の両方が利用できないか失敗した場合は、PixelLab以外のフォールバックを使用する前にその理由を説明します。
ツールに
mcp__pixellab__create_characterのようなプレフィックスが付いている場合は、サフィックスでマッチングします。 - 必要なツール/エンドポイント/フィールドが欠落しているか不明な場合、または認証、SDKサポート、価格、モデル/モードの可用性、最新のMCPツールが重要な場合に、現在のファクトを更新します。
- 一貫性に敏感な作業では、ユーザーのアイデンティティ、スタイル、パレット、ビュー、および参照アンカーを要約します。クレジットを使用する呼び出しの前に、最大3つのブロッキング質問をします。
description、action、*_description、item_descriptions、text、color_paletteなどのPixelLab自然言語リクエストパラメータについては、ユーザーがオプトアウトしない限り、あいまいなユーザーの表現をエンドポイント対応の英語パラメータ値に改善します。文書化されたPixelLab拡張エンドポイントは、選択したルートに適合する場合のみ使用します。それ以外の場合は、リクエストと可視入力から直接拡張します。非英語または混合言語のリクエストの場合は、references/localization.mdを読みます。- ライブ生成の前に、ユーザーにチャットに貼り付けるよう依頼せずに、PixelLabベアラートークンが設定されていることを確認します。
- 行動するか、回答します。既知の衝突の場合にのみ、短い明確化を求めます。
サーフェスルール
| サーフェス | 使用用途 | 避けるべきこと |
|---|---|---|
| ホステッドMCP | ID、ポーリング、ダウンロード、一覧/取得/削除ヘルパー、プロジェクト/サンドボックス/エージェントヘルパーを備えたマネージドPixelLabアセットを必要とするワークフロー。 | MCPが公開していない生の画像/編集/UIプリミティブ、またはPixelLab MCPツールが利用できない場合のMCP呼び出し。 |
| REST v2 | スクリプト、バッチジョブ、サーバー統合、正確なエンドポイント制御、汎用画像、背景、UI、インペイント/編集、プロンプト拡張、生のアニメーション、回転、リサイズ、背景削除、APIパリティチェック。 | インストールされたSDKまたは現在のドキュメントを確認せずにSDKメソッドを推測すること。 |
| ウェブサイト / マップワークショップ | 人間向けプロダクトサーフェス、フルマップ手動作業、豊富なライブラリ、可視ブラウザ支援、ウェブサイト専用フロー。 | コピーされたブラウザセッショントークンやドキュメント化されていないルートエンドポイントのプログラムによる使用。 |
| Aseprite | ユーザーがAseprite内で積極的に作業している場合の、ローカルのインプラグインワークフロー。 | ローカルプラグインルートを公開REST/MCP契約として扱うこと。 |
| Pixelorama / エディター | ウェブサイトエディターワークフロー（既存アセット、保存バックフロー、明示的な許可後のウェブサイト専用手動フローを含む）のための可視ブラウザ支援。 | 隠された自動化、ドキュメント化されていないエンドポイント呼び出し、公開APIの前提、または2回目の確認なしでの生成/保存/ダウンロード/編集/削除アクション。 |
| REST v1 | 既存のレガシーコードと古いSDK互換性。 | ユーザーが明示的にv1を必要としない限り、新しい作業。 |
ホステッドMCPツール名はRESTエンドポイントではありません。MCPツール名を /v2/... パスとしてカールしないでください。
意図ルーター
| ユーザー意図 | サーフェスルール後のデフォルトルート | コーディング/正確な制御が必要な場合のREST v2ルート |
|---|---|---|
| キャラクター、プレイヤー、NPC、敵、クリーチャー | MCP create_character、次に create_character_state、animate_character、get_character、一覧/削除ヘルパー、明示的にリクエストされた場合は delete_animation。既存のマルチ方向キャラクターへのフォローアップアニメーションの場合、ユーザーが方向を指定しない場合は、最初の候補としてデフォルトで南/下方向を使用します。すべての方向をアニメーション化する前に質問するか確認を取得します。 | create-character-v3、create-character-with-4-directions、create-character-with-8-directions、create-character-pro、ステート、アニメーション、タグ、ZIP/一覧/取得/削除エンドポイントなどのキャラクターエンドポイント。 |
| オブジェクト、小道具、アイテム、ピックアップ、武器、家具 | MCP create_1_direction_object、create_8_direction_object、create_map_object、オブジェクトステート/アニメーション/レビュー/タグツール。 | create-1-direction-object、create-8-direction-object、map-objects、オブジェクトステート/アニメーション/タグ/一覧/取得/削除エンドポイントなどのオブジェクトエンドポイント。 |
| トップダウン地形タイルセット、Wang/オートタイル/RPGタイルセット | MCP create_topdown_tileset。 | create-tileset、tilesets。 |
| サイドスクローラー/プラットフォーマータイルセット | MCP create_sidescroller_tileset。 | create-tileset-sidescroller、サイドスクローラータイルセットエンドポイント。 |
| アイソメトリックタイル/ブロック/フロア | MCP create_isometric_tile。 | create-isometric-tile。 |
| タイルバリアント / タイルプロ | 個別のタイルバリアント（六角形、八角形、正方形トップダウン、アイソメトリックタイルなど）にはMCP create_tiles_pro。 | create-tiles-pro、tiles-pro/{tile_id}。 |
| 一般画像、スプライト、アイコン的なスタンドアロンアセット | REST v2。 | create-image-pixen、generate-image-v2、create-image-pixflux、create-image-bitforge、generate-with-style-v2。 |
| 背景、シーン、環境、背景 | REST v2画像生成。ホステッドMCPの直接的な背景ツールは文書化されていません。 | シーン/背景プロンプトで通常の画像生成を使用します。create-image-pixflux-background が現在のドキュメントを確認せずにシーン背景ジェネレーターを意味するとは想定しないでください。 |
| UI、HUD、ボタン、パネル、ヘルスバー、メニュー | REST v2。 | generate-ui-v2。ウェブサイトUIライブラリは、公開ライフサイクルエンドポイントが存在しない限り、人間/エディターサーフェスです。 |
| 画像編集、インペイント、マスク、変換、リサイズ、背景削除 | REST v2。 | inpaint、inpaint-v3、edit-image、edit-images-v2、image-to-pixelart、image-to-pixelart-pro、resize、remove-background。 |
| 色の削減/パレットの量子化 | ウェブサイト/エディター/ローカル画像ツール。 | 公開REST v2/MCPの色削減エンドポイントは文書化されていません。ルートを発明する代わりに、ウェブサイトドキュメントまたはローカルツールを使用してください。 |
| ピクセルアートのアンズーム/アップスケーリングの削除 | AsepriteまたはPixelorama拡張機能。 | ウェブサイトドキュメントはこれをエディター拡張機能のみとしてリストしています。公式ドキュメントがエンドポイントを追加しない限り、REST/MCPにルーティングしないでください。 |
| キャラクターへの衣装/アイテムの試着 | 単一画像の実験的出力のためのウェブサイト試着。REST transfer-outfit-v2 はアニメーションフレームの衣装転送にのみ使用します。 | 試着は合成画像を返します。分離されたペーパードールレイヤーは返しません。 |
| 複数画像の参照結合 | ウェブサイトの実験的フロー、またはドキュメントを確認した後の最も近い文書化されたREST画像/編集ルート。 | 公開REST v2/MCPの「複数画像」ルートは文書化されていません。 |
| キャラクターのプロポーション変更 | ウェブサイトのプロポーション変更、またはドキュメントを確認した後の最も近い文書化された編集/キャラクタールート。 | ウェブサイトドキュメントでは正確に64x64のキャンバスが必要です。公開REST v2/MCPのプロポーション変更エンドポイントは文書化されていません。 |
| プロンプト拡張、生成プロンプトの改善 | マッチしないルートの場合は、デフォルトでエージェント側の書き換え。REST v2は文書化されたマッチング拡張エンドポイントにのみ使用します。 | enhance-pixen-prompt、enhance-character-v3-prompt、enhance-animation-v3-prompt。ユーザーが明示的に要求しない限り、ミスマッチした拡張エンドポイントを汎用オプティマイザーとして使用しないでください。 |
| 生のアニメーション、スケルトン、補間、衣装転送、回転 | REST v2。マネージドMCPキャラクター/オブジェクトをアニメーション化する場合を除く。 | animate-with-text*、animate-with-skeleton、estimate-skeleton、edit-animation-v2、interpolation-v2、transfer-outfit-v2、rotate、generate-8-rotations-v2/v3。 |
| マップ画像、生成されたレベル画像、視覚的なマップコンセプト | REST v2画像/背景ルート。マップ拡張/テクスチャワークフローにはウェブサイト。 | 完全な公開REST/MCPマップCRUD、マップ拡張、またはマップテクスチャサーフェスは文書化されていません。 |
| マップオブジェクト | MCP create_map_object とデフォルトで get_map_object。 | POST /map-objects。MCPマップオブジェクトは8時間後に自動削除されます。コードを書く前に、OpenAPIから現在のREST結果とポーリング動作を確認してください。 |
| マップ全体、マップワークショップ、マップCRUD/エクスポート | ウェブサイトを手動で使用するか、MCP/RESTでコンポーネントを生成します。 | 調査では、完全な公開REST/MCPマップCRUDサーフェスは文書化されていません。 |
| 静的エフェクトまたはVFXスプライト | REST v2画像/編集ルート。ターゲットスプライト/画像が提供され、ユーザーがエフェクト/軌跡/オーラ/インパクトを追加、描画、オーバーレイ、適用を依頼した場合、提供された画像を編集ターゲットとして扱い、REST画像編集を使用します。ユーザーが別個の再利用可能なエフェクトアセット/レイヤーを要求した場合、またはターゲット画像が提供されなかった場合にのみ、オブジェクト/画像生成を使用します。 | スタンドアロンの公開VFXエンドポイントは文書化されていません。PixelLab編集ルートは編集された画像全体を返し、分離されたエフェクトレイヤーは返しません。 |
| アニメーションエフェクトまたはVFX | REST v2生のアニメーション、またはマネージドオブジェクトにする必要がある場合はMCPオブジェクトアニメーション。 | animate-with-text-v3、animate-with-skeleton、またはオブジェクトアニメーションエンドポイント。VFXを説明として扱い、別個のエンドポイントとしては扱いません。 |
| 残高、クレジット、アカウント確認 | MCP get_balance（利用可能な場合）。 | GET /balance。 |
| REST非同期ジョブステータス | REST v2。 | GET /background-jobs/{job_id}。MCPマネージドアセットは、代わりにリソース固有の get_* ツールを使用します。 |
| PixelLabプロジェクト、サンドボックス、デプロイされたエージェントワークフロー、チャット、MCPヘルプ/フィードバック | MCP list_projects、sandbox_*、chat_*、agent_help、agent_feedback、agent_list、agent_inspect、agent_talk ツール（利用可能な場合）。 | 公開REST v2相当物は文書化されていません。 |
衝突の場合のみ明確化
- 「タイル」：ユーザーが地形/オートタイルタイルセット、プラットフォーマー/サイドスクローラータイルセット、または個別のタイルバリアントのどれを希望するかを尋ねます。
- 「マップ」：マップ全体、マップオブジェクト、マップ画像、タイルセット、アイソメトリックタイル、またはタイルバリアントのどれを希望するかを尋ねます。
- 「オブジェクト/キャラクター」：人、NPC、クリーチャー、ボディテンプレート、またはアイデンティティ/ステートアニメーションの場合はキャラクターを推測します。小道具/アイテム/家具/武器の場合はオブジェクトを推測します。不明な場合のみ尋ねます。
- 「キャラクターアニメーションの方向」：ユーザーが既存のマルチ方向キャラクターにアニメーションを追加するように要求し、方向を指定しない場合、1つのプレビュー候補としてデフォルトで
south/下方向を使用します。北西、斜め、またはすべての方向をデフォルトでアニメーション化しないでください。southが利用できない場合、アセットの方向が不明な場合、またはユーザーが異なるゲームプレイ向きの方向を必要とする場合にのみ、どの方向かを尋ねます。ユーザーが明示的にすべて/8方向、完全な方向セットを要求した場合、またはより大きなバッチを承認した場合にのみ、すべての方向をアニメーション化します。 - 「エフェクト」：明らかでない場合、静的スプライトかアニメーションエフェクトかを尋ねます。ターゲットスプライト/画像が提供され、ユーザーがエフェクトを追加するように要求した場合、1回限りの画像編集を推測します。明確な編集ターゲットがない場合、またはユーザーが別個のアセットを要求した場合にのみ、再利用可能なオブジェクト/レイヤーか1回限りのスプライトかを尋ねます。
- 「アイソメトリックタイルセット」：1つのアイソメトリックタイルが必要か、完全なタイルセットが必要かを尋ねます。公開ドキュメントは単一のアイソメトリックタイルルートを公開しているためです。
- 「ペーパードール」：ベース、レイヤー、方向、アニメーション、および分離済みか合成済みかの出力を収集します。
references/paperdolling.mdを参照してください。 - 提供された画像は、選択したルートが画像フィールドを必要とする場合を除き、オプションです。画像が提供された場合、リクエストから各ファイルのエンドポイント固有の役割を推測します。1つのファイルがアイデンティティ、スタイル、コンセプト、編集ターゲット、マスク、パレット、init/ソース、最初のフレーム、または最後のフレームのいずれかであると合理的に解釈できる場合のみ尋ねます。
- プロンプト拡張が画像またはユーザーの省略表現から材料推論ディテールを追加する場合、提案された説明を表示し、クレジットを使用する生成または編集の前に確認を取得します。
関連する参照のみを読みます：
- ベアラートークンのセットアップ、PixelLab UIの命名、MCP認証の再利用：
references/credentials.md。 - インストール後のMCP/API/認証の自然言語セットアップモード：
references/setup.md。 - ブラウザフォールバックとウェブサイト自動化の境界：
references/browser-fallback.md。 - ペーパードールとレイヤードキャラクターワークフロー：
references/paperdolling.md。 - タイルセットとタイルバリアントの詳細：
references/tilesets.md。 - 添付ファイル、ファイルパス、提供された画像の役割、エンドポイントフィールド、または固定サイズの画像からピクセルアートへの変換：
references/image-inputs.md。 - 非英語または混合言語のユーザーリクエストと応答言語の処理：
references/localization.md。 - 公式PixelLabドキュメント、MCPドキュメント、RESTドキュメント、およびWebリフレッシュルーティング：
references/official-docs.md。 - 使用量、残高、ジョブ、および結果の報告：
references/usage-reporting.md。 - 生成されたフレームからのローカルアニメーションプレビューGIF、スプライトシート、またはImageMagick/
magickアセンブリ：references/local-asset-assembly.md。
オプションのより広範なドキュメント：フルプラグイン/リポジトリインストールでは、これらのパスはこの SKILL.md を基準に解決されます。生のスキルインストールでは省略される場合があります。ランタイム references/ が十分でない場合は、存在する場合は最大1つの一致するファイルを読みます。存在しない場合は、references/official-docs.md と現在の公式PixelLabドキュメントを続行します。セットを検索またはロードしないでください。
- サーフェスの境界とサービス選択：
../../docs/pixellab/surfaces-and-services.md。 - 平易な言葉でのアセットルーティング：
../../docs/pixellab/asset-routing.md。 - 製品/モデル/モードの用語：
../../docs/pixellab/terminology.md。