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 lean skill body: dense with platform-specific hard limits and gotchas Claude would otherwise get wrong, fully executable commands, and a deploy-verify-fix-redeploy loop with an explicit validation checkpoint. Structure is appropriately compact for a simple, single-purpose skill with no bundle files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries Netlify-specific facts Claude cannot reliably know (10s/26s/15-min function limits, Deno-based edge functions, non-cascading env scopes, NODE_VERSION as top build-failure cause) with zero padding or explanation of known concepts. Matches the lean anchor exactly; the platform limits are current facts rather than time-sensitive version info, so no date penalty applies. | 5 / 5 |
Actionability | Copy-paste-ready commands throughout: 'netlify build --debug', 'netlify env:list', 'netlify status', the curl '%{http_code}' 200-check, and the concrete cron snippet 'config: Config = { schedule: "0 0 * * *" }'. These cover the common cases (local build repro, env scope confirmation, post-deploy verification); the '<DEPLOY_URL>' placeholder is an inherent per-site substitution, not a gap. | 5 / 5 |
Workflow Clarity | A clear sequence with explicit validation and an error-recovery feedback loop: reproduce the build locally 'before pushing', then post-deploy 'verify each critical route returns 200', then 'Any non-200 → read the deploy log in the Netlify UI, fix, redeploy.' This matches the anchor with validation steps and feedback loops; deployment is not a destructive/batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, single-purpose, and organized into clear sections (Hard limits, Gotchas, Commands), with one clearly signaled external reference ('.opencastle/stack/deployment-config.md' for project architecture) and no nested references. Per the simple-skill guideline, this earns the top anchor; no bundle files exist, so nothing further to verify. | 5 / 5 |
Total | 20 / 20 Passed |