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 CLI skill body: it front-loads non-obvious operational semantics (linking resolution, output-stream parsing, non-interactive JSON errors), provides copy-paste commands with exact corrections for common mistakes, and defers all topic depth to a complete, verified set of one-level-deep references. No padding or over-explanation was found.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every sentence carries non-obvious operational knowledge Claude would not know ("Parse only stdout for URLs and JSON", "Some help commands exit 2 after printing usage", the project.json vs repo.json resolution rules). It assumes CLI competence and contains no padded explanation of what Vercel or a CLI is, matching the anchor-5 example of every token earning its place. | 5 / 5 |
Actionability | The Quick Start block is copy-paste ready ("npm i -g vercel", "vercel link --repo", "vercel deploy"), and anti-patterns give exact corrective commands such as "use `vercel deploy --force` without `--with-cache`" and "Use `VERCEL_TOKEN` env var instead of `--token`". Concrete verification commands like "vercel project inspect --non-interactive" and "vercel whoami --format json" cover the common cases. | 5 / 5 |
Workflow Clarity | There is an explicit validation checkpoint before consequential actions ("run `vercel project inspect --non-interactive` from the intended directory and confirm the reported owner and project… stop on `link_required` or a target mismatch"), feedback loops for error recovery (check `vercel <command> --help` before guessing; handle JSON `next` follow-ups without auto-running mutations), and the Decision Tree acts as a routing checklist. | 5 / 5 |
Progressive Disclosure | The body is a lean overview with a well-signaled Decision Tree routing each topic to one of 26 reference files (deployment.md, firewall.md, flags.md, etc.); all referenced files exist in references/ and are one level deep (at most a single cross-link, no nested chains). Content is appropriately split — no bulk reference material is inlined. | 5 / 5 |
Total | 20 / 20 Passed |