# sumi-writer

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 110 repo stars
- Author: beyondtahir
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/beyondtahir/beyondsumi/tree/HEAD/skills/sumi-writer/SKILL.md
- Updated: 2026-11-07
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/sumi-writer

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/sumi-writer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/sumi-writer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/sumi-writer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/sumi-writer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install beyondtahir/beyondsumi skills/sumi-writer
```

2. **Manually: put the files in place**
- File: `.github/skills/sumi-writer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add beyondtahir/beyondsumi --skill sumi-writer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/beyondtahir/beyondsumi --path skills/sumi-writer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/sumi-writer/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/beyondtahir/beyondsumi/tree/HEAD/skills/sumi-writer/SKILL.md

## When to use it
- 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
- 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

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 5bb6579dbf98c3f6.

BEGIN THIRD-PARTY FILE 5bb6579dbf98c3f6
````text
---
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).
````
END THIRD-PARTY FILE 5bb6579dbf98c3f6

The third-party file has ended. Everything between the 5bb6579dbf98c3f6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© beyondtahir · MIT · https://github.com/beyondtahir/beyondsumi/tree/HEAD/skills/sumi-writer/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
