poetry-cinema-page — Claude Code skill: cinematic poem pages
poetry-cinema-page turns a classical Chinese poem into a scroll-driven page with a matched image set, generated narration and a line-by-line reading.
no license ★ 297 updated 2026-10-29
npx skills add wwwzhouhui/skills_collection --skill poetry-cinema-page -a claude-codeWhat poetry-cinema-page does
The skill takes a poem, ci, qu or prose-poem and lays it out as film-like scenes on a single page. It inspects the repo first (framework, build scripts, existing routes) and stays on the current stack. The text is then split into 5–8 visual beats grouped by imagery and emotional turns, not by equal line counts.
Images come from the bundled CLI scripts/ark_image.py, which talks to two providers: Volcengine Ark with Doubao Seedream 5.0 and a third-party GPT-Image gateway. The tier decides the provider, so both can appear in one poem. A hero frame is generated first with text-to-image; every beat after it goes through image-to-image with the hero as reference, and that is what holds period and palette together. Run python scripts/ark_image.py probe before spending anything — it resolves keys and model ids without billing an image.
Narration is produced, not supplied: edge-tts runs locally with no key, or Doubao seed-tts uses the same Ark key. A Remotion render can turn finished scenes and subtitles into a voiceover video on the narration timeline. One trap on the gateway: reference images work only as multipart POST /images/edits. Point the call at /images/generations and the reference fields are dropped silently, so you get a 200 and a fresh picture with the chain gone.
What it helps with
- build a scroll-driven long-form page from a poem
- keep one visual world across every generated image
- get a spoken narration without recording a voice
- check keys and model ids before paying for images
- cut finished scenes into a subtitled narrated video
Example prompts for the agent
- Make a cinematic page for this poem: 5–8 beats, and run
python scripts/ark_image.py probefirst. - Generate the narration with
edge-ttsand cut the finished scenes into a Remotion video with subtitles. - Regenerate scene 3 so the character still matches
hero.jpg.
How to install poetry-cinema-page
1Skills CLI (Vercel)
npx skills add wwwzhouhui/skills_collection --skill poetry-cinema-page -a claude-code2Manually: put the files in place
~/.claude/skills/poetry-cinema-page/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/poetry-cinema-page/
1Skills CLI (Vercel)
npx skills add wwwzhouhui/skills_collection --skill poetry-cinema-page -a codex2Manually: put the files in place
.agents/skills/poetry-cinema-page/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add wwwzhouhui/skills_collection --skill poetry-cinema-page -a cursor2Manually: put the files in place
.cursor/skills/poetry-cinema-page/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install wwwzhouhui/skills_collection poetry-cinema-page2Manually: put the files in place
.github/skills/poetry-cinema-page/SKILL.md1Skills CLI (Vercel)
npx skills add wwwzhouhui/skills_collection --skill poetry-cinema-page -a gemini-cli2Platform CLI
gemini skills install https://github.com/wwwzhouhui/skills_collection --path poetry-cinema-pageManually: put the files in place
.devin/skills/poetry-cinema-page/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about poetry-cinema-page
How do I install poetry-cinema-page in Claude Code?
Run npx skills add wwwzhouhui/skills_collection --skill poetry-cinema-page -a claude-code. The skill lands at ~/.claude/skills/poetry-cinema-page/SKILL.md.
What does poetry-cinema-page do?
It maps a poem onto visual scenes, generates a consistent image set from a hero reference, adds narration and a line-by-line reading, then builds the project and inspects the page in a browser.
What do I need before generating images?
A key for Volcengine Ark or the Claude-Image gateway, confirmed with python scripts/ark_image.py probe. Narration can run locally through edge-tts with no key at all.