Content
86%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 redirect skill body: lean, unambiguous, and immediately actionable, with exact install commands and sensible guardrails (do not combine guidance, get approval before installing). The only visible gaps are the absence of a failure-path recovery step and the deferral of Codex/Cursor install commands to an external link.
Suggestions
Add one recovery step for the failure path, e.g., 'If the marketplace add or install command fails, report the error and link the user to the awslabs/agent-plugins installation instructions rather than retrying blindly.'
Inline the one-line Codex/Cursor install commands (or note that they change and must be read from the linked instructions) so the skill remains actionable without a fetch for the most common clients.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Opens with 'This standalone skill is deprecated' and every subsequent line is load-bearing: the canonical path, a non-combination rule, the advisory-reading clarification, and exact install commands. No padding or explanation of concepts Claude already knows, matching the lean anchor at 5 rather than the minor-trim anchor at 4. | 5 / 5 |
Actionability | Provides a concrete decision workflow and copy-paste Claude Code commands ('/plugin marketplace add awslabs/agent-plugins', '/plugin install databases-on-aws@agent-plugins-for-aws'). Minor gap: Codex and Cursor users get only a link to current instructions rather than inline commands, so it falls short of the fully-executable anchor at 5. | 4 / 5 |
Workflow Clarity | A clear numbered sequence with a decision branch (canonical skill available → follow it; unavailable → explain the move) and an approval gate ('Get explicit user approval before installing anything'). No error-recovery guidance for the failure path (e.g., what to do if the marketplace add fails), which keeps it below the feedback-loop anchor at 5; there are no destructive or batch operations, so the cap of 3 does not apply. | 4 / 5 |
Progressive Disclosure | The body is under 50 lines, needs no external reference files, and is organized into clear sections (redirect path, redirect rules, install commands). Per the simple-skill guideline this earns a 5 with just well-organized sections; there are no nested or buried references. | 5 / 5 |
Total | 18 / 20 Passed |