CtrlK
BlogDocsLog inGet started
Tessl Logo

netlify-functions

Write, configure, and deploy Netlify serverless functions in TypeScript, JavaScript, or Go. Use this when adding an API endpoint or backend route, adding a contact form handler, wiring auth or Identity signup/login hooks, building streaming or AI-proxy responses, scheduling cron jobs, running long background jobs (batch processing/scraping), reacting to deploy or form events, setting up rate limiting or region/memory config, or reading environment variables and secrets inside a function. Covers file locations, the Request/Context/Response handler shape, path routing, config options, and local testing with netlify dev.

70

Quality

86%

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

The canonical home for this skill is netlify-functions in netlify/context-and-tools

SKILL.md
Quality
Evals
Security

Quality

Content

72%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 dense, highly actionable reference with excellent executable examples and minimal over-explanation, but it is a monolithic single file with no progressive disclosure into bundled references, and it lacks explicit validation feedback loops for its batch/destructive use cases.

Suggestions

Split the config reference, the Legacy/Go section, and the 'Netlify house rules' into separate reference files linked one level deep from SKILL.md to improve progressive disclosure.

Add explicit validate-fix-retry checkpoints for batch/destructive operations (e.g., after invoking a scheduled or background function locally, verify the side effect before deploying).

De-duplicate the 'Netlify house rules' section against the body — each rule already appears inline above, so consolidate to remove the repetition and recover token budget.

DimensionReasoningScore

Conciseness

Largely lean and reference-style with no padding explaining concepts Claude already knows, but the trailing 'Netlify house rules' section restates several points already made in the body (geo mocking, memory/vcpu, region, 4 KB env limit), which is duplication that could be trimmed.

4 / 5

Actionability

Fully executable, copy-paste-ready code examples cover the common cases — minimal handler, path routing, integrations, streaming, background, scheduled, and event handlers — each with complete config and imports.

5 / 5

Workflow Clarity

Sections are well organized and the 'Local testing & deploy' section gives a rough sequence, but there are no explicit multi-step validation checkpoints or validate-fix-retry feedback loops for the batch/destructive operations the skill describes (background jobs, batch processing), which caps this dimension.

3 / 5

Progressive Disclosure

Section headers are clear and navigation within the file is easy, but for a ~300-line skill the content is monolithic with no one-level-deep external references — material like the full config reference, house rules, and legacy/Go guidance that could live in separate files is all inlined.

3 / 5

Total

15

/

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.

A strong, third-person description that concretely enumerates capabilities and provides an explicit, exhaustive 'Use this when...' trigger clause covering the full range of function use cases. It is specific, comprehensive, and clearly distinguishable from other skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Write, configure, and deploy', 'adding an API endpoint or backend route', 'wiring auth or Identity signup/login hooks', 'scheduling cron jobs', 'building streaming or AI-proxy responses' — giving comprehensive coverage of the skill's capabilities.

5 / 5

Completeness

Explicitly answers both 'what' ('Write, configure, and deploy Netlify serverless functions... Covers file locations, the Request/Context/Response handler shape, path routing, config options') and 'when' ('Use this when adding an API endpoint...') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Comprehensive natural terms users would actually say — 'API endpoint', 'contact form handler', 'cron jobs', 'background jobs', 'batch processing/scraping', 'rate limiting', 'environment variables and secrets' — including synonyms and variants.

5 / 5

Distinctiveness Conflict Risk

Clearly scoped to Netlify serverless functions with Netlify-specific triggers (Identity signup/login, netlify dev, deploy events), giving it a distinct niche with minimal conflict risk against other skills.

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.