Content
71%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.
Highly actionable reference content with executable examples and genuinely hard-won gotchas (deploy-time HTML parsing, skeleton file for SSR, extensionless action paths, Akismet false positives). The main defects are build-process artifacts: a duplicated 'house rules' section, leaked merge metadata, and a monolithic all-inline layout with no reference files.
Suggestions
Remove the duplicated 'Netlify house rules' section (lines 167-198) and the stray ctx-gen/manifest comments — all five of its rules are already stated verbatim in the body sections above it.
Add an inline verification step to each setup workflow (e.g., after deploying a framework form: 'confirm the form appears in Forms > Active forms; if not, check the skeleton file field names') so validation is part of the flow, not only the debugging section.
Split long-tail detail (submission-summary field rules, API pagination notes, notification setup) into a references/ file and keep SKILL.md as the overview, restoring the progressive-disclosure structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and lean with no conceptual over-explanation, but the trailing 'Netlify house rules' section (lines 167-198) duplicates verbatim guidance already given above — SSR POST-to-skeleton-file, exact field-name matching, Astro on-demand routes, Akismet false positive, extensionless action paths — and stray build metadata ('merged by ctx-gen', 'manifest commit a28cd46') leaked into the file. This is more than 'minor instances that could be trimmed' (4) but the padding is confined to one section rather than 'several padded sections' (2). | 3 / 5 |
Actionability | Copy-paste-ready code for every common case: static HTML form, skeleton file, JSX form, AJAX submission, file upload, honeypot, and subject line, plus concrete limits (8 MB, 30 s, one file per field) and a prioritized debugging checklist. It matches the 'fully executable; copy-paste ready code; specific examples cover the common cases' anchor. | 5 / 5 |
Workflow Clarity | Each task path is clearly laid out with prerequisites called out ('Enable form detection... Takes effect on the next deploy') and a debugging section that is an explicit verification checklist with error-recovery guidance. It falls short of 5 because the primary setup flows (adding a static or framework form) lack an inline 'verify the form registered' checkpoint — validation lives in a separate debugging section rather than in each workflow. | 4 / 5 |
Progressive Disclosure | Section headers are clear and the only external links are one level deep and well-signaled (Next.js v5 docs, the open-api.netlify.com submissions reference), but no bundle files exist and everything is inlined in a ~195-line body — including a merged 'house rules' block and build comments that clearly belong in a separate source file (the file's own comment says it is merged in by ctx-gen and duplicated from earlier sections). This sits between 'content that should be separate is inline' (3) and 'mostly clear organization gaps' (4). | 3 / 5 |
Total | 15 / 20 Passed |