Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/sumi-writer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sumi-writer/

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

Similar skills

All skills for Writing and docs →

From the same set11

The whole set →
beyondsumi beyondsumi is a Claude Code plugin that guides frame-by-frame animation from script to sound. Start with an idea, a story, or a recording. CX Codex ★ 110repo stars sumi-elevenlabs sumi-elevenlabs is a Claude Code skill that connects ElevenLabs and helps select narration voices and models for story videos. It estimates character-based charges before paid generation and waits for approval. CX Codex +1 ★ 110repo stars sumi-voicebox sumi-voicebox is a Claude Code skill that configures local Voicebox narration for Sumi videos. It triggers when choosing on-device voice generation without cloud API costs. CX Codex +1 ★ 110repo stars sumi-artist sumi-artist is a Claude Code skill for creating characters, key scenes, and backgrounds in Sumi Dark or Sumi Light. It starts after the director approves the shot plan. CX Codex +1 ★ 110repo stars sumi-director sumi-director is a Claude Code skill that turns an approved script into a shot plan. It runs after script approval and before artwork begins. CX Codex +1 ★ 110repo stars sumi-animator sumi-animator is a Claude Code skill that builds frame-by-frame 2D animation from approved shots. The skill plans key poses, in-between sheets, layers, cutting, and lip-sync against voice tracks. CX Codex +1 ★ 110repo stars sumi-sound sumi-sound is a Claude Code skill that builds a film’s audio after the shot plan is approved. It handles voice, music, and effects, or supports a film with no narration. CX Codex +1 ★ 110repo stars sumi-vector sumi-vector is a Claude Code skill that builds 2D vector animations in JavaScript using p5.brush. It renders ink silhouettes and painted skies without image generation APIs. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open