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 operational skill: executable commands and code, a validated workflow with a verification checklist, and clean progressive disclosure into six real, appropriately scoped reference files. The only weakness is mild redundancy in the repeated verify-current-sources instructions and the long link list, which slightly dilute token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational ('Plain model strings route through AI Gateway. Add `@ai-sdk/gateway` only when the task needs...') and assumes Claude's competence, but the verify-from-current-sources instruction recurs across the intro, 'Start with current sources', and the CLI section, and the 13-link documentation list could be trimmed. This sits above anchor 3 (mostly efficient) but short of anchor 5's 'every token earns its place'. | 4 / 5 |
Actionability | Fully executable guidance throughout: 'curl -fsSL https://ai-gateway.vercel.sh/v1/models', a complete TypeScript example with an env-var guard, exact baseURL values per SDK ('point `baseURL`... to `https://ai-gateway.vercel.sh/v1`'), and a concrete CLI subcommand table. Copy-paste ready commands cover the common cases, matching the anchor-5 example. | 5 / 5 |
Workflow Clarity | The 9-step 'Implementation workflow' has explicit validation checkpoints ('Run the project's formatter, type checker, and focused tests', 'Verify the request in AI Gateway Logs'), enumerated error outcomes, and authorization gating for outward-facing actions, reinforced by a 9-item 'Verification checklist'. This matches anchor 5's sequence-plus-validation-plus-checklist pattern, and the destructive/batch cap does not apply since validation is present. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a clear overview with a job-to-reference routing table ('Route the request to the right guide'); all six cited files exist in references/, are one level deep with only sibling cross-links, and detail is appropriately split (main file 293 lines vs. 91-296 line references). This matches anchor 5's 'clear overview with well-signaled one-level-deep references'. | 5 / 5 |
Total | 19 / 20 Passed |