Content
82%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.
The body is a strong operational runbook: highly executable commands and complete code examples organized into clear, ordered workflows with a verification section. Its main weaknesses are mild verbosity in the intro/links sections and detail (full config samples, CI workflow, function code) that is inlined where the progressive-disclosure pattern would move it into the already-present references directory, plus the absence of explicit error-recovery loops.
Suggestions
Move the complete vercel.json example, the full serverless/edge handler code, and the GitHub Actions workflow into files under references/ (alongside vercel-config-patterns.md), keeping only condensed snippets inline in SKILL.md.
Add an explicit feedback loop to the deployment workflows, e.g. 'if the deploy fails, run `vercel logs <url> --follow` to diagnose, fix, and redeploy' after the deploy steps.
Trim the introductory 'Comprehensive guide and operational runbook' sentence and consolidate the external-links section to the two most useful pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely command-and-code with minimal padding, but includes trimmable material: the 'Comprehensive guide and operational runbook' intro line, the external-links section (e.g. the Context7 line), and explanatory sentences like 'Triggers a preview deployment from the current working directory, generating a unique preview URL'. This fits the level-4 anchor 'efficient; minor instances of over-explanation that could be trimmed' — well above level 3's unnecessary explanations, but not the level-5 'every token earns its place'. | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: exact CLI invocations with flags ('vercel link --project <project-name> --scope <team-slug> --yes', 'vercel deploy --prebuilt --prod'), a complete vercel.json, runnable TypeScript handlers, and a full GitHub Actions workflow covering the common cases. This matches the level-5 anchor; level 4 would imply minor gaps in the concrete examples, which are absent. | 5 / 5 |
Workflow Clarity | Core workflows are clearly sequenced (link → env → config → deploy → functions → crons → CI/CD) with a dedicated Verification & Troubleshooting section ('vercel logs <deployment-url-or-id> --follow', 'curl -I ...') and a numbered prebuilt-deploy sequence. It falls short of level 5 because there are no explicit feedback loops for error recovery (e.g. what to do when a build fails or a deploy errors), but it is above level 3 since verification steps are explicitly present rather than missing. | 4 / 5 |
Progressive Disclosure | Structure is good: a well-signaled, real one-level-deep reference ('Detailed architectural templates can be found in [vercel-config-patterns.md](./references/vercel-config-patterns.md)' — verified to exist) and organized sections. It does not reach level 5 because substantial detail (the full vercel.json example, complete function code, the full CI workflow) is inlined in SKILL.md rather than split into the existing reference structure, matching the level-4 anchor 'most content is appropriately placed; minor organization gaps'. | 4 / 5 |
Total | 17 / 20 Passed |