Content
63%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A dense, highly prescriptive instruction skill with an unusually concrete output contract (shot_design fields, state-key formats, incremental delta rules) and a clear planning-to-review pipeline. Its main costs are cross-section repetition of the same continuity and segment-count rules, and a monolithic single-file layout with no worked example to anchor the format.
Suggestions
Consolidate the repeated rules (segment-count flexibility, cut-point/state inheritance, preserving original dialogue) into a single cross-shot-contract section referenced from the others — each is currently stated 2-3 times in different sections.
Add one worked example of a filled shot_design (two adjacent panels with state_in/state_out/cut_in/cut_out) to make the contract format copy-paste concrete and remove ambiguity in the incremental state_delta format.
Move the shot_design field specification and the incremental wire-format rules into a references/ file (e.g. SHOT_CONTRACT.md) linked from a brief overview, reducing the SKILL.md body to the workflow and design principles.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense rule-text that assumes competence (no explanation of what storyboarding is), but several rules are restated across sections: "不按固定镜数/不追求固定数量" appears in both 按原文规模规划生成段 and 审阅建议与保存; cut-point inheritance appears as "continuous 镜逐字复制前镜 cut_out" and again as "后台从前镜完整末态、交镜接点逐字继承"; "保留原剧情与对白/不删原剧情和对白" is repeated three times. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'. Not 4 because the cross-section repetition is noticeable rather than minor. | 3 / 5 |
Actionability | Concrete, executable guidance for an instruction-only skill: the shot_design object defines exact fields (focus, viewer_gain, axis, transition with enumerated values "opening / continuous / time_change / space_change"), state keys use a concrete format with examples ("匠人.悬挂姿态", "布翼.倾角"), the incremental contract specifies "state_delta 只列真实变化后的已有属性,无变化写 {}", and the delivery format is exact (起始构图、镜头1起的连续编号导演描述、source_text). Not 5 because there is no worked example of a complete filled panel/shot_design instance, and the 逐场原文覆盖表 is mandated but never shown. | 4 / 5 |
Workflow Clarity | The sections follow a coherent pipeline (适用范围 → 叙事和镜头设计 → 生成段规划 → 跨镜契约 → 细化和首帧 → 审阅 → 媒体提示词 → 交付), with explicit checkpoints such as "上一镜末态是否等于下一镜首态" and "交付前按原剧本建立逐场原文覆盖表,并逐镜核对实际导演稿", plus repair guidance ("先修对应镜", "真实结果不符时进入对应镜头复核"). Not 5 because the sequence is conveyed through section order and prose rather than an explicit stepwise enumeration, and some checkpoints (e.g. the video motion/sound acceptance) are deferred without a defined loop. | 4 / 5 |
Progressive Disclosure | There are no bundle files (references/, scripts/, assets/ are absent), so all ~90 dense lines live inline in SKILL.md with clear section headers but no navigation to detail files. Self-contained material like the shot_design field spec, the incremental-contract wire format, and the asset-version rules could plausibly be split into reference files for the pipeline it targets. This matches 'some structure but could be better organized; content that should be separate is inline'. Not 4 because the file is well beyond 50 lines and the entire contract spec is inlined; not 2 because section organization is genuinely good. | 3 / 5 |
Total | 14 / 20 Passed |