HandDraw Skill

Create an editable animation project, validate the DSL, render it, and verify the MP4. Use the portable scripts/handdraw.mjs CLI from this skill root.

Workflow

1. Convert the request into short scenes with one visual concept each.
2. Create project.json from the schema in references/dsl.md. Use seconds for all timing.
3. Use only local, path-oriented SVG assets. Put them in an assets/ folder next to the project. Do not use raster images or text-to-video models.
4. Keep each scene at eight objects or fewer. Give every visible object an explicit animation.
5. Run node scripts/check-environment.mjs once on a new machine. Fix every missing dependency.
6. Run node scripts/handdraw.mjs validate <project.json> and fix every error.
7. When narration is requested, add audio.narration clips as described in references/dsl.md. Use the free Edge TTS provider by default; it needs network access but no API key, account, or paid API.
8. Render with node scripts/handdraw.mjs render <project.json> --output <video.mp4> --assets <assets-dir>.
9. Confirm the MP4 exists and contains both video and audio streams when narration was requested.

Animation choices