story-director

story-director is a skill for Claude Code from ShuaiMXu/mv-skills-bundle. It costs 198 tokens per session (4,892 once invoked), scanned A, original, MIT.

A story-planning assistant that turns a rough idea into a structured storyline and a shot list. A shot list breaks a story into individual camera views, each with a purpose and visual direction.

In plain words
What is it for?
Use it to plan short dramas, animated stories, music videos, films, or other projects that need a complete story outline and scene-by-scene visual plan.
Why use it?
It helps organize vague ideas into a story with beats, turning points, emotional progression, and varied pacing. It also keeps characters and the story world consistent.

Skill for Claude Code

Written for Claude Code: user-invocable in frontmatter. Also seen: built for openclaw.

Good fit Use it to plan short dramas, animated stories, music videos, films, or other projects that need a complete story outline and scene-by-scene visual plan.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/shuaimxu/mv-skills-bundle/story-director
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add ShuaiMXu/mv-skills-bundle --skill story-director
Clone the repo
git clone --depth 1 https://github.com/ShuaiMXu/mv-skills-bundle

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for story-director

README.md
[![agentmods](https://agentmods.dev/badge/skills/shuaimxu/mv-skills-bundle/story-director/github.svg)](https://agentmods.dev/skills/shuaimxu/mv-skills-bundle/story-director)
Your own site
<a href="https://agentmods.dev/skills/shuaimxu/mv-skills-bundle/story-director"><img src="https://agentmods.dev/badge/skills/shuaimxu/mv-skills-bundle/story-director/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for story-director

Your own site · 80×15
<a href="https://agentmods.dev/skills/shuaimxu/mv-skills-bundle/story-director"><img src="https://agentmods.dev/badge/skills/shuaimxu/mv-skills-bundle/story-director.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 198 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,892 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00198 $0.04892
Opus 5.5 $0.00079 $0.01957
Sonnet 5.5 $0.00040 $0.00978
Haiku 4.5 $0.00020 $0.00489

Measured 1mo ago against content hash bcc81fe40506, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

story-director scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

story-director/SKILL.md · 421 lines

How it starts

The opening of the file, as written. The whole thing — 421 lines — stays where its author put it; the contents beside it link to each section on GitHub.

🎬 导演 · 故事编排助手

你是导演助手。用户有一个故事想法——可能很模糊(「小和尚下山」),也可能很具体(三页剧本大纲)。你帮他把这个想法编排成一条精彩的故事线,拆成可执行的分镜表,让每一个镜头都有存在的理由。


📌 定位与边界

在创作流水线中的位置

story-director(本技能)      shot-optimizer           libtv-skill
     故事编排                    逐镜头打磨              生成出片
        │                           │                       │
  概念 → 故事线 → 分镜表      每个镜头 → V1/V2/V3     选定方案 → 原文传话
        │                           │                       │
        └─── 输出给 ──────────────→ └─── 选定后交给 ──────→ │

本技能负责

  • 把模糊概念变成有结构的故事(节拍、转折、情绪弧线)
  • 把故事拆成分镜表(每个镜头的叙事目的 + 视觉方向概述)
  • 把控整体节奏和张力(不是每个镜头都一样的节奏)
  • 保持角色和世界观的一致性

本技能不负责

  • 把每个镜头打磨成高质量提示词(那是 shot-optimizer 的活)
  • 选模型、选参数(那是 seedance-2-guide 的活)
  • 调用生成 API(那是 libtv-skill 的活)

分镜表里每个镜头的描述是"导演指令"级别的 —— 说清楚「这个镜头要什么」,但不需要精确到提示词的七个维度(那是 shot-optimizer 的事)。


🎯 核心工作流

第一步:理解概念(CONCEPT)

用户给的可能是一句话,也可能是一页纸。不管多少,你先做三件事:

  1. 提炼核心:这个故事到底在讲什么?一句话的故事核心是什么?
  2. 确认基础信息(如果用户没提,主动问):
信息 为什么要问 示例
时长 / 镜头数 决定故事的容量和节奏密度 「8 镜头的短漫剧」「1 分钟 MV」
风格基调 决定情绪和视觉方向 「治愈系」「悬疑」「赛博朋克」「古风」
核心角色 决定故事的聚焦点 「一个小和尚」「一对母女」
想传递的情绪 最终观众应该感受到什么 「释然」「震撼」「温暖」「恐惧」
  1. 确认后进入第二步。如果用户给的信息已经够了,直接往下走不要磨叽。
示例

用户:小和尚下山的故事,古风治愈,8 个镜头

AI:好,我抓到的核心是——「一个小和尚第一次离开寺庙走向山下世间,从好奇到感悟」。8 个镜头、古风治愈,这些够了。我直接来排故事线。


第二步:搭故事线(STRUCTURE)

这是本技能最核心的步骤。把概念变成一条有节奏起伏的故事线。

故事线的基本结构

不强制用三幕剧或英雄之旅,但任何好故事都需要:

要素 说明 不能缺
开场 建立世界、角色、基调。观众 3 秒内要知道「在看什么」 ✅
触发 打破常态的事件。故事从这里「开始」 ✅
发展 主角在行动中遭遇变化、挑战、发现 ✅
高潮 / 转折 情绪最强的一刻。整个故事的记忆点 ✅
落点 故事的余韵。观众带走的情绪 ✅
节奏曲线

每个故事都有情绪节奏。你要画出来(用文字描述即可):

情绪强度

  ▲
  │         ★ 高潮
  │        ╱ ╲
  │      ╱     ╲
  │    ╱   发展   ╲  落点
  │  ╱             ╲___
  │╱ 开场  触发
  └──────────────────────→ 时间

关键原则:

  • 不是每个镜头都要"精彩"——有张有弛才有节奏
  • 安静的镜头为高潮蓄力,高潮的冲击力来自前面的铺垫
  • 最后一个镜头决定观众带走什么情绪——它的重要性仅次于高潮
输出格式

Read the full file on GitHub · 421 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 421 lines · 198 tokens per session scan A bcc81fe40506

Subscribe to this mod's changes

story-director is a skill published in the GitHub repository ShuaiMXu/mv-skills-bundle (14 stars, last pushed 5mo ago), licensed MIT. It adds 198 tokens to every session and 4,892 once invoked, about $0.0008 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

sketch-correction-worker

Use when doing single-beat sketch quality control and preparing correction labels from a SuperTale project path and episode number. This skill turns one episode's selected sketches plus local script beat data into selectresult.jsonl, selectsummary.json, tasks.jsonl, and labels.jsonl for edit execution. Prefer using…

dramaclaw/dramaclaw · 88 tokens

freezone

Use when the active chat surface is 虾画/Freezone/canvas, or when the user asks about canvas nodes, visual boards, selections, graph edits, canvas actions, layout, or Freezone short-video workflow work.

dramaclaw/dramaclaw · 49 tokens

dramaclaw-workflows

Create, revise, confirm, run, or resume multi-node DramaClaw Freezone canvas workflows. Use for requests involving a workflow, several connected nodes, grouped production stages, storyboards, or text/image/video/audio pipelines; do not use for one standalone canvas operation.

dramaclaw/dramaclaw · 60 tokens

workflows

Use in Freezone/虾画 chat when the user selects a Skill or asks to create, plan, analyze, or expand a dynamic canvas workflow for short drama, ads, ecommerce, product video, MV, text, image, video, or audio production.

dramaclaw/dramaclaw · 56 tokens

dramaclaw

Use for explicit DramaClaw/虾导 production work: ingesting a screenplay; checking or resuming a bound pipeline; generating or displaying portraits, identity images, sketches, first frames, audio, beat videos or final episodes; and reading or updating project artifacts. Also use for identity questions. Generic…

dramaclaw/dramaclaw · 87 tokens

sketch-storyboard-director

Use when doing a separate post-QC storyboard-directing pass on SuperTale sketches. This skill focuses on shot scale, camera angle, staging, composition, and beat-to-beat visual rhythm after basic sketch correctness has already passed QC.

dramaclaw/dramaclaw · 55 tokens