Content
78%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 well-engineered content body that keeps SKILL.md as a navigation layer over a one-level-deep reference bundle, with concrete packaging/testing requirements and a graceful condensed fallback. Remaining gaps are small: a slightly redundant opening line, no sample harness invocation, and error-recovery loops that live only in the referenced specs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — no concept explanations or filler — and the ~70-line condensed fallback is explicitly gated to when the full methodology is unavailable. Minor over-explanation remains: the opening line "Use this skill when the user wants Codex to act like the CLI-Anything builder" duplicates the frontmatter description, and the path-remapping table could be tightened. Anchor 4, not 5. | 4 / 5 |
Actionability | Concrete guidance throughout: an exact generated-harness directory tree, specific packaging directives ("find namespace_packages(include=[\"cli_anything.*\"])", "console_scripts"), test requirements ("_resolve_cli()", "CLI_ANYTHING_FORCE_INSTALLED=1"), and real flags (--json, --dry-run). Not 5: no sample harness invocation is shown and items like "Copy and use the unified ReplSkin" name a resource without showing its use. | 4 / 5 |
Workflow Clarity | The methodology-read step is a clearly ordered 6-step chain with explicit fallbacks, and every mode follows a 'Read <spec>, then do X' pattern with checkpoints such as "update TEST.md only with passing results" and a dedicated validation checklist mode. Not 5: error-recovery loops (validate → fix → re-run) are delegated to the referenced specs rather than stated in the body. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview: a Resource Map table signals every one-level-deep reference with its purpose, a remapping table resolves vendored paths, and the condensed rules keep the skill actionable even when references are unavailable (they are vendored at install time by scripts/install.sh). This matches anchor 5 — clear overview, well-signaled single-level references, easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |