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.
A high-quality operational skill body: every workflow step is backed by an executable command against real bundled scripts, verification and failure-recovery paths are explicit, and heavy implementation logic is correctly externalized into scripts. The only weakness is mild redundancy around the coordinate-hiding rule, which is repeated several times across sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and command-driven with no explanations of concepts Claude already knows, but there is minor repetition that could be trimmed: the rule that coordinates must stay out of visible annotations appears four times ("Do not include coordinate values in visible annotation text", "Keep annotations human-readable: Target: Account avatar, not a label with a raw coordinate suffix", "never raw coordinate percentages", "do not expose coordinate values"). Not 5 because of this redundancy; not 3 because nearly all content is skill-specific operational detail that earns its place. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands with exact flags and paths for all five bundled scripts (all of which exist in scripts/), a complete key_moments.json example, exact upload parameters ("count: 1", "scaleMode: \"FILL\""), and specific numeric defaults (1440 px landscape, quality 75, threshold 0.4). Specific examples cover the common cases end to end. | 5 / 5 |
Workflow Clarity | Eight clearly numbered steps with explicit validation checkpoints: step 1 validates the video path and ffmpeg, step 8 is a dedicated Verify pass (screenshots nonblank, markers on target, annotations human-readable), and edge cases include feedback loops for error recovery (retry individual upload_assets targets, re-run the fill pass when images fail to render, raise --scene-threshold when too many frames). Ordering is also deliberate — local analysis completes before the Figma file is touched to avoid partial pages. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all five scripts in scripts/ are referenced by exact path and verified to exist, are one level deep, and the body explicitly instructs to run them as helpers rather than read them ("Read or modify them only when debugging, adapting to an unusual environment, or changing the skill itself"). Implementation detail is appropriately externalized into executable scripts while SKILL.md stays a navigable overview with clear section headers and no nested references. | 5 / 5 |
Total | 19 / 20 Passed |