Content
92%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.
The body is an exemplary terse, instruction-only skill: dense with concrete numeric rules, a clear section-ordered workflow, and an explicit validate-fix-rerender loop. The only meaningful gap is that the rendering step never names a tool or command, leaving the one fragile, tool-dependent step the least specified part of the process.
Suggestions
Name at least one concrete rendering path (e.g. an ffmpeg command template for assembling slide images plus burned-in subtitles into an mp4) so the most tool-dependent step is executable rather than inferred.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, imperative, and free of padding — e.g. "A slide is never a bullet list, a status list, a table, or boxes with nothing connecting them" and "Drop each slide that does not change what the user knows". It explains nothing Claude already knows and every sentence instructs, matching anchor 5. | 5 / 5 |
Actionability | Guidance is highly concrete with specific numeric rules ("Use at most 10 slides", "about ten words", "at least one second for each three words", "burn each subtitle into its slide's frames") and a concrete check method ("Look at one frame from each slide at chat size"). It falls short of anchor 5 because no render tool or command is ever named — "Render one silent landscape video, such as an mp4, with motion between slides" leaves the rendering mechanism entirely to inference. | 4 / 5 |
Workflow Clarity | The workflow is clearly sequenced through ordered sections (plan slides → subtitle styling → render → check) with an explicit validation pass ("check the rendered file", "Measure each hold", "Count the words each slide adds against its measured hold") and a feedback loop ("Fix any slide you cannot read in that time, render again, and check again"). This is not a destructive or batch operation, so no cap applies, and it matches anchor 5. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external reference files, and is organized into clear sections (Slides, Subtitles, Render); its single reference to ../ketchup/SKILL.md is one level deep and clearly signaled. Per the simple-skill guideline this matches anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |