CtrlK
BlogDocsLog inGet started
Tessl Logo

netlify-frameworks

Deploy and configure web frameworks on Netlify — build settings and SSR/edge adapters plus local platform emulation and env vars. Use when setting up or fixing a framework deploy (Next.js / Astro / Nuxt / SvelteKit / Remix / React Router / TanStack Start / SolidStart / Gatsby / Angular / Vite / Express / Hydrogen / Hugo / Eleventy / Vue / React), adding SSR or edge functions or middleware wired to Netlify context, fixing SPA redirect and catch-all rules, setting a build command or publish directory, or debugging "why isn't my env var updating" and framework build failures.

74

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, highly actionable reference body: concrete commands, complete code samples, and dense tables that assume the reader's competence. Its weaknesses are structural rather than informational — a duplicated merged 'house rules' block, inlined per-framework depth that blurs the overview/reference split, and no explicit verification checkpoints after deploys or config changes.

Suggestions

Deduplicate the merged 'house rules' section: rules 1-6 restate content already in the body (env-var redeploy, SPA catch-all, netlify dev #custom, client-prefix secrets); keep only the net-new rules (Next.js skew-protection version conditions and client fetch options) inline, ideally folded into the existing sections they belong to.

Move deep per-framework detail (e.g., the full Gatsby version matrix, Express serverless-http example, Angular SSR/Image-CDN specifics) into the corresponding references/*.md guides, keeping SKILL.md as a routing layer with the build-settings table and the framework-agnostic gotchas.

Add a short verification step to workflows: after a deploy or env-var change, confirm the change is live (e.g., check the deployed function's env or hit the SSR route) before treating the task as done — currently only the 'redeploy required' rule hints at this.

DimensionReasoningScore

Conciseness

The body is dense tables and terse commands with essentially no concept-teaching padding ('Env values are injected at build time... requires a redeploy'; build-settings tables), so it is well above the midpoint. Not 5: the ~37-line merged 'house rules' block at the bottom restates four rules already stated above (env-var redeploy, SPA catch-all removal, netlify dev #custom, client-prefix secrets), which could be trimmed to only the net-new rules 7-8.

4 / 5

Actionability

Guidance is copy-paste ready throughout: 'npx astro add netlify', 'npm install -D @sveltejs/adapter-netlify' with the exact svelte.config snippet, a complete Express serverless-http example with its netlify.toml, and per-framework build/publish tables. Common cases are covered with specific executable commands; the only placeholders (dist/YOUR_PROJECT_NAME, '(vite)') are inherent to the task, not missing detail.

5 / 5

Workflow Clarity

The skill is reference/lookup-shaped rather than a single linear workflow, and it sequences well: 'Env vars: modern rules (read first)' up front, routing to per-framework guides, then per-framework setup (install → configure → build/deploy) with explicit gotchas. Not 5: there are no explicit validation checkpoints (e.g., verify the deploy picked up the env var or that the adapter built server output) — the redeploy-after-env-change rule is the only checkpoint-like guidance, and it is implicit rather than a step in a sequence.

4 / 5

Progressive Disclosure

The six referenced files (references/astro.md, nextjs.md, nuxt.md, sveltekit.md, tanstack.md, vite.md) all exist, are one level deep, and are clearly signaled both in the opening routing line and in context (e.g., 'Details in references/nextjs.md', 'see references/tanstack.md'). Not 5: substantial per-framework depth (full Gatsby, Angular, Next.js, Express sections with code) is inlined in SKILL.md itself, so the body is a dense reference rather than a concise overview that appropriately splits detail into the guides.

4 / 5

Total

17

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: third-person, concrete capability list, explicit 'Use when...' trigger clause with a quoted natural user phrase, exhaustive framework-name keywords, and a well-defined Netlify niche. No fluff or over-claims despite its length — every clause is a trigger or a capability.

DimensionReasoningScore

Specificity

Phrases like 'build settings and SSR/edge adapters plus local platform emulation and env vars', 'adding SSR or edge functions or middleware wired to Netlify context', 'fixing SPA redirect and catch-all rules', and 'setting a build command or publish directory' list multiple specific concrete actions with comprehensive coverage of the skill's domain. Not 4: there are no minor coverage gaps — the actions span deploy, adapter setup, redirects, build settings, and env-var debugging.

5 / 5

Completeness

Explicitly answers what ('Deploy and configure web frameworks on Netlify — build settings and SSR/edge adapters plus local platform emulation and env vars') and when ('Use when setting up or fixing a framework deploy... adding SSR or edge functions... fixing SPA redirect and catch-all rules...'). Both what and when are present with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Includes natural user phrases like "debugging 'why isn't my env var updating'", 'setting a build command or publish directory', and 'framework build failures', plus exhaustive framework-name coverage (Next.js / Astro / Nuxt / SvelteKit / Remix / React Router / TanStack Start / SolidStart / Gatsby / Angular / Vite / Express / Hydrogen / Hugo / Eleventy / Vue / React). Comprehensive natural-term coverage including synonyms; nothing a user would plausibly say is missing.

5 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear niche ('on Netlify') with framework-specific triggers, so it is distinguishable from generic framework or deploy skills and unlikely to trigger for the wrong skill. It even scopes edge cases like SPA redirect rules and env-var redeploy behavior, which only this skill would claim.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
netlify/context-and-tools
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.