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.
A well-engineered skill body: executable examples, explicit validation feedback loops, and clean progressive disclosure through a load-condition reference table. Only minor token waste in the Knowledge Reference section and footer keeps it from full marks on conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: terse constraint lists, lean code examples, no explanation of concepts Claude already knows. Not a 5 because the "Knowledge Reference" section is a redundant keyword list already covered by the description and When-to-Use section, and the maintainer/doc-link footer is non-functional padding. | 4 / 5 |
Actionability | All examples are complete and executable: a type-annotated config parser with docstring and raises, a validated dataclass, an async httpx fetcher, parametrized pytest fixtures, and a copy-paste mypy strict pyproject.toml with expected output ("Success: no issues found"). The MUST DO / MUST NOT DO lists give concrete rules rather than vague direction. | 5 / 5 |
Workflow Clarity | The 5-step Core Workflow has an explicit validation step ("Run mypy --strict, black, ruff") with per-tool failure feedback loops: "If mypy fails: fix type errors reported and re-run before proceeding" and "iterate until green". Clear sequence, explicit checkpoints, and error-recovery loops match the top anchor. | 5 / 5 |
Progressive Disclosure | A reference table maps each topic to an existing one-level-deep file (all five listed reference files are present with substantial content) with a "Load When" column signaling when to load each. The SKILL.md stays an overview with inline examples appropriately kept short, making navigation easy. | 5 / 5 |
Total | 19 / 20 Passed |