본문으로 건너뛰기
에이전트 Skills 전체 목록

Vercel Agent Skills

Vercel이 만든 AI 코딩 에이전트용 스킬 모음. React · Next.js 성능, 웹 UI 점검, 문서 문체 점검, 배포 · 비용 최적화 등 8종. MIT

원본:vercel-labs/agent-skills

요약

Vercel이 만든 AI 코딩 에이전트용 스킬 모음. React · Next.js 성능, 웹 UI 점검, 문서 문체 점검, 배포 · 비용 최적화 등 8종. MIT

설명

Agent Skills

AI 코딩 에이전트를 위한 스킬 모음입니다. 스킬은 에이전트의 능력을 넓혀 주는 묶음 형태의 지시문과 스크립트입니다.

스킬은 Agent Skills 형식을 따릅니다.

skills.sh

쓸 수 있는 스킬

vercel-optimize

Vercel 프로젝트의 비용, 성능, 안정성, 캐싱, 함수 사용량, 요금 청구 개선 기회를 점검합니다. 먼저 Vercel 지표를 모은 다음, 그 지표가 가리키는 경로와 파일만 조사합니다.

이럴 때 쓰세요:

  • 배포된 Vercel 프로젝트를 최적화할 때
  • Vercel 비용이나 함수 사용량을 줄일 때
  • 느리거나 비싼 경로를 조사할 때
  • 캐싱, ISR, 미들웨어, 이미지, 빌드 시간 문제를 찾을 때
  • 우선순위를 매긴 비용 · 성능 보고서를 만들 때

react-best-practices

Vercel 엔지니어링 팀이 만든 React와 Next.js 성능 최적화 지침입니다. 8개 범주에 걸친 40개 넘는 규칙이 영향이 큰 순서로 정리되어 있습니다.

이럴 때 쓰세요:

  • 새 React 컴포넌트나 Next.js 페이지를 쓸 때
  • 데이터 가져오기(클라이언트 또는 서버 쪽)를 구현할 때
  • 성능 문제가 없는지 코드를 검토할 때
  • 번들 크기나 로딩 시간을 최적화할 때

다루는 범주:

  • 워터폴 없애기(치명적)
  • 번들 크기 최적화(치명적)
  • 서버 쪽 성능(높음)
  • 클라이언트 쪽 데이터 가져오기(중간~높음)
  • 다시 그리기 최적화(중간)
  • 렌더링 성능(중간)
  • 자바스크립트 미세 최적화(낮음~중간)

web-design-guidelines

UI 코드가 웹 인터페이스 모범 사례를 지키는지 검토합니다. 접근성, 성능, UX에 걸친 100개 넘는 규칙으로 코드를 점검합니다.

이럴 때 쓰세요:

  • "내 UI를 검토해 줘"
  • "접근성을 확인해 줘"
  • "디자인을 점검해 줘"
  • "UX를 검토해 줘"
  • "내 사이트가 모범 사례에 맞는지 확인해 줘"

다루는 범주:

  • 접근성(aria-label, 시맨틱 HTML, 키보드 핸들러)
  • 포커스 상태(보이는 포커스, focus-visible 패턴)
  • 폼(자동 완성, 검증, 오류 처리)
  • 애니메이션(prefers-reduced-motion, 컴포지터 친화적 변환)
  • 타이포그래피(둥근 따옴표, 줄임표, tabular-nums)
  • 이미지(크기, 지연 로딩, 대체 글)
  • 성능(가상화, 레이아웃 스래싱, preconnect)
  • 내비게이션과 상태(URL에 상태 반영, 딥 링크)
  • 다크 모드와 테마(color-scheme, theme-color 메타)
  • 터치와 상호작용(touch-action, tap-highlight)
  • 지역과 i18n(Intl.DateTimeFormat, Intl.NumberFormat)

writing-guidelines

Vercel 글쓰기 핸드북을 지키는지 문서와 글을 검토합니다. 어조, 구조, 콘텐츠 유형, 코드 예시, 타이포그래피, AI 작업 흐름에 걸친 80개 넘는 규칙으로 페이지를 점검합니다.

이럴 때 쓰세요:

  • "내 문서를 검토해 줘"
  • "글쓰기 스타일을 확인해 줘"
  • "글을 점검해 줘"
  • "문서의 어조와 말투를 검토해 줘"
  • "이 페이지가 글쓰기 핸드북에 맞는지 확인해 줘"

다루는 범주:

  • 기획(콘텐츠 계획, 콘텐츠 유형, 사용자 중심 제목)
  • 어조와 말투(능동태, 직접 호칭, easy · simple · quick 같은 금지어)
  • 콘텐츠 유형별 어조(튜토리얼, 방법 안내, 레퍼런스, 개념 설명, 문제 해결)
  • 제목과 구조(문장형 대소문자, 설명적인 소제목, TL;DR로 시작하기)
  • 목록(언제 쓰는지, 굵은 글씨/설명 형식)
  • 코드(언어 태그, TypeScript 우선, <Steps/>, 80열 · 25줄 제한)
  • 자리 표시자, 단위, 숫자(snake_case 글, 세는 숫자, 64 KB/200 ms)
  • 타이포그래피(문장부호로 쓰는 em 대시 금지, 둥근 따옴표, 줄임표 문자, 줄바꿈 없는 공백)
  • 원본 서식(강제 줄바꿈 금지, --- 줄 금지, 빈 줄 규율)
  • 가격과 금액 페이지(표, 타협 없는 세부)
  • AI 작업 흐름(책임, 기업용 모델, 먼저 계획하기, AI 사용 밝히기)
  • 검토(PR 설명 규율, 작성자 책임)

react-native-guidelines

AI 에이전트에 맞게 다듬은 React Native 모범 사례입니다. 성능, 아키텍처, 플랫폼별 패턴에 걸쳐 7개 절에 16개 규칙이 들어 있습니다.

이럴 때 쓰세요:

  • React Native나 Expo 앱을 만들 때
  • 모바일 성능을 최적화할 때
  • 애니메이션이나 제스처를 구현할 때
  • 네이티브 모듈이나 플랫폼 API를 다룰 때

다루는 범주:

  • 성능(치명적) - FlashList, 메모이제이션, 무거운 연산
  • 레이아웃(높음) - flex 패턴, 안전 영역, 키보드 처리
  • 애니메이션(높음) - Reanimated, 제스처 처리
  • 이미지(중간) - expo-image, 캐싱, 지연 로딩
  • 상태 관리(중간) - Zustand 패턴, React Compiler
  • 아키텍처(중간) - 모노레포 구조, import
  • 플랫폼(중간) - iOS/Android별 패턴

react-view-transitions

React의 View Transition API로 부드럽고 네이티브 같은 애니메이션을 구현합니다. <ViewTransition> 컴포넌트, addTransitionType, 전환 유형, 그리고 next/link의 transitionTypes 속성을 포함한 Next.js 연동을 다룹니다.

이럴 때 쓰세요:

  • 페이지 전환이나 경로 애니메이션을 넣을 때
  • 컴포넌트가 들어오고 나가는 모습을 움직이게 할 때
  • 공유 요소 전환(목록에서 상세로 모핑)을 만들 때
  • 방향이 있는(앞으로/뒤로) 내비게이션 애니메이션을 구현할 때
  • Next.js App Router에 뷰 전환을 연동할 때
  • 목록 순서 변경이나 Suspense 대체 화면 공개를 움직이게 할 때

다루는 주제:

  • <ViewTransition> 컴포넌트(enter, exit, update, share 트리거)
  • 방향과 맥락에 따른 애니메이션을 위한 addTransitionType
  • View Transition 클래스와 CSS 의사 요소
  • name 속성을 쓰는 공유 요소 전환
  • Web Animations API를 쓰는 자바스크립트 애니메이션
  • next/link의 Next.js transitionTypes 속성
  • 바로 쓸 수 있는 CSS 애니메이션 레시피(fade, slide, scale, flip)
  • 접근성(prefers-reduced-motion)

composition-patterns

규모가 커져도 버티는 React 합성 패턴입니다. 컴파운드 컴포넌트, 상태 끌어올리기, 내부 합성으로 불리언 속성이 늘어나는 것을 피하게 돕습니다.

이럴 때 쓰세요:

  • 불리언 속성이 많은 컴포넌트를 리팩터링할 때
  • 재사용할 컴포넌트 라이브러리를 만들 때
  • 유연한 API를 설계할 때
  • 컴포넌트 아키텍처를 검토할 때

다루는 패턴:

  • 컴파운드 컴포넌트 뽑아내기
  • 상태를 끌어올려 속성 줄이기
  • 유연성을 위해 내부를 합성하기
  • 속성 내려보내기(prop drilling) 피하기

deploy-to-vercel

애플리케이션과 웹사이트를 Vercel에 배포합니다. 연결된 프로젝트에서는 git push 배포를 우선하고, 안 되면 Vercel CLI로 대신하며, 로그인할 수 없을 때는 vercel deploy --temporary를 씁니다. 임시 배포는 사용자가 가져갈 수 있도록 claim URL을 돌려줍니다.

이럴 때 쓰세요:

  • "내 앱을 배포해 줘"
  • "이걸 라이브로 올려 줘"
  • "배포하고 링크를 알려 줘"
  • "프리뷰 배포를 만들어 줘"

설치

npx skills add vercel-labs/agent-skills

사용법

스킬은 설치하면 자동으로 쓸 수 있습니다. 에이전트가 관련 작업을 알아채면 그 스킬을 씁니다.

예시:

Deploy my app
Review this React component for performance issues
Help me optimize this Next.js page

탐색 색인

main의 스킬이 바뀔 때마다 변경 불가능한 GitHub 릴리스가 게시되며, 여기에 Agent Skills 탐색 색인과 스킬마다 하나씩의 산출물이 들어 있습니다. 같은 산출물을 로컬에서 만들려면 다음을 실행합니다.

npm ci --ignore-scripts
node scripts/build-discovery-index.mjs https://example.com/skills

스킬 구조

스킬 하나에는 다음이 들어 있습니다.

  • SKILL.md - 에이전트용 지시문
  • scripts/ - 자동화용 보조 스크립트(선택)
  • references/ - 참고 문서(선택)

라이선스

MIT

저장소

vercel-labs/agent-skills

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0