Content
85%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 deprecated-forwarding stub: it gives exact routing with a concrete path, an explicit failure branch that forbids falsely claiming the replacement's guidance was loaded, and safe, verification-gated retirement conditions. The only softness is slight compressibility of the migration-governance sentences and one vague step ('update current callers').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Two tight paragraphs with zero re-teaching of known concepts and no padding ("This old name forwards to agently-agentic-design. Read the installed replacement's entry..."). It is not 5 because a few governance lines ("No scheduled retirement task is required", "Preserve historical evidence") could be trimmed or merged; not 3 because there is no unnecessary explanation. | 4 / 5 |
Actionability | Concrete, executable guidance for an instruction-only skill: an explicit path (../agently-agentic-design/SKILL.md), unambiguous directives, and a conditional failure branch ("If the replacement is absent, report the installation gap and install it only within the user's authorization; do not claim its guidance was loaded"). It is not 5 because "check active references... update current callers" lacks a concrete method; not 3 because the guidance is specific and executable, not high-level hints. | 4 / 5 |
Workflow Clarity | As a simple single-purpose skill the primary action is unambiguous (read the replacement's entry and continue there), with an explicit error branch for the missing-replacement case. The one destructive operation (removing this forwarding entry) is properly gated by validation: "remove this forwarding entry when migration is verified" and "do not... treat elapsed time as proof of a safe migration", so the missing-validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and no need for external references beyond a single clearly signaled, one-level-deep pointer to the replacement skill's entry. The content is appropriately minimal for a forwarder and well organized, matching the simple-skill exception for a top score. | 5 / 5 |
Total | 18 / 20 Passed |