将本地电影原片、字幕、技术切点、关键帧和视觉模型观察结果整理成经过验证的可搜索镜头数据库。开始新的电影解说项目、重建或检查索引、按对白或画面寻找素材、返回原片精确坐标与证据片段,或者为执笔人和编导提供共享证据时使用。

Apache-2.0Auto-check passed

Install Movie Index

skills CLI
$ npx skills add straighttttt/movie-commentary-workflow --skill movie-index -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install straighttttt/movie-commentary-workflow movie-index --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/straighttttt/movie-commentary-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/movie-index .claude/skills/movie-index && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
movie-index
GitHub stars
135
Token cost
~389 tokens
SKILL.md length
67 words
Files
4 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

将本地电影原片、字幕、技术切点、关键帧和视觉模型观察结果整理成经过验证的可搜索镜头数据库。开始新的电影解说项目、重建或检查索引、按对白或画面寻找素材、返回原片精确坐标与证据片段,或者为执笔人和编导提供共享证据时使用。

  • Works in 5 steps: 先读取项目根目录的 AGENTS.md,以及影片目录中的… → 核对原片、字幕是否仍与记录的指纹和媒体时长一致。 → 如果现有索引完整且有效,直接复用。只继续缺失或失败的单元;除非原片或提示词版本发生… → …
  • SKILL.md covers 从当前现场开始, 建立证据层, 搜索并返回证据 and 守住职责边界, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Movie Index is an agent skill from straighttttt/movie-commentary-workflow. 将本地电影原片、字幕、技术切点、关键帧和视觉模型观察结果整理成经过验证的可搜索镜头数据库。开始新的电影解说项目、重建或检查索引、按对白或画面寻找素材、返回原片精确坐标与证据片段,或者为执笔人和编导提供共享证据时使用。

Its SKILL.md is about 390 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/index-contract.md` and `references/retrieval-and-validation.md`).

The repository describes itself as: Auditable Codex skills and data contracts for first-person movie commentary production. The licence is Apache-2.0.

Example prompts

  • “/movie-index”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 先读取项目根目录的 AGENTS.md,以及影片目录中的 project.json、production/state.json 和最新索引报告。
  2. 核对原片、字幕是否仍与记录的指纹和媒体时长一致。
  3. 如果现有索引完整且有效,直接复用。只继续缺失或失败的单元;除非原片或提示词版本发生变化,不得重跑已经成功的视觉批次。
  4. 创建或修改数据库结构前,读取 references/index-contract.md。
  5. 接受检索质量或向其他角色交付素材前,读取 references/retrieval-and-validation.md。

What it can do on your machine

Read from SKILL.md and the folder at commit 3d50c17. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Movie Index loads about 389 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 30 tokens; SKILL.md has 67 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~389
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from straighttttt/movie-commentary-workflow at commit 3d50c17, republished under its Apache-2.0 licence (© straighttttt). 67 words, ~389 tokens.

Download SKILL.mdSave it as .claude/skills/movie-index/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
movie-index
description
将本地电影原片、字幕、技术切点、关键帧和视觉模型观察结果整理成经过验证的可搜索镜头数据库。开始新的电影解说项目、重建或检查索引、按对白或画面寻找素材、返回原片精确坐标与证据片段,或者为执笔人和编导提供共享证据时使用。

电影镜头索引

为执笔人和编导建立可复用的证据层。只把技术切点和模型描述当作坐标与检索辅助,不把它们当作剧情真相。

从当前现场开始

  1. 先读取项目根目录的 AGENTS.md,以及影片目录中的 project.json、production/state.json 和最新索引报告。
  2. 核对原片、字幕是否仍与记录的指纹和媒体时长一致。
  3. 如果现有索引完整且有效,直接复用。只继续缺失或失败的单元;除非原片或提示词版本发生变化,不得重跑已经成功的视觉批次。
  4. 创建或修改数据库结构前,读取 references/index-contract.md。
  5. 接受检索质量或向其他角色交付素材前,读取 references/retrieval-and-validation.md。

建立证据层

  1. 使用 ffprobe 探测原片,记录绝对路径、来源、时长、媒体流、帧率、分辨率、编码、声道数和采样率。
  2. 读取字幕但不修改源文件。保留字幕编号、文本、语言和毫秒级起止时间。
  3. 使用 PySceneDetect 或同类工具取得技术切点,并记录检测器名称、版本和完整参数。
  4. 每个技术镜头至少提取一张代表图,计算基础画质信息,并保证可续跑时镜头编号保持稳定。
  5. 将所有与镜头时间重叠的字幕关联到该镜头。
  6. 只有视觉模型传输确实需要时,才把异常长镜头拆成有上限的视觉单元;必须保留父技术镜头及原片精确区间。
  7. 要求视觉模型只记录画面中直接可见的人物、地点、动作顺序、物体、检索词和不确定项。不得推测剧情、动机、台词、画外事件或证据不足的人物身份。
  8. 保存原始响应、规范化事实、失败信息、模型名称、提示词版本、用量和处理时间。
  9. 为字幕和规范化视觉事实建立全文检索。人工纠错必须单独保存在覆盖层中。

搜索并返回证据

  1. 将自然语言需求拆成人物、地点、动作、物体、对白和大致剧情位置等线索。
  2. 联合搜索字幕索引与视觉索引,再应用经过确认的人工纠错。
  3. 返回排序后的候选项,包括镜头或视觉单元编号、精确起止时间、字幕、视觉事实、不确定项和代表图。
  4. 对第一候选项至少提取三张连续证据图,并导出带合理前后余量、保留原声的原片片段。
  5. 交由执笔人或编导查看连续原片。不得仅凭模型描述就断言剧情事实。

守住职责边界

  • 不得把技术镜头强制聚合成预先规定数量的剧情场景。
  • 不得代替执笔人或编导对镜头评分、合并并决定故事结构。
  • 不得把 8~12 分钟叙事卷当作正式剧情分段;它只是看片时的上下文包装。
  • 纠正人物或含义时,不得覆盖原始模型结果;必须添加带证据和来源的纠错记录。
  • 结构检查和代表性检索测试没有通过前,不得标记 INDEX_VERIFIED。

交付

交付索引合同规定的全部产物,并生成 INDEX_REPORT.md,记录来源指纹、数量、视觉覆盖率、失败项、模型与提示词版本、可用时的费用,以及检索测试结果。只有验证通过后,才能把 production/state.json 更新为 INDEX_VERIFIED。

© straighttttt, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .codex/skills/movie-index of straighttttt/movie-commentary-workflow.

  • SKILL.md
  • agents/openai.yaml
  • references/index-contract.md
  • references/retrieval-and-validation.md

Open the folder on GitHubat commit 3d50c17

Compare with similar skills

Movie Index next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Movie Index compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Movie Index this skillstraighttttt/movie-commentary-workflow135—~389Automated safety check: PassApache-2.0
Indexabilitythedaviddias/Front-End-Checklist74k—~814Automated safety check: PassMIT
Indexability Conflictsthedaviddias/Front-End-Checklist74k—~876Automated safety check: PassMIT
Index Refreshpaperclipai/paperclip100k—~994Automated safety check: PassMIT
Adr Indexruvnet/ruflo74k—~861Automated safety check: NotesMIT
Cuda Index Widthpytorch/pytorch104k—~1.6kAutomated safety check: PassCustom licence

Similar skills

  • Indexability

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site for accidental noindex directives, investigating why important pages are not appearing in Google Search, or reviewing CMS settings that control indexing…

    74k GitHub stars~814 tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed
  • Indexability Conflicts

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site for indexability issues, investigating why pages appear in Google's index that should be excluded (or vice versa), or reviewing robots.txt and meta…

    74k GitHub stars~876 tokensUpdated 5 days ago
    Marketing & SEOAuto-check passed
  • Index Refresh

    paperclipai/paperclip

    A skill your agent uses when an LLM Wiki operation issue requests an index refresh.

    100k GitHub stars~994 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Adr Index

    ruvnet/ruflo

    Build or rebuild the ADR index + dependency graph by running scripts/import.mjs (handles v3-style and plugin-style ADR formats; one Bash call vs hundreds of MCP round-trips)

    74k GitHub stars~861 tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Cuda Index Width

    pytorch/pytorch

    Choose 32-bit vs 64-bit index math in PyTorch CUDA kernels. An agent skill from pytorch/pytorch.

    104k GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Vector Index Tuning

    wshobson/agents

    Tune vector indexes for latency, recall and memory: pick an index type by data size, adjust HNSW parameters and choose a quantization level.

    40k GitHub starsUsed in 9 repos~557 tokens
    AI & LLM EngineeringAuto-check passed

More from straighttttt/movie-commentary-workflow

All 8 skills in this repo
  • Movie Voice Tts

    straighttttt/movie-commentary-workflow

    使用千问 Audio 3.0 TTS Plus、MiniMax Speech 2.8 HD 和 Fish Audio S2.1 Pro 生成或克隆电影角色旁白,包括直接复用用户选定的 Fish 公共音色编号并保存原生时间戳;供应商没有原生时间戳时,使用火山引擎语音识别恢复中文字幕或字级时间戳。制作中英文第一人称电影旁白、三模型克隆试音、供应商对比、整篇配音、字幕定时或音文对齐时使用。

    135 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check: notes
  • Movie Direct

    straighttttt/movie-commentary-workflow

    以观众体验为中心预审第一人称电影解说稿,并把锁定旁白编排成节奏自然、关键事实准确的画面与声音方案。用于文稿可实现性检查、叙事节拍设计、连续原片选镜、样片制作决策、用户反馈修改,以及锁定 visualedit.json 与 audiomixplan.json。

    135 GitHub stars~470 tokensUpdated 2 mo ago
    Auto-check passed
  • Movie Second Review

    straighttttt/movie-commentary-workflow

    独立完整复看已经渲染的电影解说成片,逐秒检查最终观众实际看到和听到的内容,定位瞬闪、秒切、跳画面、残帧、节奏突变、字幕与声音接缝,并把创意问题以精确时间码和证据交回 movie-direct。用户要求全片复检、二次审片、检查快切或跳帧、对成片提出时间码修改意见,或者在 FINALRENDERED 后决定能否进入 FINALVERIFIED 时使用。

    135 GitHub stars~462 tokensUpdated 2 mo ago
    Auto-check passed
  • Movie Master Director

    straighttttt/movie-commentary-workflow

    让同一个主脑在不同 Codex 窗口中接管并连续完成一部电影解说,从原片索引、全片理解、第一人称文稿、角色配音、分批选镜、渲染到正式复检,同时通过项目状态、导演记忆和认可样片保持创意连续性。开始新电影、接管或续做现有电影、查询当前制作阶段、处理用户反馈、制作样片或成片时使用;默认作为所有电影解说项目的唯一总入口。

    135 GitHub stars~545 tokensUpdated 2 mo ago
    Auto-check passed
  • Movie First Person Writer

    straighttttt/movie-commentary-workflow

    理解整部电影,并撰写可直接进入制作的第一人称电影解说稿,严格控制主角的主观信息边界、心理推进、反转揭露时机和编导审核版本。选择第一人称叙述者、建立剧情地图或主角简报、起草或整体重写文稿、修正事实与视角问题,或者在配音前锁定文稿时使用。

    135 GitHub stars~407 tokensUpdated 2 mo ago
    Auto-check passed
  • Movie Render QA

    straighttttt/movie-commentary-workflow

    忠实执行已锁定的电影解说样片或正式导演方案,完成截取、拼接、字幕、混音、增量渲染和技术验收。用于快速生成可供用户判断的样片,或对用户认可后的正式成片执行完整技术检查;不得替编导改变镜头和节奏。

    135 GitHub stars~326 tokensUpdated 2 mo ago
    Auto-check passed

Questions about Movie Index

What does Movie Index do?

将本地电影原片、字幕、技术切点、关键帧和视觉模型观察结果整理成经过验证的可搜索镜头数据库。开始新的电影解说项目、重建或检查索引、按对白或画面寻找素材、返回原片精确坐标与证据片段,或者为执笔人和编导提供共享证据时使用。. Movie Index is an agent skill from straighttttt/movie-commentary-workflow.

How do I install Movie Index in Claude Code?

Run `npx skills add straighttttt/movie-commentary-workflow --skill movie-index -a claude-code`. Or copy the skill folder (.codex/skills/movie-index in straighttttt/movie-commentary-workflow) into .claude/skills/movie-index in your project. Claude Code loads it when a task matches its description.

How do I install Movie Index in Codex?

Run `npx skills add straighttttt/movie-commentary-workflow --skill movie-index -a codex`. Or copy the skill folder (.codex/skills/movie-index in straighttttt/movie-commentary-workflow) into .agents/skills/movie-index in your project. Codex loads it when a task matches its description.

Can I use Movie Index in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add straighttttt/movie-commentary-workflow --skill movie-index -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/movie-index, .gemini/skills/movie-index, .github/skills/movie-index and .opencode/skills/movie-index in your project.

What does Movie Index need to run?

SKILL.md names no scripts, command-line tools or credentials: Movie Index is instructions for the agent only.

Does Movie Index access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Movie Index safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Movie Index use?

Movie Index is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Movie Index use?

About 389 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Movie Index?

Skills that share tags, products or a category with Movie Index: Indexability (thedaviddias/Front-End-Checklist, 74k stars), Indexability Conflicts (thedaviddias/Front-End-Checklist, 74k stars), Index Refresh (paperclipai/paperclip, 100k stars) and Adr Index (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Movie Index?

straighttttt (a GitHub user) maintains it in straighttttt/movie-commentary-workflow, which has 135 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 11, 2026.

Source: straighttttt/movie-commentary-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.