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.
Highly actionable, well-sequenced editing guidance with exact tool calls, JSON Pointer paths, feedback loops, and explicit budgets. The only deduction is minor verbosity from repeated read-before-write rules and stylized phrasing across sections.
Suggestions
Merge the "Read fresh, then write" guidance in the human-editors section into the existing "Read before every change" section to remove the duplicated rule.
Trim rhetorical restatements (e.g., the stale-id/stale-assumption sentence) to plain imperatives to save tokens without losing the rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no explanations of concepts Claude already knows, but there is some repetition — the "Read fresh, then write" bullet restates the read-before-every-change rule, and rhetorical phrasing like "A stale id is a failed edit; a stale assumption about what is on the page is a wrong edit" could be tightened. This fits the 'efficient; minor instances that could be trimmed' anchor rather than the lean score-5 anchor. | 4 / 5 |
Actionability | Guidance is fully executable: exact tool invocations (`read_stage path:/scenes/<order|id>` with `detail:"source"`, `generate_tts`, `edit_deck retitle/insert/delete/reorder`) and a complete intent→tool→operation matrix with concrete JSON Pointer paths (`/content/canvas/elements/N/left`, `/actions/N/text`, `/content/questions/...`). For an instruction-only skill this covers the common cases copy-paste ready, matching the top anchor. | 5 / 5 |
Workflow Clarity | A clear sequence runs from entry (`list_scenes`) through read-before-each-edit, smallest-operation selection, a bounded preview loop ("at most two preview rounds per page"), TTS regeneration after wording changes, to a closing consistency checklist. Explicit feedback loops exist for the destructive edit case ("A rejected patch changed nothing… Re-read and resubmit; never force"; wrong page type → re-read), so the missing-validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The bundle has no reference/script/asset files, and the body appropriately stays an overview: field-level detail and design law are deferred to named sibling skills with clear signals ("that is `slide-dsl`", "load `slide-craft`"), one level deep. Sections are well-organized and easy to navigate, fitting the clear-overview anchor. | 5 / 5 |
Total | 19 / 20 Passed |