Content
78%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 very strong single-file reference: extremely dense with executable, platform-specific guidance and honest gotchas, with no filler. Its main weakness is structure: at ~280 lines it keeps everything inline with no references/ offloading, and contains minor duplication and tooling-comment noise.
Suggestions
Split reference-grade catalogs (redirects/rewrite syntax rules, Secrets Controller policies, env-var CLI/API and naming limits) into references/ files (e.g. references/redirects.md, references/secrets.md) and keep SKILL.md as a shorter overview with one-level-deep, clearly signaled links.
Remove the duplicated per-scope precedence explanation (house rule 4 in the merged system section repeats the 'Scopes' paragraph) and strip the ctx-gen/system.md HTML comment noise from the rendered output.
Add a short 'verify your config' step (e.g. run 'netlify build' locally or check the deploy log for redirect/oversize errors) so risky changes get a validation checkpoint before shipping.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — no space is spent explaining what Netlify, TOML, or redirects are; nearly every line is platform-specific knowledge ('307 is unsupported', 'proxy timeout 26 s', 'Paths ... absolute relative to the base directory'). It misses a 5 because of minor trims: house rule 4 duplicates the per-scope precedence rule already stated in the Scopes paragraph, and the HTML comment markers add noise. | 4 / 5 |
Actionability | Virtually every section provides copy-paste-ready executable snippets: TOML blocks for build/contexts, redirects, headers, functions, and dev config; a full '_redirects' syntax block with working example rules; CLI commands ('netlify env:set KEY value --secret'); and a Node ignore script. These cover the common cases directly. | 5 / 5 |
Workflow Clarity | This is a reference-style skill rather than a linear workflow, and each task (add a redirect, set a scoped env var, configure monorepo paths) maps to unambiguous guidance with explicit failure-mode checkpoints ('a /x/ → /x 301! rule loops infinitely', 'oversized serialized output fails the deploy', secret scan 'fails the build on detection'). Not 5: there is no end-to-end validate-after-config sequence or feedback loop for verifying a config before deploy; not 3: checkpoints for the risky operations are explicitly present. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned but is a single ~280-line monolith with no bundle files at all: the full '_redirects' syntax catalog, the Secrets Controller policy details, and the env-var API/name catalog are prime candidates for references/ files. Additionally, the HTML comment 'agent-context/config/system.md — ... merged by ctx-gen' references a file that is not present in the bundle. Anchor 3 ('content that should be separate is inline'), not 4, because essentially no content is offloaded from SKILL.md. | 3 / 5 |
Total | 16 / 20 Passed |