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.
This is a high-quality operational skill: executable commands with security-conscious token handling, explicit validation and error-recovery loops, and hard-won gotchas (CLI version bug, header mix-ups, nonexistent commands) that Claude would not know. The only weaknesses are mild: version pins outside a dedicated section and a single-file structure slightly over the ideal SKILL.md length.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational knowledge (the CLI 50.25.0–53.2.x stderr-credential gotcha, the x-vercel-oidc-token vs x-vercel-trusted-oidc-idp-token distinction, dead ends like 'vercel share'), with essentially no padding or explanation of things Claude already knows. It falls short of anchor 5 only through minor tightening opportunities and pinned version numbers presented outside a deprecated/old-patterns section, though those versions function as a runtime gate rather than roting date-conditional instructions. | 4 / 5 |
Actionability | Guidance is fully executable: 'vc whoami', 'vc project token "$VERCEL_PROJECT" --scope "$VERCEL_SCOPE"' inside a complete mint-and-inject block with a 'test -n "$TOKEN"' guard, the exact header 'x-vercel-trusted-oidc-idp-token', the protection-bypass fallback commands, and an error-signature-to-cause mapping. The common cases (same-project preview, cross-environment, static-secret fallback) are each covered with copy-paste-ready commands. | 5 / 5 |
Workflow Clarity | The same-project preview path is clearly sequenced (identity/version check → scope → session → token mint → authenticated open → snapshot) with explicit validation checkpoints (version gate with stop-and-ask, non-empty token test) and genuine feedback loops: the 'Diagnose failures' section maps each failure to a cause and remedy, and the Trusted Sources path retries the authenticated open after human confirmation. No destructive or batch operations are involved, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | As a single-file skill with no references/, scripts/, or assets/ directories, the body is well-sectioned (same-project preview, other environments, intervention boundaries, header, diagnostics, fallback, dead ends) and everything reads at overview level. It sits at anchor 4 rather than 5 because at ~105 lines it exceeds the under-50-line simple-skill exception, and secondary material (the static-secret fallback and diagnostics detail) could arguably live in one-level-deep reference files. | 4 / 5 |
Total | 18 / 20 Passed |