Content
81%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 highly actionable and workflow-safe: executable resolver and commands, a complete reviewer prompt, and a validation gate with explicit FAIL/WARN/unavailable handling. The main weakness is token efficiency — routing boilerplate, the Phase-2 hook table, and time-sensitive promotional detail pad the file without adding operational value.
Suggestions
Move the mandated Codex reviewer prompt and the Phase-2 cost-tiered review-gate table into a referenced file (e.g. references/review-gate.md) and keep only the resolution rule and verdict handling inline, tightening the SKILL.md body.
Trim or delete the non-operational detail: the html-anything star count ("3000⭐ at time of writing"), the "activated 2026-05" dates, and the dense reviewer-routing preamble blockquote, which duplicates content already delegated to shared-references/reviewer-backends.md.
Replace the verbose two-phase integration narrative with a short summary line plus a pointer, keeping the per-skill RENDER_HTML toggle instructions as the only inline operational content.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The operational core (resolver script, invocations, review prompt) is efficient and free of concept re-teaching, but padded stretches remain: the dense reviewer-routing preamble blockquote, the full Phase-2 hook table, the "html-anything … 3000⭐ at time of writing" promotion, and time-sensitive markers like "activated 2026-05" that are not confined to a deprecated/old-patterns section. It is above anchor 2 (the verbosity is domain policy, not explanation of things Claude already knows) but not the 'minor instances' of anchor 4. | 3 / 5 |
Actionability | Everything needed to execute is present and copy-paste ready: the full $RENDER_HTML resolver bash chain, exact python3 invocations covering every flag (--template, --out, --state, --json, --offline, --lang, --review/--no-review), the complete mandated cross-model reviewer prompt with a strict JSON response schema, and explicit output/trace paths. Matches the anchor-5 'fully executable, common cases covered' example. | 5 / 5 |
Workflow Clarity | Steps 1–5 are clearly sequenced and gated by an explicit validation checkpoint (the HTML Review Gate) with feedback loops: FAIL → report blocking issues, fix source, re-render; WARN → deliver but surface warnings; REVIEW_UNAVAILABLE → never fabricate PASS. This is exactly the anchor-5 pattern of validation steps plus error-recovery loops. | 5 / 5 |
Progressive Disclosure | Good structure: the helper and both templates are correctly split into real bundle files (scripts/render_html.py, scripts/templates/{academic,dashboard}.html, verified present), and routing/tracing detail is pushed one level deep to clearly signaled ../shared-references/*.md links. It falls short of anchor 5 because sizable operational blocks — the ~60-line reviewer prompt and the Phase-2 integration table — are inlined in SKILL.md where a reference file would keep the overview leaner. | 4 / 5 |
Total | 17 / 20 Passed |