Communitygithub.com

ASoudy/AGS

Vercel 엔지니어링 팀이 제공하는 React 및 Next.js 성능 최적화 가이드라인입니다. React/Next.js 코드를 작성, 검토 또는 리팩토링할 때 최적의 성능 패턴을 적용하는 데 사용됩니다.

AGS란 무엇인가요?

이 스킬은 Vercel 엔지니어링 팀이 유지 관리하는 React 및 Next.js 애플리케이션 성능 최적화 가이드라인을 제공합니다. 총 8개 카테고리, 45개의 규칙으로 구성되어 있으며, 각 규칙은 영향도에 따라 우선순위가 매겨져 자동 리팩토링과 코드 생성을 지원합니다. 주요 카테고리는 워터폴 제거(중대), 번들 크기 최적화(중대), 서버 측 성능(높음), 클라이언트 측 데이터 페칭(중간-높음), 리렌더링 최적화(중간), 렌더링 성능(중간), JavaScript 성능(낮음-중간), 고급 패턴(낮음)입니다. 이 스킬은 Claude Code, Cursor, Codex 등의 AI 에이전트가 React 컴포넌트나 Next.js 페이지를 작성할 때, 데이터 페칭을 구현할 때, 성능 이슈를 리뷰하거나 리팩토링할 때, 번들 크기나 로딩 시간을 최적화할 때 자동으로 활성화됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/vercel-react-best-practices

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

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

문서

Vercel React 모범 사례

React 및 Next.js 애플리케이션을 위한 포괄적인 성능 최적화 가이드, Vercel 유지 관리. 8개 카테고리, 45개 규칙으로 구성되며, 영향도에 따라 우선순위가 매겨져 자동 리팩토링 및 코드 생성을 안내합니다.

적용 시점

다음과 같은 경우 이 가이드라인을 참고하세요:

  • 새 React 컴포넌트나 Next.js 페이지를 작성할 때
  • 데이터 페칭(클라이언트 또는 서버 측)을 구현할 때
  • 성능 이슈에 대해 코드를 검토할 때
  • 기존 React/Next.js 코드를 리팩토링할 때
  • 번들 크기나 로딩 시간을 최적화할 때

우선순위별 규칙 카테고리

우선순위카테고리영향도접두사
1워터폴 제거중대async-
2번들 크기 최적화중대bundle-
3서버 측 성능높음server-
4클라이언트 측 데이터 페칭중간-높음client-
5리렌더링 최적화중간rerender-
6렌더링 성능중간rendering-
7JavaScript 성능낮음-중간js-
8고급 패턴낮음advanced-

빠른 참조

1. 워터폴 제거 (중대)

  • async-defer-await - 실제로 사용되는 분기에서 await 사용
  • async-parallel - 독립적인 작업에는 Promise.all() 사용
  • async-dependencies - 부분 종속성에는 better-all 사용
  • async-api-routes - API 라우트에서 Promise를 일찍 시작하고 나중에 await
  • async-suspense-boundaries - Suspense를 사용하여 콘텐츠 스트리밍

2. 번들 크기 최적화 (중대)

  • bundle-barrel-imports - 직접 가져오기, 배럴 파일 피하기
  • bundle-dynamic-imports - 무거운 컴포넌트에는 next/dynamic 사용
  • bundle-defer-third-party - 분석/로깅은 하이드레이션 후 로드
  • bundle-conditional - 기능이 활성화된 경우에만 모듈 로드
  • bundle-preload - 호버/포커스 시 미리 로드하여 체감 속도 향상

3. 서버 측 성능 (높음)

  • server-cache-react - React.cache()를 사용하여 요청별 중복 제거
  • server-cache-lru - LRU 캐시를 사용하여 요청 간 캐싱
  • server-serialization - 클라이언트 컴포넌트에 전달되는 데이터 최소화
  • server-parallel-fetching - 페치를 병렬화하도록 컴포넌트 재구성
  • server-after-nonblocking - after()를 사용하여 비차단 작업 수행

4. 클라이언트 측 데이터 페칭 (중간-높음)

  • client-swr-dedup - SWR을 사용하여 자동 요청 중복 제거
  • client-event-listeners - 전역 이벤트 리스너 중복 제거

5. 리렌더링 최적화 (중간)

  • rerender-defer-reads - 콜백에서만 사용되는 상태를 구독하지 않기
  • rerender-memo - 비용이 많이 드는 작업을 메모이제이션된 컴포넌트로 추출
  • rerender-dependencies - Effect에서 원시 종속성 사용
  • rerender-derived-state - 원시 값이 아닌 파생된 불리언 구독
  • rerender-functional-setstate - 함수형 setState를 사용하여 안정적인 콜백 유지
  • rerender-lazy-state-init - 비용이 큰 값에는 함수를 useState에 전달
  • rerender-transitions - 긴급하지 않은 업데이트에는 startTransition 사용

6. 렌더링 성능 (중간)

  • rendering-animate-svg-wrapper - SVG 요소 대신 div 래퍼에 애니메이션 적용
  • rendering-content-visibility - 긴 목록에는 content-visibility 사용
  • rendering-hoist-jsx - 정적 JSX를 컴포넌트 외부로 추출
  • rendering-svg-precision - SVG 좌표 정밀도 줄이기
  • rendering-hydration-no-flicker - 클라이언트 전용 데이터에 인라인 스크립트 사용
  • rendering-activity - 표시/숨김에는 Activity 컴포넌트 사용
  • rendering-conditional-render - 조건부 렌더링에는 && 대신 삼항 연산자 사용

7. JavaScript 성능 (낮음-중간)

  • js-batch-dom-css - 클래스나 cssText를 통해 CSS 변경 그룹화
  • js-index-maps - 반복 조회에는 Map 구축
  • js-cache-property-access - 루프에서 객체 속성 캐싱
  • js-cache-function-results - 모듈 수준 Map에 함수 결과 캐싱
  • js-cache-storage - localStorage/sessionStorage 읽기 캐싱
  • js-combine-iterations - 여러 filter/map을 하나의 루프로 결합
  • js-length-check-first - 비용이 큰 비교 전에 배열 길이 확인
  • js-early-exit - 함수에서 조기 반환
  • js-hoist-regexp - RegExp 생성을 루프 외부로 이동
  • js-min-max-loop - sort 대신 루프로 최소/최대값 구하기
  • js-set-map-lookups - O(1) 조회를 위해 Set/Map 사용
  • js-tosorted-immutable - 불변성을 위해 toSorted() 사용

8. 고급 패턴 (낮음)

  • advanced-event-handler-refs - 이벤트 핸들러를 ref에 저장
  • advanced-use-latest - 안정적인 콜백 ref를 위해 useLatest 사용

사용 방법

자세한 설명과 코드 예제는 개별 규칙 파일을 참조하세요:

rules/async-parallel.md
rules/bundle-barrel-imports.md
rules/_sections.md

각 규칙 파일에는 다음이 포함됩니다:

  • 규칙이 중요한 이유에 대한 간략한 설명
  • 설명이 포함된 잘못된 코드 예제
  • 설명이 포함된 올바른 코드 예제
  • 추가 컨텍스트 및 참고 자료

전체 컴파일 문서

모든 규칙이 확장된 전체 가이드는 다음 파일을 참조하세요: AGENTS.md

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬