Content
86%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 tight, highly executable reference skill: exact commands, parameter tables, and precise constraint callouts (double-backslash TOML escaping, blurhash-as-text) with one cleanly signaled reference file. The main weakness is a redundant appended 'house rules' section duplicating body content, plus the absence of an explicit verification step after config changes.
Suggestions
Remove or merge the trailing 'Netlify house rules' section (SKILL.md:155-180): all four of its numbered rules already appear verbatim in the body's 'Remote source images', 'Blur placeholders', 'Local development', and 'remote_images regex escaping' sections.
Add a one-line verification step after the remote allowlist and redirect examples, e.g. re-run the curl command and expect 200 with the transformed content-type (the Response codes section already defines the expected outcomes, so link to them).
Consider moving the framework image-handling table and setup-guide links into a reference file (e.g. references/frameworks.md) to keep SKILL.md focused on the endpoint itself, mirroring the user-uploads split.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven with no beginner-concept padding ("cover: fills exactly, cropping excess. Requires BOTH w and h"), but the trailing 'Netlify house rules' section (SKILL.md:155-180) restates four points already covered earlier — percent-encoding, blurhash text output, the local 404 cause, and remote_images escaping — which is unnecessary duplication that could be trimmed. Not level 5 because of this redundant block; not level 3 since the duplication is confined to one append-only section while everything else earns its tokens. | 4 / 5 |
Actionability | Fully executable guidance throughout: copy-paste curl commands with real parameter values ("curl -vs 'https://mysitename.netlify.app/.netlify/images?url=/owl.jpeg&fit=cover&w=50&h=50&position=left'"), exact netlify.toml and _redirects snippets, a working encodeURIComponent example, and a parameter table enumerating valid values and defaults. This matches 'copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Task areas are clearly sequenced (endpoint → parameters → remote sources with allowlisting steps → redirects → caching → debugging), and the Response codes section (404 on invalid params, 304 on cached) plus the local-dev 404 diagnosis provide error-recovery feedback. It falls short of level 5 because multi-step tasks like remote allowlisting lack an explicit verify step (e.g., curl the transform after adding the pattern), though these aren't destructive/batch operations so no cap applies. | 4 / 5 |
Progressive Disclosure | The bundle structure is exemplary: a dedicated 'User-uploaded image pipelines' section clearly signals the single reference ("see references/user-uploads.md"), which exists and is one level deep with no nested references. The framework table is compact and inline-appropriate, and the body stays an overview of the endpoint. Matches 'clear overview with well-signaled one-level-deep references; content appropriately split'. | 5 / 5 |
Total | 18 / 20 Passed |