code-poem-film skill
A skill that turns a poem into a 20–80 second ink-wash 2D animation: frames drawn by code, music synthesised with numpy.
- 64 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill runs Python scripts and ffmpeg in the project folder and writes clip files.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/code-poem-filmDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill runs Python scripts and ffmpeg in the project folder and writes clip files.
This is third-party code. Review the repository files before installing.
What it does
You name a poem and the skill makes a short ink-wash animation. A red dot lands on rice paper, grows eyes and walks through the poem line by line; each line is written on a caption in time with the reading, and the last one is written by the dot itself and becomes a seal. Code draws every frame and numpy synthesises music and sound effects, with no images, footage or ready tracks. The workflow: confirm the subject and narration, a free dry run, narration, music ducked under the voice, frame checks and rendering. The output is a finished clip, an upload version, a cover and a post draft.
Who it is for. Short-video authors and fans of classical Chinese poetry who want an animated clip of a poem with no art assets or stock.
Good fit when
- A clip of a poem such as Quiet Night Thoughts is needed for social media.
- You want to plan a scene in advance without paying for a dry run.
- Narration and music must come from a system voice and synthesis with no external tracks.
- Frames need a check for empty and white frames before rendering.
Not a fit when
- A vertical format is needed: only horizontal 16:9 is supported.
- Characters with facial expression and acting are needed.
- Automatic word-to-audio alignment is required.
Example request
Make an animation of the poem Climbing Stork Tower with system narration, showing the storyboard and a dry run first.Limitations
Only horizontal 16:9 is supported. Characters are faceless distant silhouettes that cannot act, and the lead is always the red dot. Per-character timing of the last line, written by the dot itself, is marked by hand against a spectrogram. A machine cannot judge voice quality: loudness and frequency bands are measured, but a person must listen. The author tested narration through `say` and a custom plugin, but not `edge-tts` or `command`. Installation in Codex and other agents was not tested.
How to disable. Delete the `~/.claude/skills/code-poem-film` folder. Projects with finished clips live in your own folders and are removed separately.
FAQ
What must be installed?
Claude Code, Node.js 20 or newer, Python 3.10 with `numpy` and `pillow` and ffmpeg. Rendering uses HyperFrames and is called through `npx`.
Can I try it without AI?
Yes. The `scripts/new_project.py` command creates a project from a ready example, and it can be run by hand following the README.
Which examples exist?
Two clips: a 25.5 second Leaving Baidi at Dawn and a 72 second Red Cliff nostalgia piece.
Is a paid narration service needed?
No, system narration works. Paid engines are connected through a plugin, but the author did not test them.
How does the skill check frames?
A script looks for white and empty frames, a missing red dot and render errors, then builds an overview strip at one frame per second.
Discussion
No questions or reviews yet.
Related
SkillsA Claude Code skill for short animated videos drawn in code: seven styles, story and storyboard sign-off, voice-over and an MP4 render
A skill that turns a classical Chinese poem into a vertical 1080x1920 ink-painting video with brush-calligraphy captions and retained ambient sound
A skill that makes promo videos from code: direction, in-browser animation with motion blur, its own score and a 60 fps MP4
A skill that makes a music video for your song: every frame is drawn by code and six steps with pauses lead from analysis to edit
A skill that turns Chinese story copy or a set of ordered images into a vertical hand-drawn animation, a silent diary-comic picture track
Two Claude Code skills for videos made entirely in code: hand-painted watercolour animation and kinetic typography reels
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| code-poem-film (this card) | no | 64 | |
| HBG Classical Poem Silk Video | no | 389 | makes classical poetry video another way; here the ink-wash animation comes from code |
| HyperFrames | no | 83,841 | an HTML-to-video render engine; the skill uses it for the final clip |
README in short
The skill makes a short ink-wash cartoon from a poem: code draws frames, numpy synthesises audio, and the output is a clip, a cover and a post draft.