clipshot README

The project's README from github.com/TanShilongMario/clipshot. As one markdown file: README.md.

ClipShot

License: MIT

把剧本、分镜脚本和人物或场景设定，转化为可拍摄的电影级九宫格分镜图与时间线镜头表。

本仓库是符合 Agent Skills 规范的独立 Skill：cinematic-storyboard-design。适用于 Cursor、Codex 及其他兼容该规范的 Agent。本轮发布不含案例图片。

它做什么

Skill 先读懂叙事、人物关系、空间和交付用途，再拆镜头，而不是直接出成片或概念海报。默认产出：

默认输出一套导演推荐方案。仅在探索阶段、用户明确要求，或同一剧情存在两种都成立的观看立场时，提供 A/B 双方案。双方案的剧情节拍和连续性锚点相同，观看立场、构图、景别、剪辑、运镜或转场至少三项形成整组差异。

适用与不适用

适用

不适用

安装

安装目录名必须是 cinematic-storyboard-design，以便与 Skill 的 name 字段一致。

Cursor 用户级

git clone https://github.com/TanShilongMario/clipshot.git cinematic-storyboard-design

将克隆得到的文件夹放到：

Windows 常见路径：

%USERPROFILE%\.cursor\skills\cinematic-storyboard-design

Cursor 项目级

把本仓库复制为项目内的：

.cursor/skills/cinematic-storyboard-design

或：

.agents/skills/cinematic-storyboard-design

从 GitHub 导入

在 Cursor 中打开 Customize → Rules → Add Rule → Remote Rule (Github)，填入：

https://github.com/TanShilongMario/clipshot

其他兼容 Agent

仓库根目录包含 SKILL.md。Codex 可使用 agents/openai.yaml 中的展示名和默认触发句。

使用

在对话中点名本 Skill，并提供剧本或本次要处理的片段。也可以直接使用：

使用 cinematic-storyboard-design 将我的剧本设计成一套镜头语言明确的九宫格电影分镜，并提供时间线镜头表。

生成前必须确认这三项，缺一项会先追问：

  1. 剧本正文或本次明确片段
  2. 成片用途与单格画幅：横屏 16:9，或竖屏 3:4 / 9:16
  3. 本轮覆盖范围：场次、时长或起止段落

人物与场景设定、时代地点、基调、目标时长、禁忌和参考作品属于强烈建议项。长剧本无法被一个九宫格清楚承载时，会先给出拆组建议，确认范围后再出图。

输入与输出

输入

  1. 剧本与整体设定
  2. 剧本加已有分镜脚本
  3. 上述内容再附人物、服装、道具、场景或视觉参考图

已有分镜脚本是创作约束，不是不可改的答案。写实参考图默认只作连续性，不继承摄影渲染风格。

输出顺序

  1. 必要时：缺失信息确认，或长剧本拆分建议
  2. 一段简短创作理解
  3. 九宫格分镜图
  4. 时间线分镜解读表
  5. 特殊镜头、转场与连续性提示

视觉语言是制作型故事板：钢笔或墨线画结构，马克笔或色块画光的位置和形态，不能交纯线稿。人物以结构人体为主，先读机位和姿态；近景和特写可有简单五官动态，手部姿势必须清楚。必须剔除照片、成片和角色插画完成度，避免下游再创作被锁死。生成后先检查实际图像；未过 GRID / STYLE / CONTINUITY / READABILITY / MOTION 门禁，以及动作或非常规镜头适用的表现力检查不得交付。详细说明放在图后的时间线表，不堆在格子里。

动作场面同时设计身体受力与摄影，按节拍选择蓄势、爆发和停顿，不固定套用景别顺序。特殊构图说明主体位置、裁切和空间锚点；特殊运镜说明起点、动作触发、路径、速度变化和落点。同一连续镜头可用 a/b/c 关键帧占用相邻格，注明无剪切，镜头总时长仅计算一次。九宫格保持等大，格内空间可以采用非常规切分。

仓库结构

clipshot/
├── SKILL.md                         # 主流程：输入确认、拆分、双方案、出图与交付
├── LICENSE                          # MIT
├── README.md
├── agents/
│   └── openai.yaml                  # Codex / ChatGPT 展示与默认触发句
└── references/
    ├── cinematic-language.md        # 镜头语言：景别、轴线、运镜、转场、差异检查
    ├── action-cinematography.md     # 动作受力、非常规构图、运镜路径与表现力审查
    ├── visual-production.md         # 九宫格规格、提示词、红线与视觉检查
    └── deliverable-schema.md        # 创作理解、时间线表、拆分建议、追问话术

Agent 先读 SKILL.md，再按任务按需读取 references/，避免一次装入全部细节。

协议

本仓库以 MIT License 发布。你可以自由使用、复制、修改、合并、发布和再分发，只需保留版权与许可声明。

后续

案例图片将另作补充，不包含在本轮发布中。每次请求只依据当次提供的剧本、设定和参考，不迁移其他项目的时代、角色、地点、画幅或视觉设定。

clipshot (TanShilongMario/clipshot)

Searching Database…

237 ·GitHub
Clipshot
这是什么？ClipShot 是一个 Agent Skill，能把剧本、现有分镜清单或角色/场景设定转化为电影感的 3x3 网格分镜图，外加一份带时间戳的镜头拆解表。
这是独立应用，还是安装到智能体里的东西？它是一个遵循 Agent Skills 规范的技能，可安装到 Cursor、Codex 或任何兼容该规范的智能体中——不是独立应用。
这个技能怎么安装和使用？克隆仓库，把文件夹（重命名为“cinematic-storyboard-design”）放到“~/.cursor/skills/”或“~/.agents/skills/”供用户级使用，复制到项目中供项目级使用，或者在 Cursor 中通过 Customize to Rules、Add Rule、Remote Rule (GitHub) 导入。
它能配合哪些智能体使用？它面向 Cursor 和 Codex，以及任何支持 Agent Skills 规范、能读取 SKILL.md 文件的智能体；Codex 则专门使用 agents/openai.yaml 中的显示名称和触发短语。
这个技能不适用于什么？它不适合生成照片级写实的成品画面、精修的概念海报/插画，也不适合把长剧本硬塞进单个 3x3 网格——它刻意在成品美术渲染之前止步。
最终输出实际包含什么？一份简短的创作意图摘要、一张严格的 3x3 网格分镜图、一份带时间码的镜头拆解表，以及在需要时提供的关于特殊镜头、转场和连贯性的补充说明。
分镜图采用什么视觉风格？它们是制作风格的分镜板：用钢笔/墨线勾勒结构，用马克笔或色块表现光影，采用简化的结构化人物造型，而非成品插画、照片或角色美术。
我能得到备选镜头方案，而不是单一固定版本吗？默认它给出一个导演推荐方案；只有在探索阶段或应要求时才提供 A/B 双方案，两个版本在视角、构图、景别、剪辑或运镜上有所不同，但保持相同的故事节拍。
为什么不直接生成成品画面？它有意剥离照片级写实、成品镜头和角色插画式的精修，让分镜保持为一个开放的蓝图，供下游美术人员继续再创作。
What are similar projects?holo-card-studio, eian-riso-broll, shuohao-skills, herk-edit-kit, photo-abstract-editorial, kid-papercraft, travel-memory-sticker-card, gathered-scenes-zine-skill
Which topics is it in?cursor-skills, storyboarding, creative-tools, codex-skill, content-creation, video-processing, design, skill, video, skills, agent-skills, agent
Creator
TanShilongMario
Size
0.1 MB
Stars
237
Updated
CommitSep 21
Age
1mo
Commits · 90 Days