Content
88%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.
Highly actionable, well-structured content: executable commands in every branch, a state-driven decision tree with approval and status checkpoints, and concrete error-recovery paths. The only real weaknesses are mild cross-branch repetition and a monolithic single-file layout where environment-specific detail could be offloaded to references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence — no concept explanations, just commands and decision logic — but repeats the team-selection and "git push else vercel deploy --no-wait" guidance across multiple branches, and the Codex escalation note appears twice (fallback section and Troubleshooting). These are minor instances of over-explanation that cross-referencing could trim, matching anchor 4 rather than the fully lean anchor 5. | 4 / 5 |
Actionability | Every branch gives copy-paste-ready bash (e.g., "vercel deploy [path] -y --no-wait --scope <team-slug>", "npx vercel@latest deploy [path] --temporary -y") with clearly marked placeholders, covering all four environment states. This fully matches the executable, common-cases-covered top anchor. | 5 / 5 |
Workflow Clarity | A clear two-phase sequence (state gathering, then a four-branch decision tree) with explicit checkpoints: user approval before any git push, post-deploy status verification via "vercel inspect"/"vercel ls --format json", and error-recovery loops in Troubleshooting (network failure → escalate, auth failure → --temporary fallback). Deploy/push risks are gated by explicit approval steps, so no cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the single-file body is well organized with clear section headers and a navigable decision tree. It is not a 5 because nothing is split out — agent-specific notes and troubleshooting detail could live in one-level-deep reference files to keep SKILL.md a leaner overview. | 4 / 5 |
Total | 18 / 20 Passed |