CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cinematic-storyboard

专业镜头设计与动作接点,把叙事重点、画面焦点和物理状态落实为可审阅镜头契约。

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./ruoyi-modules/ruoyi-chat/src/main/resources/short-drama/skills/cinematic-storyboard/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

53%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description communicates a concrete, niche capability but reads more like an internal design summary than a trigger surface: it answers 'what' adequately while completely omitting 'when'. Adding an explicit use-when clause with natural user terms like 分镜/storyboard would lift its weakest dimensions.

Suggestions

Add an explicit trigger clause, e.g. "在用户要求分镜、镜头设计、storyboard 或视频分段规划时使用" — this directly addresses the missing 'when' that caps completeness at 3.

Include the natural synonyms users actually say (分镜, storyboard, 运镜, 镜头规划) alongside 镜头设计 to improve trigger-term coverage.

Break the single clause into 2-3 distinct actions (e.g. 规划生成段、设计镜头契约、核对跨镜物理状态连续性) to raise specificity from a composite one-liner to an enumerated capability list.

DimensionReasoningScore

Specificity

The description "专业镜头设计与动作接点,把叙事重点、画面焦点和物理状态落实为可审阅镜头契约" names the domain and a single composite action chain (designing shots and codifying action cut-points into a reviewable contract), which matches 'names domain and 1-2 concrete actions'. It is not 4 because it does not enumerate several distinct specific actions, and not 2 because the actions given are concrete rather than generic.

3 / 5

Completeness

The 'what' is clear (turning narrative focus, frame focus, and physical state into reviewable shot contracts), but there is no 'when' clause or equivalent explicit trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. Not 2 because the 'what' is concrete rather than vague.

3 / 5

Trigger Term Quality

Terms like "镜头设计", "动作接点", and "镜头契约" are relevant domain keywords, but the most natural phrases a user would actually say — "分镜", "storyboard", "运镜" — are absent from the description, matching 'some relevant keywords but missing common variations or synonyms'. Not 4 because several natural trigger terms users would use are missing.

3 / 5

Distinctiveness Conflict Risk

The niche of professional shot design with explicit cut-point and physical-state contracts for generated video segments is fairly distinct, with phrases like "动作接点" and "可审阅镜头契约" carving out a specific territory. Minor overlap risk remains with generic cinematography or video-prompt skills since no explicit triggers delineate the boundary, so it does not reach 5.

4 / 5

Total

13

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

ageerle/ruoyi-ai

Path

ruoyi-modules/ruoyi-chat/src/main/resources/short-drama/skills/cinematic-storyboard/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.