CLI reference › PixelLab utilities

skeleton-preview

pixelkiln skeleton-preview <keypoints.json> [--from image.png] [--out sheet.png]
pixelkiln skeleton-preview <asset> [--style <id>] [--out sheet.png]

Draws every pose of a keypoints file over its source image as one PNG, the starting pose first at full strength and each frame after it over a dimmed copy. Right-side bones are orange, left-side blue, the head and spine white. Local and free: nothing is sent anywhere. Given an animate-skeleton asset id, it reads the revision's keypointsFile and source image from the manifest; given a file, --from names the image (without one, poses are drawn on a plain ground). The sheet is written beside the keypoints file as <name>.preview.png unless --out says otherwise. A file that does not parse fails with the same message plan would give.

Use it after estimate-skeleton and after every hand edit: PixelKiln cannot check that the starting pose matches what the image shows, and a mismatch degrades every generated frame without an error.