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 плюс таблицу разбора кадров с таймкодами.
Это отдельное приложение или то, что я устанавливаю в агента?Это Skill, следующий спецификации Agent Skills, предназначенный для установки в Cursor, Codex или любого другого агента, совместимого с этой спецификацией, — а не отдельное приложение.
Как установить и использовать этот навык?Склонируйте репозиторий и поместите папку (переименованную в 'cinematic-storyboard-design') в '~/.cursor/skills/' или '~/.agents/skills/' для уровня пользователя, скопируйте её в проект для уровня проекта или импортируйте в Cursor через Customize to Rules, затем Add Rule to 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