@pixelvibing/cli 0.50.0 → 0.51.0

package/dist/pixel-vibing-cli.js

@@ -4762,7 +4762,7 @@ const move = {
     );
   }
 };
-const version = "0.50.0";
+const version = "0.51.0";
 const manifest = {
   version
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixelvibing/cli",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "description": "PixelVibing: pixel art game assets from the command line, and the Skills that teach coding assistants to make them.",
   "license": "MIT",
   "homepage": "https://pixelvibing.com",

package/skills/pixelvibing-change/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pixelvibing-change
-description: Change art this game already has on PixelVibing — another of an object (a variant), an object or a creature changed as you say (an edit), or one set in motion (an animation) — through the PixelVibing MCP server's generate tool, from a picture the platform keeps. Use when a result is close but not right, or needs another like it, or has to move.
+description: Change art this game already has on PixelVibing — another of an object (a variant), an object or a creature changed as you say (an edit), one set in motion (an animation) or drawn in a still pose (a pose), kept with its sprite — through the PixelVibing MCP server's generate tool, from a picture the platform keeps. Use when a result is close but not right, needs another like it, has to move, or needs a pose.
 ---
 
 # Changing a result
@@ -22,6 +22,7 @@ use only one a tool answered.
 { "project": "<id>", "kind": "variant", "source_image": "<image id>", "instruction": "in autumn colours", "max_percent": 40 }
 { "project": "<id>", "kind": "edit", "source_image": "<image id>", "source_name": "knight", "instruction": "give it a red cape", "max_percent": 40 }
 { "project": "<id>", "kind": "animate", "source_image": "<image id>", "instruction": "walks to the right", "enrich": false, "max_percent": 40 }
+{ "project": "<id>", "kind": "pose", "source_image": "<image id>", "instruction": "mid-walk", "into": { "sprite": "outfit/fox", "name": "mid-walk", "direction": "south" }, "max_percent": 40 }
 ```
 
 - **`variant`** draws another of an object, keeping what makes it that object; the
@@ -32,9 +33,31 @@ use only one a tool answered.
   its first frame to its last: what moves, how far, and how it returns. It takes no
   reference; the platform chooses how many frames. Pass `enrich: false` when the motion is
   written in full; leave it on for a person's few words.
+- **`pose`** draws an object or a creature in a still pose. The instruction is the pose:
+  a label such as `mid-walk`, or what changes in a few words. It takes no reference.
 
-`get_job` follows the job; then `pixel-vibing-cli pull <job id>` lands it. An animation
-lands as `<name>/<n>`, one picture a frame, and an export packs its frames as an animation.
+## A sprite's motion
+
+A sprite keeps its motion with it, in three groups, each piece at an address:
+
+| Group | What it is | Address |
+|---|---|---|
+| views | one picture a direction | `<sprite> › view › <direction>` |
+| poses | a still picture under a label, in a direction or more | `<sprite> › pose:<label> › <direction>` |
+| animations | a named list of frames | `<sprite> › animation:<name>` |
+
+`get_sprite_motion` with the project and the sprite's name answers all three, each picture
+by its image id, and the sprite's own picture among `parts` — the `source_image` to animate or
+pose it from. Give `generate` an `into` and an animation or a pose is kept with the sprite as
+the job finishes: `{ "sprite": "object/windmill", "name": "sails-turning" }` for an animation,
+`{ "sprite": "outfit/fox", "name": "mid-walk", "direction": "east" }` for a pose. The name is
+kebab-case; a creature's animation is one the game plays, such as `walk-south`; a pose faces
+south unless a direction is given. Drawn again at the same address, the new one takes the
+address and the old one is still kept.
+
+`get_job` follows the job; one kept with its sprite says so in its data's `kept`. Without
+`into`, `pixel-vibing-cli pull <job id>` lands it: an animation lands as `<name>/<n>`, one
+picture a frame, and an export packs its frames as an animation.
 
 ## Not here