netlify avatar

Netlify Image Cdn

This guides Claude through Netlify's built-in image transformation endpoint that lives at `/.netlify/images` on every site. You'll want this when you need to serve optimized, responsive images without standing up separate infrastructure. It covers the query parameters for resizing and format conversion, how to allowlist remote images in your config, and some smart redirect patterns for creating clean URLs like `/img/thumb/photo.jpg` instead of exposing query strings. The real value is in the composability: the source shows how to wire up Functions and Blobs for user uploads, then pipe everything through the CDN for automatic optimization and edge caching. No separate service to configure or pay for.

skills.sh installs
3.3K
GitHub stars
51
last updated
Aug 21, 2026

Install

$ npx -y skills add netlify/context-and-tools --skill netlify-image-cdn --agent claude-code

Installs into .claude/skills of the current project.

Files

Netlify Image CDN

Transform images by requesting the endpoint with a url query parameter. This is the current and only documented surface — there is no legacy form.

GET /.netlify/images?url=<source>[&w=][&h=][&fit=][&position=][&fm=][&q=]
# resize a deployed image to 50px wide
curl -vs 'https://mysitename.netlify.app/.netlify/images?url=/owl.jpeg&w=50'

url is required; all other parameters are optional.

Query parameters

ParameterPurposeValuesDefault
urlSource asset (required)Relative path or remote URL—
wWidth in pixelsInteger—
hHeight in pixelsInteger—
fitResize behaviorcontain, cover, fillcontain
positionCrop anchor when fit=covertop, bottom, left, right, centercenter
fmOutput formatavif, jpg, png, webp, gif, blurhashcontent-negotiated
qQuality for lossy outputInteger 1–10075

Common transformations

Sponsors

Details

Repository
github.com/netlify/context-and-tools
Categories
Frontend Development, Backend & APIs, Documentation, Cloud & Infrastructure
First seen
Jun 3, 2026

More from netlify/context-and-tools

All 14
1tradermonty avatardowntrend-duration-analyzertradermonty/claude-trading-skillsAnalyze historical downtrend durations and generate interactive HTML histograms showing typical correction lengths by sector and market cap.3.3Kskills.sh installs
2ar9av avatarwiki-exportar9av/obsidian-wikiExport the Obsidian wiki's knowledge graph to structured formats for use in external tools. Use this skill when the user says "export wiki", "export graph", "ex3.3Kskills.sh installs
3microsoft avatarmemory-leak-auditmicrosoft/vscodeAudit code for memory leaks and disposable issues. Use when reviewing event listeners, DOM handlers, lifecycle callbacks, or fixing leak reports. Covers addDisp3.2Kskills.sh installs
4markdown-viewer avatarmindmapmarkdown-viewer/skillsCreate hierarchical mind maps using PlantUML @startmindmap syntax. Best for brainstorming, topic decomposition, study notes, and decision trees with automatic r3.2Kskills.sh installs
5dpearson2699 avatarrelevancekitdpearson2699/swift-ios-skillsIncrease widget visibility on Apple Watch using RelevanceKit. Use when providing contextual relevance signals for watchOS widgets, declaring time-based or locat3.2Kskills.sh installs
6tradermonty avatarparabolic-short-trade-plannertradermonty/claude-trading-skillsScreen US equities for parabolic exhaustion patterns and generate conditional pre-market short plans, then evaluate intraday trigger fires from live 5-min bars.3.1Kskills.sh installs