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.
An exemplary router-style SKILL.md: lean, fully actionable fetch commands, unambiguous reference dispatch, and a clean one-level bundle with a sources-of-truth table for freshness. The only deduction is pinned version numbers in the Sources of Truth table, which will drift stale over time.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with zero concept explanations and every row earning its place (e.g., "Load a reference below based on the task; each reference is self-contained"), but the Sources of Truth table pins time-sensitive version numbers ("released 1.45.0" twice, "SDK CHANGELOG through 1.45.0", "Contrib CHANGELOG through 0.66b0") outside any old-patterns/deprecated section, which the rubric penalizes. Not level 3 because there is no unnecessary explanation or padding anywhere — the only deduction is the version pins, confined to a lookup table. | 4 / 5 |
Actionability | Every entry is a concrete, copy-paste-ready command: exact WebFetch URLs with the JSON field to read ("WebFetch https://pypi.org/pypi/opentelemetry-sdk/json (.info.version)"), package-name templates ("opentelemetry-instrumentation-<pkg>"), and linked reference files. Fully executable guidance with no vague directions. | 5 / 5 |
Workflow Clarity | The single action — select the correct reference — is unambiguous via the per-file "Use when" column covering config, API, instrumentation, performance, and breaking-change audits. This is a single-purpose router with no destructive or batch operations, so the simple-skill exception applies and the unambiguous dispatch merits 5. | 5 / 5 |
Progressive Disclosure | A clear overview with well-signaled one-level-deep references: all five linked files exist (192–542 lines each), each row states when to load it, and cross-links inside the references are lateral peer pointers (e.g., breaking-changes.md → api.md) rather than nested chains. Content is appropriately split with easy navigation; verified against the actual bundle structure. | 5 / 5 |
Total | 19 / 20 Passed |