Claude Code나 Cursor 같은 AI 코딩 도구를 쓰다 보면 한계를 느끼는 순간이 있습니다. “React 성능 최적화 도와줘”라고 했더니 교과서적인 답변만 나오고, “이 PR 코드 리뷰해줘”라고 하면 매번 다른 기준으로 리뷰합니다. AI 모델이 부족한 게 아닙니다. 그 분야에 맞는 전문 지식과 작업 절차가 없어서입니다.

skills.sh는 이 문제를 해결하기 위해 Vercel이 만든 오픈 에코시스템입니다. 쉽게 말하면, AI 에이전트를 위한 앱스토어 같은 것입니다. Vercel, Anthropic, Microsoft, Supabase, shadcn 같은 팀들이 직접 만든 전문 스킬을 명령어 한 줄로 설치해서 내 에이전트에 장착할 수 있습니다.

이 시리즈에서는 skills.sh에 올라와 있는 공개 스킬들을 하나씩 직접 써보고 소개합니다. 첫 번째로, 이 생태계의 입구 역할을 하는 find-skills 스킬입니다.

”스킬”이 뭔가요?

VS Code에 확장(Extension)을 설치하면 기능이 추가되는 것처럼, AI 에이전트에도 스킬을 설치하면 새로운 능력이 생깁니다.

스킬은 “이 상황에서는 이렇게 판단하고, 이 순서대로 일하세요”라는 지침서입니다. 예를 들어 supabase-postgres-best-practices 스킬을 설치하면, 에이전트가 Supabase로 DB를 설계할 때 RLS 정책, 인덱스 최적화, 실시간 구독 패턴을 자동으로 고려합니다. 스킬 없이도 “Supabase RLS가 뭐야?”라고 물어볼 수는 있지만, 스킬이 있으면 물어보지 않아도 알아서 적용합니다.

skills.sh란?

skills.sh는 이런 스킬들을 올리고 내려받는 디렉토리입니다. 2026년 4월 기준 260개 이상의 스킬이 등록되어 있고, 총 설치 횟수는 91만 회를 넘습니다.

올려둔 팀들을 보면 신뢰도를 가늠할 수 있습니다:

• Vercel — React, Next.js, 웹 디자인 스킬 (각 20~26만 설치)
• Anthropic — Claude 전용 프론트엔드, 문서 작업 스킬 (각 20만 설치)
• Supabase — Postgres 설계 스킬 (5.7만 설치)
• shadcn — shadcn/ui 컴포넌트 스킬 (5.1만 설치)
• Microsoft — Azure, GitHub Copilot 시리즈

스킬을 설치하고 관리하는 도구는 npx skills입니다. npx는 Node.js에 포함된 명령어로, 프로그램을 따로 설치하지 않아도 바로 실행할 수 있습니다. Claude Code를 이미 쓰고 있다면 Node.js는 이미 설치되어 있습니다.

# 원하는 스킬 이름으로 검색
npx skills find react

# 스킬 설치 (owner/repo 형태로 지정)
npx skills add vercel-labs/agent-skills

# 내 에이전트에 설치된 스킬 목록 확인
npx skills list

# 설치된 스킬 최신 버전으로 업데이트
npx skills update

find-skills: 스킬을 찾아주는 스킬

설치해야 할 스킬이 많으면 뭘 먼저 써야 할지 막막합니다. find-skills는 이 문제를 해결합니다. 이 스킬을 에이전트에 설치해두면, “어떤 태스크를 해야 하는데 적합한 스킬이 있어?”라고 물었을 때 에이전트가 직접 skills.sh 리더보드를 뒤져서 추천해주고 설치까지 해줍니다.

skills.sh 전체 리더보드에서 1위(77만 설치)인 이유가 여기 있습니다. 이걸 먼저 깔면 나머지는 에이전트한테 물어보면 됩니다.

설치하기

터미널을 열고 프로젝트 폴더로 이동한 다음 아래 명령어를 실행합니다.

# Claude Code에 설치 (프로젝트 전용)
npx skills add vercel-labs/skills --skill find-skills -a claude-code

# Claude Code에 전역 설치 (모든 프로젝트에서 사용)
npx skills add vercel-labs/skills --skill find-skills -g -a claude-code

-g(global)를 붙이면 딱 한 번 설치해도 앞으로 모든 프로젝트에서 쓸 수 있습니다. 처음이라면 -g를 붙이는 편이 편합니다.

Cursor, Codex, Gemini를 쓰신다면:

# Cursor에 설치
npx skills add vercel-labs/skills --skill find-skills -a cursor

# Antigravity(Gemini)에 설치
npx skills add vercel-labs/skills --skill find-skills -a antigravity

# 여러 에이전트에 동시 설치
npx skills add vercel-labs/skills --skill find-skills -a claude-code -a cursor

실제로 써보면

설치 후 Claude Code에서 이렇게 물어보면 됩니다.

”Playwright 테스트 작성할 때 도움받을 스킬 있어?"

Agent: playwright-best-practices 스킬을 추천합니다.
       (currents-dev, 1.8만 설치)
       
       Playwright 테스트 파일 구조, CI/CD 연동, 병렬 테스트 설정 방법 등을
       전문적으로 가이드해주는 스킬입니다.
       
       설치 커맨드: npx skills add currents-dev/playwright-best-practices-skill
       더 보기: https://skills.sh/currents-dev/playwright-best-practices-skill
       
       지금 설치해 드릴까요?

"Supabase로 DB 설계할 건데 관련 스킬 있어?”

Agent: Supabase 공식 스킬이 있습니다.
       supabase-postgres-best-practices (Supabase 공식, 5.7만 설치)
       
       RLS 보안 정책, 인덱스 최적화, 실시간 구독 패턴 등
       Supabase 특화 PostgreSQL 설계 가이드를 제공합니다.
       
       설치: npx skills add supabase/agent-skills

에이전트가 추천할 때는 단순히 키워드가 비슷한 스킬을 가져오는 게 아닙니다. 설치 수 1,000 이상 여부, Vercel·Anthropic·Microsoft처럼 신뢰할 수 있는 퍼블리셔인지, GitHub 스타 수를 함께 따져서 검증된 스킬만 제안합니다.

이럴 때 쓰세요 / 이럴 때는 안 맞아요

잘 맞는 상황	덜 맞는 상황
어떤 스킬이 있는지 탐색하고 싶을 때	이미 설치할 스킬 이름을 알고 있을 때
새 프로젝트 시작 전 스킬 세트 구성	오프라인 환경 (skills.sh 접속 필요)
신뢰할 수 있는 스킬만 추천받고 싶을 때	설치 수가 적은 실험적 스킬을 탐색할 때

Vercel이 만든 다른 스킬들

vercel-labs/skills 레포는 find-skills 하나만 들어 있습니다. Vercel의 개발 관련 스킬들(React, Next.js, 웹 디자인 등)은 별도 레포에 있습니다.

# 어떤 스킬들이 있는지 목록 먼저 확인
npx skills add vercel-labs/agent-skills --list

# 이 시리즈 다음 편에서 다루는 스킬이 여기 있습니다
# vercel-react-best-practices, web-design-guidelines, deploy-to-vercel 등

자주 묻는 질문 (FAQ)

Q1: skills.sh 스킬은 유료인가요?

스킬 자체는 GitHub에 공개된 텍스트 파일(SKILL.md)입니다. npx skills add로 설치하는 것은 완전 무료입니다. 단, 스킬이 내부적으로 외부 API(예: ElevenLabs 음성 생성, Pollinations 이미지 생성)를 호출하도록 설계된 경우에는 해당 서비스의 요금 정책을 따릅니다.

Q2: Claude Code가 없으면 못 쓰나요?

아닙니다. Cursor, Codex, Gemini(Antigravity), OpenCode, Replit 등 총 41개 에이전트를 지원합니다. -a 옵션으로 설치할 에이전트를 지정하면 됩니다.

Q3: 스킬 설치 후 바로 적용되나요?

Claude Code 기준으로, 설치 후 새 세션을 시작하면 자동으로 적용됩니다. 현재 열려 있는 세션에 바로 적용하려면 /reload 명령을 실행합니다.

---