next-cache-components-optimizer

Optimize Next.js routes by refactoring dynamic data access into Suspense boundaries.

Updated Jul 18, 2026
One-click install
npx skills add https://github.com/ri-ru/cyrano --skill next-cache-components-optimizer-ri-ru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-cache-components-optimizer
Source: https://github.com/ri-ru/cyrano/tree/main/.agents/skills/next-cache-components-optimizer
Command: npx skills add https://github.com/ri-ru/cyrano --skill next-cache-components-optimizer-ri-ru

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill addresses performance bottlenecks in Next.js applications using cacheComponents by identifying and optimizing blocking dynamic data access that prevents the rendering of a static shell or causes slow in-app navigation.

Core Features & Use Cases

  • Page-render Optimization: Analyzes and refactors routes to maximize the static shell area by pushing dynamic I/O into granular Suspense boundaries.
  • Instant Navigation Loop: Diagnoses and fixes slow route transitions by identifying SSR-only blockers and implementing private-cache strategies for instant click-to-paint performance.
  • Use Case: Use this when your Next.js app shows a loading spinner for the entire page or feels sluggish when navigating between routes, to ensure users see a static layout immediately.

Quick Start

Initiate the next-dev-loop and then ask the optimizer to diagnose the current page for static shell improvements.

Frequently Asked Questions about next-cache-components-optimizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize Next.js static shells to stop full-page loading spinners?

To optimize Next.js static shells, you must identify blocking dynamic data access and refactor it by pushing dynamic I/O into granular Suspense boundaries. This ensures the static layout renders immediately, preventing full-page loading spinners during route rendering.

Why does my Next.js app feel sluggish when navigating between routes?

Next.js navigation feels sluggish due to SSR-only blockers preventing immediate content delivery. You can fix slow route transitions by identifying these blockers and implementing private-cache strategies to achieve instant click-to-paint performance during in-app transitions.

What is Suspense push-down in Next.js cacheComponents performance optimization?

Suspense push-down is a refactoring lever that maximizes the static shell area in Next.js applications. By pushing dynamic I/O operations into granular Suspense boundaries, it allows the application to deliver a content-shaped UI immediately while async data loads in the background.

How do I diagnose slow route transitions in a Next.js application?

To diagnose slow route transitions in Next.js, initiate a diagnostic capture using an integrated dev-loop and browser agent. This identifies blocking dynamic data access and SSR-only blockers preventing immediate static shell rendering or causing sluggish in-app navigation.

Do I need next-dev-loop and agent-browser to fix Next.js navigation performance?

Yes, fixing Next.js navigation performance requires integration with next-dev-loop and agent-browser. These dependencies perform the necessary diagnostic captures and apply refactoring levers like Suspense push-down and private caching to ensure instant click-to-paint performance.

When should I not use Suspense boundaries for Next.js static shell rendering?

You should avoid over-using Suspense boundaries when the entire page relies on dynamic data, leaving no static shell to render. This optimization targets route-level rendering where a static layout exists but is blocked by dynamic I/O, causing slow in-app navigation.