anymove-reader skill
Train the joint reader for one anymove creature - render about 2,200 random poses from both layout cameras with every joint's true position, fine-tune DINOv2 (ViT-B/14 with registers) plus a heatmap head on them, check the held-out error, and optionally run the exam (a made-up motion with known joints, read back and scored in centimetres). Use after anymove-rig and before anymove-capture, when a reader misses or swaps joints on real clips, or when planning GPU time for dataset rendering and training.
- GitHub stars
- 600
- Files
- 1
- Last commit
- Nov 13, 2026
- License
- Apache-2.0
- Allowed tools
- —
What does the anymove-reader skill do?
anymove-reader is an agent skill. Train the joint reader for one anymove creature - render about 2,200 random poses from both layout cameras with every joint's true position, fine-tune DINOv2 (ViT-B/14 with registers) plus a heatmap head on them, check the held-out error, and optionally run the exam (a made-up motion with known joints, read back and scored in centimetres). Use after anymove-rig and before anymove-capture, when a reader misses or swaps joints on real clips, or when planning GPU time for dataset rendering and training.
How to install the anymove-reader skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the anymove-reader skill in Plugin
/plugin marketplace add patch-gg/anymove /plugin install anymove@anymove
Install the anymove-reader skill in Claude Code
~/.claude/skills/anymove-reader/SKILL.md
$ npx degit patch-gg/anymove/skills/anymove-reader ~/.claude/skills/anymove-readerInstall the anymove-reader skill in Claude Code (project)
.claude/skills/anymove-reader/SKILL.md
$ npx degit patch-gg/anymove/skills/anymove-reader .claude/skills/anymove-readerInstall the anymove-reader skill in Codex
~/.agents/skills/anymove-reader/SKILL.md
$ npx degit patch-gg/anymove/skills/anymove-reader ~/.agents/skills/anymove-readerInstall the anymove-reader skill in Gemini CLI
~/.gemini/skills/anymove-reader/SKILL.md
$ npx degit patch-gg/anymove/skills/anymove-reader ~/.gemini/skills/anymove-readerInstall the anymove-reader skill in Claude.ai
npx degit patch-gg/anymove/skills/anymove-reader anymove-reader && zip -r anymove-reader.zip anymove-reader # claude.ai → Customize → Skills → + → Create skill → Upload a skill → anymove-reader.zip
SKILL.md
View on GitHubanymove-reader: teach DINOv2 one creature
The reader is trained on the creature itself, so it knows every joint name and every limb colour. Data is free: Blender poses the rig at random inside its joint limits and records where each joint lands in both views.
1. Render the dataset (about 25 min for 2,200 poses on one RTX 4090)
tools/dataset.sh <c> 2200 3 # 3 Blender processes -> runs/<c>/dataset/{00000_front.png, _side.png, _meta.json}
Half the poses spread uniformly over the limits, half stay near rest; the pelvis sometimes rears; half carry motion
blur from a random velocity (video models smear fast limbs); lights, turn (±30°, sometimes ±70°), position and
airtime are random. Open runs/<c>/dataset_samples.jpg: dots must sit on the joints. Interrupted renders resume:
samples that exist are skipped.
GPU budget on a 24 GB card under WSL: a reader training (about 12 GB) plus more than two Blender Cycles renders fills the card and everything stalls. Render first, or train beside at most two renders. Blender uses CUDA (OptiX is unreliable under WSL).
2. Train (17-20 min, 20 epochs)
tools/train.sh <c> 20 20 # runs/<c>/reader.pt; prints held-out error per epoch in layout pixels
Every render is laid on a fresh random backdrop and degraded like video (framing jitter, colour, blur, downscale, noise, JPEG) so the reader works on AI clips, not just clean renders. 4% of the samples are held out. The checkpoint is rewritten after each epoch.
What good looks like (front / side, layout pixels, after 20 epochs): spider 2.9 / 3.6, dragon 6.2 / 5.5, wolf 6.9 / 3.8, demon 8.4 / 9.4. Judge it against the creature's size in the frame: the demon stands 412 px tall, so 8.4 px is about 2% of its height, like the dragon. If the error stalls well above that, check the dataset sheet (dots off the joints means the layout in creature.json changed after rendering) and the joint limits.
3. The exam (optional, about 10 min): known motion in, error in centimetres out
A random smooth motion inside the limits is rendered in the same studio, read back and scored per joint.
export MOCAP_CREATURE=assets/<c>; R=assets/<c>/rigged; E=runs/<c>/exam
.venv/bin/python -m mocap.exam make $R/rig_info.json $E/truth.json 0 120
blender -b -P blender/apply_motion.py -- $R/rigged.blend $R/rig_info.json $E/truth.json $E/truth --views front,side --paint --blur
.venv/bin/python -m mocap.exam video $E/truth $E/exam.mp4 24
.venv/bin/python -m mocap.detect $E/exam.mp4 runs/<c>/reader.pt runs/<c>/ref/ref.png $E/det.npz --no-calib
.venv/bin/python -m mocap.solve $E/det.npz $R/rig_info.json $E/solved.json
blender -b -P blender/apply_motion.py -- $R/rigged.blend $R/rig_info.json $E/solved.json $E/solved
.venv/bin/python -m mocap.exam score $E/truth/joints.json $E/solved/joints.json
The wolf scored 0.94 cm mean 3D joint error on a 1.6 m body (median 0.63 cm, paws 1.5 cm, worst joint 3.4 cm).
When the reader struggles on real clips
- Joints jump between limbs: the limb colours in the clip drifted from the paint (anymove-film), or two limbs share similar colours. Repaint far-apart colours and retrain.
- A pose the clip shows never appeared in training (lying on its side, a full curl): widen that bone's limits in rig.json, rebuild the rig, render and train again. Random poses don't cover lying-down; captured motions would.
- Fur, cloth or ears flapping: the wolf's tracked-fur reader added a tip joint per fur bone
(
blender/add_fur_bones.py,blender/export_fur_rig_info.py) and read swings of 7-28° from the video.
Files in this skill
1anymove-reader skill questions
How do I install the anymove-reader skill in Claude Code?
Run npx degit patch-gg/anymove/skills/anymove-reader ~/.claude/skills/anymove-reader. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the anymove-reader skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.