plugin.json

{
  "name": "spritecook",
  "version": "0.1.18",
  "description": "Generate sprites, build matching UI kits, upload reference images, and animate game art with SpriteCook.",
  "author": {
    "name": "SpriteCook",
    "email": "hello@spritecook.ai",
    "url": "https://spritecook.ai"
  },
  "homepage": "https://spritecook.ai/agents",
  "repository": "https://github.com/spritecook/codex-plugin",
  "license": "MIT",
  "keywords": [
    "spritecook",
    "game-art",
    "sprites",
    "pixel-art",
    "animation",
    "mcp",
    "codex"
  ],
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SpriteCook",
        "shortDescription": "Create and animate game art",
        "longDescription": "Create sprites, tilesets, animations, and matching UI kits for your game in ChatGPT and Codex. Use reference images and saved presets to keep assets consistent, work with your SpriteCook asset library, and prepare character assets for Godot. Connect a SpriteCook account to get started. Available tools depend on your account, and generation can take a few minutes.",
        "developerName": "SpriteCook",
        "category": "Creativity",
        "capabilities": [
          "Interactive",
          "Write"
        ],
        "websiteURL": "https://spritecook.ai",
        "supportURL": "https://www.spritecook.ai/contact",
        "privacyPolicyURL": "https://spritecook.ai/privacy",
        "termsOfServiceURL": "https://spritecook.ai/terms",
        "defaultPrompt": [
          "Generate a tiny pixel art knight character, idle pose.",
          "Design a matching inventory screen, extract its reusable UI components, and finalize the UI kit.",
          "Animate this existing sprite into a short idle loop."
        ],
        "brandColor": "#FF7A00",
        "composerIcon": "./assets/spritecook-logo.png",
        "logo": "./assets/spritecook-logo.png",
        "screenshots": []
      },
      "review": {
        "prompts": [
          "Create a transparent 32 by 32 pixel-art potion icon using Pixel Engine Image.",
          "Animate my selected flying bat sprite with room below it for its wing movement.",
          "Explain how to draw the water base layer beneath a two-surface grass-and-water tileset. Do not generate assets."
        ],
        "demo_recording_url": "https://drive.google.com/file/d/1Eyc04jEXyF4DJc3XE8ADB4eeqfndhIVl/view?usp=drivesdk",
        "test_cases": {
          "positive": [
            {
              "description": "Generate a pixel-art character. Run first; retain the PNG and asset ID for cases 2 and 5.",
              "prompt": "Use SpriteCook to create one friendly forest knight for a side-view platformer. Give the knight a green tunic, a small wooden shield, a clear silhouette, and a transparent background. Show the finished sprite and give me its PNG download.",
              "tools_triggered": "get_credit_balance; list_generation_models; list_character_workflows; generate_character; check_job_status",
              "expected_behavior": "One completed owned character asset with a visible preview and usable PNG download, following the requested side-view design. The assistant follows returned polling instructions and does not resubmit a processing job. Download the PNG for case 2 and retain the asset ID in this conversation for case 5."
            },
            {
              "description": "Upload a selected PNG and animate it. Attach the knight PNG downloaded in case 1.",
              "prompt": "Use SpriteCook to upload only the attached knight PNG and create an eight-frame idle loop with gentle breathing and a small shield movement. Keep the character in place and preserve the transparent background. Show the animation and provide its download.",
              "tools_triggered": "get_credit_balance; create_asset_upload; finalize_asset_upload; animate_game_art; check_job_status",
              "expected_behavior": "Only the selected PNG is transferred to the returned upload destination and finalized as an owned asset. The animation uses that asset ID and completes as an eight-frame idle loop with preview and download. Processing is followed until completion without duplicate submissions. Use a client with access to transfer the attached PNG bytes."
            },
            {
              "description": "Generate a compact tileset and prepare its Godot export. No existing assets required.",
              "prompt": "Use SpriteCook to generate a top-down pixel-art tileset of mossy stone ground, with 32-pixel tiles and the compact 15-piece layout. Prepare it for Godot and provide the tilesheet, TileSet resource, and setup instructions.",
              "tools_triggered": "get_credit_balance; list_tileset_options; generate_tileset; check_job_status; export_godot_tileset_package",
              "expected_behavior": "A completed tileset in the supported requested layout, its PNG tilesheet, ready-to-write Godot .tres resource, and README. Explain file setup accurately without claiming a Godot project was tested unless it was actually opened and tested."
            },
            {
              "description": "Build a coherent pause-menu UI kit through concept, sheets, extraction, and finalization.",
              "prompt": "Use SpriteCook to build a small pause-menu UI kit for a cozy woodland game. Include a panel and Resume, Settings, and Quit buttons. Use warm wood, green accents, and readable labels. Generate one concept, use it to make the component sheets, then inspect and extract the reusable components. Show the result and provide the final assets and manifest.",
              "tools_triggered": "get_credit_balance; create_ui_kit; generate_ui_kit_concepts; get_ui_kit; select_ui_kit_concept; generate_ui_kit_component_sheets; extract_ui_kit_components; finalize_ui_kit; returned job polling tools",
              "expected_behavior": "A matching concept, component sheets, and inspected reusable UI assets with a manifest. Check extraction warnings and component boundaries before finalizing; explain any unresolved issue. A flattened concept alone is not a completed kit."
            },
            {
              "description": "Save and reuse a private style preset and organize assets. Continue the case 1 conversation using its actual knight asset ID.",
              "prompt": "Use the forest knight from our first test as the style reference. Save its style as a private preset called Woodland Review, then use that saved preset to create one matching health-potion sprite with a transparent background. Put the knight and potion in a collection called Woodland Review, creating the collection if needed. Show me the potion.",
              "tools_triggered": "get_credit_balance; get_asset_metadata; save_private_preset; list_presets; get_preset_settings; generate_game_art; check_job_status; list_collections; create_collection if needed; assign_assets_to_collection",
              "expected_behavior": "A private preset preserves relevant generation settings and the owned reference. The potion is generated from the retrieved preset. Both assets are in the prepared Woodland Review collection in the OpenAI Review project. Use real owned IDs and do not publish the preset. Identify existing demo objects on repeat runs to avoid ambiguous duplicate names."
            }
          ],
          "negative": [
            {
              "description": "Explain tilesets without generating art. No SpriteCook MCP calls should run.",
              "prompt": "Explain how a compact 15-piece tileset works in Godot. Use a small text diagram and pseudocode only. Do not generate, export, or upload any artwork."
            },
            {
              "description": "Critique an attached image without uploading or modifying it. Attach the knight PNG from positive case 1. No SpriteCook MCP calls should run.",
              "prompt": "Look at this attached pixel-art knight and suggest three palette improvements. Give advice only. Do not upload the image, edit it, or generate a replacement."
            },
            {
              "description": "Write a code-only game menu with placeholders. No SpriteCook MCP calls should run.",
              "prompt": "Write HTML and CSS for a pause menu with Resume, Settings, and Quit buttons. Use plain colored rectangles as placeholders. Do not create images or a UI kit."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Updated SpriteCook guidance for exact-size Pixel Engine Image sprites, animation engine selection and airborne framing, model-specific reference limits, style-reference pixel scale, UI-kit extraction checks, and two-surface tilesets. Improved polling, output-size and safe connection guidance. Includes skills version 2026.10.20."
      },
      "apps": "./.app.json"
    }
  }
}