Content
85%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.
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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |