Content
100%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 exemplary skill body: a six-step workflow with hard validation gates and a repair loop, copy-paste-ready commands naming exact output files and MCP tools, and dense standards that read as constraints rather than exposition. All detail is correctly externalized into the bundled script, keeping the main file lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout — "Use an absolute file path", "Do not import the PPTX until `preflight_checks.json` has `status: \"passed\"`", "Tighten copy before shrinking fonts", "Source notes should be visible but quiet". No section explains concepts Claude already knows (what HTML is, how PPTX works); every line is either a step, a command, or a constraint. This matches the 'every token earns its place' anchor; there is no padding to trim down to a 4. | 5 / 5 |
Actionability | The core command is copy-paste ready with standard skill placeholders (`python3 <REPORT_TO_GOOGLE_SLIDES_SKILL_DIR>/scripts/report_to_google_slides.py <LOCAL_HTML_REPORT_PATH> --out-dir /tmp/report_to_google_slides`), expected outputs are enumerated by exact filename (`deck.pptx`, `manifest.json`, `deck_plan.json`, `preflight_checks.json`), verification uses a concrete command (`unzip -t <out-dir>/deck.pptx`), and import names the exact MCP tools and parameter (`mcp__codex_apps__google_drive._import_presentation` with `upload_mode="native_google_slides"`). All referenced files exist in the bundle. | 5 / 5 |
Workflow Clarity | The six-step workflow is clearly sequenced with explicit validation checkpoints and a repair feedback loop: preflight status must be "passed" before import, the PPTX is zip-tested, imported slides are verified via `_get_slide_thumbnail` for every slide when possible, and step 5 ("Repair before handoff") instructs revising and regenerating when thumbnails show clipped text, missing charts, low contrast, blank images, or awkward sizing. This is the anchor-5 pattern (validate → fix → re-run), well above the 4-level anchor which tolerates missing checkpoints. | 5 / 5 |
Progressive Disclosure | SKILL.md is a concise overview plus workflow; all heavy lifting (2524 lines of conversion logic) lives in `scripts/report_to_google_slides.py`, referenced one level deep with the skill-dir placeholder and confirmed to exist. Sections (Workflow, Standards, Visual System) are well organized, nothing that belongs in a separate file is inlined, and there are no nested or dangling references. | 5 / 5 |
Total | 20 / 20 Passed |