CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cinematic-storyboard

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

56

Quality

70%

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

67%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.

The body delivers concrete, domain-specific guidance organized along the real production pipeline, with an actionable field-level shot contract and incremental state rules. Its weaknesses are repetition of the same rules across sections and the absence of a worked panel example that would make the output structure copy-paste ready.

Suggestions

Consolidate repeated rules: state the 'no fixed shot count / duration' prohibition and the state_in/cut_in copying rules once each in their owning section instead of restating them in planning and review sections.

Add one worked example of a panel with its shot_design object (including a continuous successor showing state_delta), so the contract structure is executable rather than inferred.

Consider moving the shot_design field reference and the incremental-contract details into a reference file, keeping SKILL.md as a lean overview with a clearly signaled link.

DimensionReasoningScore

Conciseness

The body is dense rule-only prose with no padding over concepts Claude already knows, but it repeats key rules across sections: the 'no fixed shot count' prohibition appears in 按原文规模规划生成段 and 审阅建议与保存, and the state/cut copying rules ('state_in 逐项复制前镜 state_out', 'continuous 镜逐字复制前镜 cut_out') are stated twice in detail. Mostly efficient but could be tightened by consolidating these.

3 / 5

Actionability

Concrete field-by-field shot_design contract (focus/viewer_gain/framing/axis/movement/motivation/transition/cut_in/cut_out/state_in/state_out) with executable value rules ('state_delta 只列真实变化后的已有属性,无变化写 {}', '首镜及明确换时/换地镜给完整 state_in') and a clear output order (scene_plan summary then panels). Not 5 because there is no worked example of a panel or shot_design JSON, so the exact structure must be inferred.

4 / 5

Workflow Clarity

Sections follow the actual pipeline (design → segment planning → cross-shot contract → refinement/first frame → review → media prompts → save) with explicit '先...再...' sequencing, and review checkpoints with fix loops exist ('先修对应镜', '真实结果不符时进入对应镜头复核'). Not 5 because the checkpoints are scattered in prose rather than consolidated into a reviewable sequence or checklist.

4 / 5

Progressive Disclosure

A single well-organized SKILL.md with clear section headers, no dangling references, and no bundle files to navigate. Not 5 because at ~60 dense lines the shot_design field reference and the incremental-contract rules are substantial enough that they could arguably live in a separate reference file, keeping the overview leaner.

4 / 5

Total

15

/

20

Passed

Description

58%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.

A dense, domain-specific description that clearly states what the skill produces (shot design with action cut-points and a reviewable shot contract), but it lacks any 'when to use' trigger clause and misses the natural synonyms (分镜/storyboard) users would actually say. Distinctive within its niche, though not comprehensive in keyword coverage.

Suggestions

Add an explicit 'Use when...' clause naming the trigger stages, e.g. '只在分镜规划、细化与审阅阶段应用' — reuse the trigger guidance already present in the body's opening paragraph.

Include natural trigger terms and synonyms such as '分镜', 'storyboard', and '视频生成' so users querying with those words match the skill.

Briefly mention the segment-planning and review deliverables (scene_plan, panels, shot_design) to close the coverage gap without adding padding.

DimensionReasoningScore

Specificity

The description names several concrete deliverables — '镜头设计与动作接点' (shot design and action cut-points) and turning '叙事重点、画面焦点和物理状态' (narrative emphasis, frame focus, physical state) into a '可审阅镜头契约' (reviewable shot contract). It falls short of 5 because it omits other skill capabilities visible in the body (segment planning, review workflow, media prompts), and is above 3 because it lists more than 1-2 concrete actions.

4 / 5

Completeness

The 'what' is clearly stated (design shots and action cut-points, concretize narrative/focus/physical state into a shot contract), but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

'镜头设计' is a natural keyword, but the description is missing common user phrasings and synonyms such as '分镜' (storyboard), 'storyboard', or '视频生成' that a user would naturally say when needing this skill. Some relevant keywords exist, but coverage of variations is incomplete.

3 / 5

Distinctiveness Conflict Risk

Distinctive domain vocabulary ('动作接点', '镜头契约', '画面焦点', '物理状态') gives it a clear niche with minimal conflict risk; only minor overlap risk with adjacent video-generation or general cinematography skills. Not 5 because related video-prompting skills could still compete for similar queries.

4 / 5

Total

14

/

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.