Communitygithub.com

ComeOnOliver/skillshub

Next.js의 4가지 캐싱 레이어. Next.js에서 요청 메모이제이션, 데이터 캐시, 전체 라우트 캐시, 라우터 캐시를 구성할 때 사용합니다.

skillshub란 무엇인가요?

이 스킬은 Next.js 애플리케이션의 성능 최적화에 필수적인 4가지 캐싱 레이어(Request Memoization, Data Cache, Full Route Cache, Router Cache)를 이해하고 올바르게 구성할 수 있도록 도와줍니다. 개발자는 `fetch`, `unstable_cache`, `'use cache'` 디렉티브, `revalidateTag`, `revalidatePath`, `router.refresh()` 등 다양한 캐싱 메커니즘을 상황에 맞게 활용하여 오래된 데이터로 인한 버그를 방지할 수 있습니다. 특히 Next.js 15 이상과 16+ 버전에서 권장되는 패턴을 명확히 제시하며, 각 레이어별 제어 방법과 효과적인 무효화 전략을 상세히 설명합니다. 이 스킬은 `**/page.tsx`, `**/layout.tsx`, `**/action.ts` 파일과 `unstable_cache`, `revalidateTag`, Router Cache, Data Cache 관련 코드를 작성할 때 자동으로 트리거되어 개발자가 최적의 캐싱 전략을 수립하도록 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/HoangNguyen0403/agent-skills-standard/nextjs-caching

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

캐싱 아키텍처

우선순위: P1 (높음)

Next.js에는 4가지 고유한 캐싱 레이어가 있습니다. 이들을 이해하면 오래된 데이터 버그를 방지할 수 있습니다.

구현 지침

  • Next.js 15+ 표준: API 호출에는 fetch 와 함께 revalidate: number 또는 cache: 'force-cache'** 를 사용하세요. 사용자 정의 데이터 저장소에는 **unstable_cache** 또는 새로운 **'use cache'` (실험적)를 사용하세요.
  • 레이어: 데이터 캐시 (요청 간 지속)와 요청 메모이제이션 (React 생명 주기와 관련)을 구분하세요. 단일 렌더링 내에서 fetch를 중복 제거하려면 React의 cache() 를 사용하세요.
  • 무효화: 변이 후 revalidatePath('/') 를 사용하거나 세분화된 캐시 제거를 위해 revalidateTag('tag-name') 를 사용하세요.
  • 클라이언트 캐시: 라우터 캐시 (클라이언트의 메모리 내)와 30초에서 1분 수명을 이해하세요. router.refresh() 를 사용하여 지우세요.
  • 정적 자산: 빌드 시 정적 경로를 사전 렌더링하기 위해 generateStaticParams 를 활용하세요. 주기적으로 업데이트되는 콘텐츠에는 ISR (증분 정적 재생성) 을 사용하세요.
  • 스트리밍: 느린 데이터가 전체 페이지 렌더링을 차단하지 않도록 Suspense 와 fetch 트리거를 결합하세요.
  • Next.js 16+: 가능한 경우 revalidate: number 대신 'use cache' 와 cacheLife() 를 선호하여 결정론적 캐싱을 구현하세요.
레이어위치제어 방식
요청 메모이제이션서버React cache()
데이터 캐시서버'use cache', revalidateTag
전체 라우트 캐시서버정적 사전 렌더링
라우터 캐시클라이언트router.refresh()

구현 세부사항

자세한 키 생성, 클로저 제약 조건, 무효화 전략은 캐시 컴포넌트 및 PPR을 참조하세요.

안티 패턴

  • Next.js 16+에서 unstable_cache 사용 금지: 대신 'use cache' 디렉티브와 cacheLife()를 사용하세요.
  • 서버 데이터에 router.refresh() 사용 금지: 대상 캐시 제거에는 revalidateTag()를 선호하세요.
  • 라우트 수준에서 사용자별 데이터 캐싱 금지: 개인 데이터는 'use cache'와 함께 <Suspense>로 감싸세요.
  • 태그 없이 장기 캐시 사용 금지: 세분화된 무효화 제어를 위해 cacheTag()를 할당하세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬