sumi-writer — Claude Code skill: what it does, how to install
sumi-writer is a Claude Code skill that turns ideas into animated short film scripts. It structures the narrative into emotional beats and saves the final cut to script.md.
MIT ★ 110 updated 2026-11-07
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a claude-codeWhat sumi-writer does
The skill drafts short animated film scripts from rough ideas or adapts existing drafts while preserving the original meaning. It prioritises visual storytelling by replacing exposition with concrete actions on screen. Each story begins with an immediate hook and ends with a resolution that answers it.
The script format breaks narrative into distinct beats. Each beat records a single feeling, the action under SEEN:, and dialogue or voiceover lines. When on-screen text differs from spoken words, the skill inserts short CAPTION: entries. If a story exceeds the target run time, it provides an estimate along with a trimmed alternative instead of quietly rushing dialogue.
Framing, style, and camera angles remain strictly excluded from the writer's scope, as visual direction belongs to the director phase. The finished draft requires user approval before advancing to script.md.
What it helps with
- write an animated short film script from an outline
- adapt an existing script into scene actions and beats
- check script timing and generate a concise cut to fit length limits
- structure spoken lines alongside on-screen CAPTION elements
Example prompts for the agent
- Write a 60-second animated short script based on this concept
- Adapt this story draft into beats with visual actions and clear emotions
- Check if this script fits 45 seconds and show a shorter alternative if needed
How to install sumi-writer
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a claude-code2Manually: put the files in place
~/.claude/skills/sumi-writer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumi-writer/
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a codex2Manually: put the files in place
.agents/skills/sumi-writer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a cursor2Manually: put the files in place
.cursor/skills/sumi-writer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install beyondtahir/beyondsumi skills/sumi-writer2Manually: put the files in place
.github/skills/sumi-writer/SKILL.md1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a gemini-cli2Platform CLI
gemini skills install https://github.com/beyondtahir/beyondsumi --path skills/sumi-writerManually: put the files in place
.devin/skills/sumi-writer/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 sumi-writer
How to install sumi-writer in Claude Code?
Run npx skills add beyondtahir/beyondsumi --skill sumi-writer -a claude-code in your terminal.
What does sumi-writer do?
It generates beat-by-beat animated film scripts with explicit emotional cues and visual descriptions, exporting the result to script.md.
Does sumi-writer handle camera framing and visual style?
No, camera choices, framing, and visual design belong to the director role; this skill focuses purely on script beats and dialogue.
Source text
SKILL.md · MIT
--- name: sumi-writer description: "The Beyondsumi story writer. Write a story from an idea, or fix a script someone gives you, so it works as a short animated film. Use as the first step of a Sumi film." --- # The Writer You are a storyteller who writes for the screen. Every line you write has to become drawings, and every drawing costs an animator hours, so you write what can be seen and felt. ## Your job 1. **Understand the request:** idea or finished script, who it is for, how it should feel, anything it must keep, length, language, and narrator, character dialogue or both. Ask only what is missing. 2. **Keep the user's meaning.** If they gave a script, fix it without changing what it is about. Show every change. If they say to keep it word for word, change nothing and only report problems. 3. **Make it work on screen:** - **Hook:** the first seconds must make people want the answer. - **One feeling at a time:** each beat has one clear emotion. - **Show, don't explain:** replace a line of explanation with something a character does. - **An ending that pays off the hook and gives a clear answer.** See [scene logic](../sumi-director/references/scene-logic.md). 4. **Check the length** with [script duration](references/script-duration.md). If the story does not fit, show the real estimate and one concrete shorter version, and let the user choose. Never cut beats, rush speech or pad silently. 5. **Save `script.md`** and get approval. Nothing moves to the Director without it. More detail: [story writing](references/story-writing.md). ## Script format ```text # Title Length: about 60 seconds. Language: Roman Urdu. Telling: narrator with one line of dialogue. BEAT 1, the hook. Feeling: unease. NARRATOR: The invitation came from a ten-year-old king. SEEN: A sealed letter on a dark table. A hand reaches for it, then stops. ``` Every beat names its feeling and what we see. The Director builds the shots from this. Add a `CAPTION:` line when the words on screen should differ from the words spoken, such as only "NEVER." on a big moment. Short captions hit harder. See [directing captions](../sumi-director/references/captions.md). ## Your limits - Do not choose camera, framing or style. That is the Director's job, though you may suggest a style in one line. - For real history or real people, separate what is known from what is dramatised, and tell the user which is which. - **Write in the story's own language and script,** such as Urdu in Urdu script, because that is what the voice reads. Put what appears on screen in `CAPTION:` lines, which may use a different script, such as Roman Urdu. - A story's language is written by you. Whether it can be spoken depends on the voice tool, so leave that to [Sound](../sumi-sound/SKILL.md).
© beyondtahir · MIT · beyondtahir/beyondsumi