Skip to content

0x0funky/agent-sprite-forge / skills/video2dsprite

video2dsprite

Verified

Turn one approved master still into a character's whole animated sprite set - one image-to-video clip per action (idle, walk, run, attack, jump, hurt, cast and so on), all from that still, generated through generate2dmedia route_media.py (the xAI API when a key is configured, else the local Grok CLI) - then gate each take, key it with a soft matte, register it to the master, pick loops or retime actions, finish (HD by default, pixel on request) and package fixed-canvas frames, alpha WebM, packed MP4 for iPhone and a PNG fallback with engine metadata and a JS runtime. Also processes a supplied clip. Use for character and creature animation, fluid motion and any video-to-sprite work. Not for FX, icon or prop sheets (generate2dsprite), maps or plate loops (generate2dmap), code-drawn animation (codeart2d, only on request) or calling a video API by itself (generate2dmedia).

references/schemas/host.schema.json

View on GitHub
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/0x0funky/agent-sprite-forge/main/shared/schemas/host.schema.json",
  "title": "Agent Sprite Forge host contracts",
  "description": "What a host (such as Agent Game Forge) reads from the Forge without knowing every tool's files: the asset index of forge_index.py scan and the progress lines a tool appends to its --progress-file. Version 1; objects stay open.",
  "$defs": {
    "asset_index_v1": {
      "description": "forge_index.py scan <dir>: everything the Forge made under one folder. root is the scanned folder (absolute, POSIX); every other path is relative to it and stays inside it (indexPath: no '..' segment; a document path that leads outside is left out with a warning). masters come from master.json; sets from set_plan.json and set_state.json (read under the set's set_state.lock), per action with its status, take count, chosen take or window, the agent's accept, and the package of the chosen take (packageTake, packageTag) with its animation.json, poster, the package's reviewStatus and the verify result. When the recorded package holds another take or window than the chosen one (after a retake, or an accept of another take or window) package, packageTake, packageTag, manifest, poster, reviewStatus and verify are null and that package is previousPackage: never import it as the action's clip. fx come from fx.json, route A (pixelfx) or B (the image route); plates from plate.json; maps from map bundles (generate2dmap.map_bundle.v1 or v2). warnings name documents that could not be read, paths left out and a set lock that stayed held.",
      "type": "object",
      "required": ["schema", "tool", "createdAt", "root", "masters", "sets", "fx", "plates", "maps", "warnings"],
      "properties": {
        "schema": {
          "const": "forge.asset_index.v1"
        },
        "tool": {
          "$ref": "common.schema.json#/$defs/toolInfo"
        },
        "createdAt": {
          "$ref": "common.schema.json#/$defs/timestamp"
        },
        "root": {
          "type": "string",
          "minLength": 1
        },
        "masters": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["id", "name", "path", "metadata", "image", "class", "finish", "facing", "status"],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "path": {
                "$ref": "#/$defs/indexPath"
              },
              "metadata": {
                "$ref": "#/$defs/indexPath"
              },
              "image": {
                "$ref": "#/$defs/indexPath"
              },
              "cutout": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/indexPath"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "class": {
                "type": "string"
              },
              "finish": {
                "type": "string"
              },
              "facing": {
                "type": "string"
              },
              "route": {
                "type": ["string", "null"]
              },
              "status": {
                "const": "approved"
              }
            }
          }
        },
        "sets": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["id", "name", "path", "plan", "state", "finish", "status", "actions"],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "path": {
                "$ref": "#/$defs/indexPath"
              },
              "plan": {
                "$ref": "#/$defs/indexPath"
              },
              "state": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/indexPath"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "class": {
                "type": "string"
              },
              "finish": {
                "enum": ["hd", "pixel", "hibit"]
              },
              "targetHeight": {
                "type": ["integer", "null"]
              },
              "master": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/indexPath"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "enum": ["planned", "complete", "complete-with-warnings", "incomplete"]
              },
              "actions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": ["id", "action", "view", "kind", "status", "takes", "chosen", "accepted", "package", "packageTake", "packageTag", "manifest", "reviewStatus", "previousPackage"],
                  "properties": {
                    "id": {
                      "type": "string",
                      "minLength": 1
                    },
                    "action": {
                      "type": "string",
                      "minLength": 1
                    },
                    "view": {
                      "type": "string",
                      "minLength": 1
                    },
                    "kind": {
                      "enum": ["loop", "oneshot"]
                    },
                    "status": {
                      "type": "string",
                      "minLength": 1
                    },
                    "takes": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "chosen": {
                      "anyOf": [
                        {
                          "type": "object",
                          "required": ["take"],
                          "properties": {
                            "take": {
                              "type": "integer",
                              "minimum": 1
                            },
                            "window": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "items": {
                                    "type": "integer",
                                    "minimum": 0
                                  },
                                  "minItems": 2,
                                  "maxItems": 2
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "tag": {
                              "type": "string"
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "accepted": {
                      "anyOf": [
                        {
                          "type": "object",
                          "required": ["take"],
                          "properties": {
                            "take": {
                              "type": "integer",
                              "minimum": 1
                            },
                            "window": {
                              "anyOf": [
                                {
                                  "type": "array",
                                  "items": {
                                    "type": "integer",
                                    "minimum": 0
                                  },
                                  "minItems": 2,
                                  "maxItems": 2
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "at": {
                              "anyOf": [
                                {
                                  "$ref": "common.schema.json#/$defs/timestamp"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "package": {
                      "anyOf": [
                        {
                          "$ref": "#/$defs/indexPath"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "packageTake": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 1
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "packageTag": {
                      "type": ["string", "null"]
                    },
                    "manifest": {
                      "anyOf": [
                        {
                          "$ref": "#/$defs/indexPath"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "poster": {
                      "anyOf": [
                        {
                          "$ref": "#/$defs/indexPath"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "reviewStatus": {
                      "type": ["string", "null"]
                    },
                    "verify": {
                      "type": ["string", "null"]
                    },
                    "previousPackage": {
                      "anyOf": [
                        {
                          "$ref": "#/$defs/indexPath"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "if": {
                    "properties": {
                      "package": {
                        "type": "string"
                      }
                    },
                    "required": ["package"]
                  },
                  "then": {
                    "properties": {
                      "packageTake": {
                        "type": "integer"
                      },
                      "packageTag": {
                        "type": "string"
                      }
                    }
                  },
                  "else": {
                    "properties": {
                      "packageTake": {
                        "type": "null"
                      },
                      "packageTag": {
                        "type": "null"
                      },
                      "manifest": {
                        "type": "null"
                      },
                      "poster": {
                        "type": "null"
                      },
                      "reviewStatus": {
                        "type": "null"
                      },
                      "verify": {
                        "type": "null"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "fx": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["id", "name", "path", "metadata", "route", "routeName", "frames", "frameSize", "sheet", "status"],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "path": {
                "$ref": "#/$defs/indexPath"
              },
              "metadata": {
                "$ref": "#/$defs/indexPath"
              },
              "route": {
                "enum": ["A", "B"]
              },
              "routeName": {
                "enum": ["pixelfx", "image"]
              },
              "effect": {
                "type": ["string", "null"]
              },
              "frames": {
                "type": "integer",
                "minimum": 1
              },
              "frameSize": {
                "$ref": "common.schema.json#/$defs/size2"
              },
              "frameMs": {
                "type": ["number", "null"]
              },
              "loop": {
                "type": ["boolean", "null"]
              },
              "sheet": {
                "$ref": "#/$defs/indexPath"
              },
              "sheetJson": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/indexPath"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "preview": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/indexPath"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "credits": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/indexPath"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "$ref": "common.schema.json#/$defs/qaStatus"
              }
            }
          }
        },
        "plates": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["id", "name", "path", "metadata", "image", "size", "colors", "status"],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "path": {
                "$ref": "#/$defs/indexPath"
              },
              "metadata": {
                "$ref": "#/$defs/indexPath"
              },
              "image": {
                "$ref": "#/$defs/indexPath"
              },
              "preview": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/indexPath"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "palette": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/indexPath"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "size": {
                "$ref": "common.schema.json#/$defs/size2"
              },
              "colors": {
                "type": "integer",
                "minimum": 1
              },
              "status": {
                "$ref": "common.schema.json#/$defs/qaStatus"
              }
            }
          }
        },
        "maps": {
          "type": "array",
          "items": {
            "type": "object",
            "required": ["id", "name", "path", "schemaVersion"],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "path": {
                "$ref": "#/$defs/indexPath"
              },
              "schemaVersion": {
                "enum": ["generate2dmap.map_bundle.v1", "generate2dmap.map_bundle.v2"]
              },
              "world": {
                "anyOf": [
                  {
                    "type": "object"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "layers": {
                "type": "integer",
                "minimum": 0
              },
              "objects": {
                "type": "integer",
                "minimum": 0
              }
            }
          }
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "progress_line_v1": {
      "description": "One line of a --progress-file (forge_core.Progress; FORGE_PROGRESS_FILE when no flag is given): a stage change of one tool run, appended and flushed while it runs, never written to stdout. t is the UTC time; tool the CLI (master_still, sprite_set, finish_frames, engine_export); stage its stage name (start, prompt, take, job, generate, evaluate, post, load, palette, downscale, colour-lock, quantize, qa, finish, package, verify, residue, encode, decode, publish, done, error); done and total are counts within the stage or null; message is short ASCII text or null. The last line of a run is done or error.",
      "type": "object",
      "required": ["t", "tool", "stage", "done", "total", "message"],
      "properties": {
        "t": {
          "$ref": "common.schema.json#/$defs/timestamp"
        },
        "tool": {
          "type": "string",
          "minLength": 1
        },
        "stage": {
          "type": "string",
          "minLength": 1
        },
        "done": {
          "type": ["integer", "null"],
          "minimum": 0
        },
        "total": {
          "type": ["integer", "null"],
          "minimum": 0
        },
        "message": {
          "type": ["string", "null"]
        }
      }
    },
    "indexPath": {
      "description": "A path in the asset index: a common relPath relative to the index root that never leaves it (no '..' segment). forge_index.py resolves every document path and leaves out one that leads outside root (a '..' or a link); a host still checks containment before it reads a file.",
      "allOf": [
        {
          "$ref": "common.schema.json#/$defs/relPath"
        }
      ],
      "not": {
        "pattern": "(^|/)\\.\\.(/|$)"
      }
    }
  }
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall