Content
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A strong, actionable skill with executable commands, a well-sequenced pre-merge validation checklist, and an efficient troubleshooting table. Content is concise and project-specific throughout. The only weakness is that all content lives in a single file with no use of progressive disclosure via external references.
Suggestions
Consider extracting the troubleshooting table and detailed pre-merge checklist into separate reference files (e.g., references/troubleshooting.md) to improve progressive disclosure and keep the main skill lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient. No explanation of what Vercel is or how deployments work. Every section provides project-specific facts Claude wouldn't know: specific env var names (NEXT_PUBLIC_BACKEND_URL), expected build times (60-90s), and the exact git diff command for debug artifact detection. | 3 / 3 |
Actionability | Fully executable commands throughout: 'npm run build', 'vercel ls tessl-fe/frontend-app --prod', 'vercel rollback <previous-deployment-url>', and a specific git diff command for console.log detection. The troubleshooting table maps exact error messages to concrete fixes. | 3 / 3 |
Workflow Clarity | The pre-merge checklist provides a clear 5-step validation sequence before the destructive merge-to-main. Includes conditional handling ('If a key is missing, add it in Vercel and re-deploy the preview before merging'). The rollback section provides an explicit recovery path for post-deploy failures. The troubleshooting table adds structured error recovery. | 3 / 3 |
Progressive Disclosure | Well-organized with clear section headers (Pre-Merge Checklist, Deploy, Rollback, Common Build Failures), but all content is inline in a single ~80-line file with no external references. The detailed checklist and troubleshooting table could be split into separate files for better progressive disclosure. | 2 / 3 |
Total | 11 / 12 Passed |