CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deck-render

幻灯讲解视频的本地 HTML 确定性渲染工具:环境检查、逐页脚手架、质量检查、静帧联系表、MP4 渲染。

Quality

80%

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 ./crews/content-producer/skills/expert-video/tools/deck-render/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

An expert-grade, highly actionable skill body: executable commands for every subcommand, a complete spec contract, and validation woven through the whole pipeline. Weaknesses are limited to time-sensitive version pins embedded in prose and a mismatch between referenced scripts and the actual bundle (a missing install script and an unreferenced font_policy.py).

Suggestions

Fix the bundle mismatch: either add scripts/install-deck-render.sh (+ .ps1) to the bundle or update the body to point at the actual installation path — the current reference resolves to a non-existent file.

Reference scripts/font_policy.py from the body (e.g. in the check-setup/font bullet) so the bundled file is discoverable rather than orphaned.

Move the version pins (hyperframes 0.8.50, gsap 3.14.2, Node ≥22) into a dedicated, clearly-scoped environment/lock section so time-sensitive values don't read as evergreen guidance.

DimensionReasoningScore

Conciseness

The body is dense and lean — it assumes competence (no explanation of what HTML, GSAP, or ffmpeg are) and every section carries operational constraints. It misses level 5 because it embeds time-sensitive version pins ("hyperframes 0.8.50、gsap 3.14.2", "Node ≥22") outside any old-patterns/deprecated section, and the final environment paragraph is a run-on that could be tightened.

4 / 5

Actionability

All five subcommands are given as copy-paste-ready invocations with flags (check-setup, scaffold, check, preview, render), alongside a complete spec JSON example, exit-code semantics (0/1/2), a 20-minute timeout, and precise numeric constraints (3–30s durations, ≤32-char titles, ≤4 points of ≤48 chars, workers 1–24, width/height even ≥360, fps 1–60). This matches the level-5 anchor: fully executable commands covering the common cases.

5 / 5

Workflow Clarity

The commands are listed in canonical pipeline order (check-setup → scaffold → check → preview → render) with explicit validation at every stage: check gates before preview and render ("preview 先 check", "render 每次先 check"), errors block while warnings require human review, GATE B approval before render, exit-code handling, and --force/--validation guards on overwriting outputs ("临时输出通过校验才替换"). This matches level 5: clear sequence with explicit validation and feedback loops.

5 / 5

Progressive Disclosure

The body is well sectioned and appropriately defers the overall process to workflows/deck-talk.md, but scored against the actual bundle it has real navigation gaps: it directs installation through `scripts/install-deck-render.sh`, which does not exist in the bundle (scripts/ contains only deck-render.py and font_policy.py), and the bundled font_policy.py is never referenced or discoverable from the body. Not 4 because a broken in-bundle reference plus an orphaned bundle file are more than 'minor organization gaps'; not 2 because the structure and content split are otherwise good.

3 / 5

Total

17

/

20

Passed

Description

71%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 terse, highly concrete description that names the domain and all five pipeline actions with strong specificity. Its main weakness is the absence of any explicit 'use when' trigger clause and of common synonyms/extensions, which caps completeness and trigger coverage.

Suggestions

Add an explicit 'Use when...' (使用时机/当...) clause naming the triggering scenarios, e.g. rendering slide-narration videos to MP4, generating slide contact sheets, or scaffolding per-page HTML compositions — this would lift completeness from 3 to 4–5.

Broaden trigger terms with common synonyms and formats users would naturally say, such as 幻灯片、PPT、演示文稿、视频、slideshow, and file extensions like .mp4 / .html.

Sharpen distinctiveness by leading with the most differentiating phrase (e.g. 'HTML 幻灯转 MP4 视频') so generic 幻灯/presentation requests are less likely to fire this skill.

DimensionReasoningScore

Specificity

The description names the domain ("幻灯讲解视频的本地 HTML 确定性渲染工具") and lists five concrete pipeline actions ("环境检查、逐页脚手架、质量检查、静帧联系表、MP4 渲染"), comprehensively covering the tool's command set. It exceeds the level-4 anchor ('several specific actions; minor gaps') because the action list maps to every stage of the workflow with no coverage gaps.

5 / 5

Completeness

The 'what' is clear and concrete (deterministic local HTML rendering with five named actions), but there is no 'Use when...' clause or equivalent explicit trigger guidance — the 'when' is only weakly implied by the domain noun. Per the judging guideline, a missing 'Use when' clause caps completeness at 3; it is not 4 because the 'when' is never made explicit.

3 / 5

Trigger Term Quality

Natural keywords a user would say are present: "幻灯" (slides), "讲解视频" (narrated video), "HTML", "渲染", "MP4". It falls short of the level-5 anchor because common variations and file extensions are missing (e.g. "PPT", "演示文稿", "slideshow", ".mp4"), but coverage is good rather than merely 'some relevant keywords' (level 3).

4 / 5

Distinctiveness Conflict Risk

The niche is well defined — deterministic HTML-to-MP4 slide-video rendering with contact sheets — and distinct from document/presentation-authoring skills. It is not 5 because the leading term "幻灯" could plausibly fire for generic slide/presentation tasks (e.g. .pptx creation or editing skills), creating minor overlap risk with closely related skills.

4 / 5

Total

16

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

TeamWiseFlow/xiaobei

Path

crews/content-producer/skills/expert-video/tools/deck-render/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.