Content
100%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 deprecation stub: minimal, fully executable, and unambiguous. It gives the install command, the exact successor location, and an explicit statement that no component rules live here, so an agent reading it cannot mistake it for the real skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is five short lines with no concept explanations or padding; each clause serves the redirect purpose, including 'This compatibility entry contains no component rules and is no longer maintained' which explicitly prevents misuse of the stub. | 5 / 5 |
Actionability | Provides a copy-paste-ready executable command ('npx skills add kostja94/bricks --skill component-builder'), a direct link to the successor reference, and a concrete instruction ('Ask the agent to use component-builder to build a new Newsletter Signup'), fully covering the single common case. | 5 / 5 |
Workflow Clarity | This is a simple single-purpose skill whose one action (install and defer to component-builder) is unambiguous, so per the rubric's simple-skill exception workflow clarity scores 5; no destructive or batch operations are involved so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no need for local bundle files (none exist and none are referenced); the single external link to the successor reference is clearly signaled and one level deep, meeting the rubric's simple-skill criterion for a top score. | 5 / 5 |
Total | 20 / 20 Passed |