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.
A strong operational reference: nearly every line is non-obvious Netlify-specific behavior, guidance is executable with exact commands, TOML, URLs, and UI paths, and deep material is correctly pushed to three well-signaled reference files. The main deductions are duplicated content from the appended house-rules section and detail-heavy sections (deploy button variants, netlify.toml example) that could live in references, plus the absence of explicit validate-then-proceed checkpoints for risky flows.
Suggestions
Remove or de-duplicate the appended 'Netlify house rules' section — its nine rules restate warnings already present in the body (no rollbacks, .gitignore, secrets scanning, manual --prod), costing ~40 lines of pure duplication.
Move the Deploy-to-Netlify URL parameter variants and [template] config block into a reference file (or the existing netlify-toml reference), keeping only the basic button snippet inline.
For risky flows, add explicit validate-then-proceed steps (e.g., after linking a site, verify .gitignore contains .netlify before the first deploy; before netlify deploy --prod on a Git-CD site, confirm the lock state).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with Netlify-specific, non-obvious facts (atomic deploys, 54,000-files-per-directory limit, skew-protection caveats, noindex behavior) and explains nothing Claude already knows, matching 'efficient' more than 'verbose'. It falls short of a 5 because of duplication and meta-padding: the appended house-rules section restates body content almost line-for-line, and phrases like "State this limitation explicitly rather than leaving it implied" are commentary rather than instruction. | 4 / 5 |
Actionability | Guidance is copy-paste ready throughout: runnable CLI commands (`netlify deploy --prod`, `npm update -g netlify-cli`), a complete executable netlify.toml context example, a working Deploy-to-Netlify markdown snippet with concrete URL parameter variants, exact UI paths ("Deploys list > Lock to stop auto publishing"), and precise skip markers (`[skip ci]` in PR title vs. commit message). This matches the score-5 anchor: fully executable examples covering the common cases. | 5 / 5 |
Workflow Clarity | Each task area gives concrete, correctly-ordered decision guidance with explicit warnings before risky actions (⚠ manual --prod on a Git-CD site, ⚠ deletion is permanent, ⚠ secrets scanning), and failure handling is spelled out (failed deploy never publishes; fix forward via revert). It sits at 4 rather than 5 because the skill is organized as a topic reference rather than sequenced workflows — there are no explicit validate-then-proceed checkpoints for tasks like linking a site or shipping a manual production deploy. | 4 / 5 |
Progressive Disclosure | Structure is good: a ~190-line overview with three real, one-level-deep, clearly signaled references (`references/netlify-toml.md` for precedence rules, `references/deployment-patterns.md` for context strategy, `references/cli-commands.md` for the full CLI surface), all verified to exist. It does not reach 5 because the overview itself carries substantial detail that could be split out (full deploy-button URL variants and [template] config, the complete netlify.toml example), and the trailing merged house-rules block duplicates in-file content. | 4 / 5 |
Total | 17 / 20 Passed |