Diagnose Vercel CDN and ISR cache behavior using metrics, logs, and response headers.
npx skills add https://github.com/AarnavBaddam/skills --skill cdn-caching-aarnavbaddam
Please help me install this Agent Skill. Skill: cdn-caching Source: https://github.com/AarnavBaddam/skills/tree/main/cdn-caching Command: npx skills add https://github.com/AarnavBaddam/skills --skill cdn-caching-aarnavbaddam
vercel metrics grouped by cache_result, then drill into MISS buckets by path type and route. - ISR cost investigation: Quantify read/write units, compute write utilization, and find hot cache tags with large blast radius driving revalidation spend. - Per-request debugging: Interpret x-vercel-cache status and the nine cacheReason values (cold, collapsed, draft_mode, stale_tag, etc.) via curl and vercel logs. - Use Case: Your ISR bill spiked after a CMS webhook change. Use this Skill to group write units by cache_tags, discover a broad blogPost tag invalidating thousands of pages, and switch to granular blogPost:<id> tags. ## Quick Start Ask the agent to analyze why your Vercel site's cache hit rate dropped and which routes are driving ISR write costs.High-intent search queries and answers about installing and using this skill.
Run `vercel metrics vercel.request.count` grouped by `cache_result` filtered to production. Treat HIT, STALE, and PRERENDER as cache-served, and exclude BYPASS and unset values so non-cacheable traffic does not distort the ratio.
High ISR cost usually comes from write units driven by frequent revalidation, not traffic volume. Group `vercel.isr_operation.write_units` by route and cache_tags to find broad tags with a large blast radius, then prefer granular tags and on-demand invalidation over short time-based intervals.
BYPASS means caching was skipped for that request, commonly due to Draft Mode, prerender-bypass cookies, SEO crawler user agents, or headers like no-store and private. The cacheReason values draft_mode, prerender_bypass, and crawler explain which cause applies.
Invalidate (invalidateByTag, revalidateTag) uses stale-while-revalidate, serving stale content while regenerating in the background. Dangerously-delete (dangerouslyDeleteByTag, updateTag) hard-removes entries, so the next request blocks in the foreground and shows REVALIDATED.
No. A PPR route has dynamic holes by definition, so even on a cached shell hit the function still runs to render the dynamic content. Only a route with no holes serves as a pure prerender HIT without invoking a function.
A path that should cache but shows MISS usually has Cache-Control set to private, no-store, or max-age=0, uses per-request inputs like cookies or searchParams, or responds to an uncacheable method. Inspect headers with curl and check x-matched-path for rewrite variants.
openaiDiagnose Vercel CDN cache hit rates, stale content, revalidation behavior, and ISR costs.
costrict-plugins-repoConfigure CDN caching, cache keys, tags, and purging for Netlify Functions and Edge Functions.
ChristineThamConfigure Vercel Firewall rules for DDoS mitigation and bot management.
sabiscoreDesigns caching and rendering strategies for Next.js, serverless, and CDN architectures.