Content
90%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 lean skill body: every token is project-specific, all commands are copy-paste executable, and detailed material is properly split into two well-organized reference files. The only gaps are the implicit top-level workflow ordering, a missing fix-and-retry loop for failed checklist items, and inconsistent reference link paths.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean checklist, a signal-to-reference table, a two-entry reference list, and a terse git block — no explanations of concepts Claude already knows, no padding. Every line carries project-specific information (e.g. "New tool class registered in `_lazy_registry_static.py` and `default_config.py`"). | 5 / 5 |
Actionability | Guidance is fully executable throughout: a copy-paste JSON validation one-liner, `ruff check src/tooluniverse/<file>.py`, an import smoke test, a real CLI run command, and concrete git commands with `--force-with-lease`. The fix-category table maps each failure signal to a specific reference section. Not below 5 because the common cases (pre-commit verification, rebase/push, PR mergeability) are all covered with specific commands. | 5 / 5 |
Workflow Clarity | The pre-commit checklist provides strong validation checkpoints (schema shape, real-ID tests, lint, import, end-to-end CLI run) and the git workflow includes an explicit gate ("must be MERGEABLE before done"). Not 5 because the overall write→checklist→PR sequence is implicit rather than explicitly ordered, and there is no fix-and-retry feedback loop (e.g. what to do when a checklist item fails). | 4 / 5 |
Progressive Disclosure | The body is a clean overview with two real, one-level-deep references (references/api-fixes.md and references/code-patterns.md), each well-signaled with a scope description, and the table's section anchors (Quick Lookup Table, Schema Patterns, Client-Side Filter, etc.) all resolve in the actual files. Not 5 because the table links use bare paths (`[code-patterns.md](code-patterns.md)`) that don't resolve from SKILL.md's location, inconsistently with the correct `references/`-prefixed links in the References section. | 4 / 5 |
Total | 18 / 20 Passed |