Skills 소개
Skills는 Vercel이 2026년 1월에 공개한 AI 에이전트(Agent)를 위한 오픈소스 스킬 생태계(Open Agent Skills Ecosystem) 입니다. 개발자가 AI 에이전트에게 필요한 도구(Tool)나 절차적 지식(Procedural Knowledge)을 손쉽게 추가하고 관리할 수 있도록 돕는 표준화된 플랫폼이자 커맨드 라인 도구(CLI)입니다.
최근 AI 개발 환경에서는 대규모 언어 모델(LLM)이 단순히 텍스트를 생성하는 것을 넘어, 외부 시스템과 상호작용하며 작업을 수행하는 에이전트(Agent)의 역할이 중요해졌습니다. 하지만 에이전트가 특정 작업을 수행하려면 해당 도구의 사용법과 API 정의를 일일이 학습하거나 프롬프트에 포함해야 했습니다. 이는 개발자가 매번 도구 정의(JSON Schema 등)를 직접 작성하고 유지보수해야 하는 콜드 스타트(Cold Start) 문제를 야기했습니다.
Vercel이 공개한 Skills는 이러한 문제를 해결하기 위해 등장했습니다. 마치 npm으로 라이브러리를 설치하듯, npx skills add 명령어 한 줄로 에이전트에게 필요한 능력(예: GitHub PR 생성, Linear 티켓 관리, 브라우저 자동화 등)을 즉시 부여할 수 있습니다. 이를 통해 개발자는 도구의 정의를 처음부터 작성할 필요 없이, 검증된 스킬 패키지를 자신의 프로젝트에 바로 통합할 수 있습니다.
Vercel의 SKills vs.기존 방식(Manual Tool Definition)과 비교
기존에 AI 에이전트에게 도구를 제공하려면 개발자가 다음과 같은 과정을 거쳐야 했습니다:
- 사용하려는 API의 문서를 분석합니다.
- OpenAI Function Calling 포맷 등에 맞춰 복잡한 JSON 스키마를 직접 작성합니다.
- 도구의 실행 로직을 코드로 구현하고, 모델이 올바르게 호출하는지 반복적으로 테스트합니다.
- API가 변경되면 스키마와 코드를 모두 수동으로 업데이트해야 합니다.
반면, Skills를 사용하면 다음과 같이 간소화됩니다:
- Skills 생태계에서 필요한 스킬을 검색합니다.
- CLI 명령어로 스킬을 프로젝트에 설치합니다. (자동으로 구성 파일이나
SKILL.md가 생성됨) - 에이전트는 표준화된 형식을 통해 즉시 해당 스킬을 인식하고 사용할 수 있습니다.
Vercel이 공개한 Skills의 주요 특징
Skills 생태계는 크게 CLI 도구, 표준화된 스킬 정의 포맷, 그리고 스킬을 검색할 수 있는 레지스트리로 구성됩니다.
표준화된 스킬 정의 (SKILL.md)
Skills 생태계의 핵심은 사람이 읽을 수 있으면서도 AI가 이해하기 쉬운 마크다운(Markdown) 기반의 정의 방식입니다. 각 스킬은 일반적으로 SKILL.md 파일로 정의되며, 다음과 같은 구조를 가집니다:
-
YAML Frontmatter: 스킬의 이름(
name)과 설명(description)을 정의하여 에이전트가 언제 이 스킬을 사용해야 할지 판단하게 합니다. -
지시문(Instructions): 마크다운 본문에 에이전트가 따라야 할 구체적인 절차, 규칙, 코드 패턴 등을 기술합니다.
간편한 Skills CLI (npx skills)
별도의 설치 없이 npx를 통해 즉시 사용할 수 있는 CLI 도구입니다. 이 도구는 스킬 패키지를 다운로드하고 에이전트의 설정(예: .github/skills/ 또는 로컬 설정 디렉터리)에 맞게 파일을 배치합니다:
# 스킬 설치 예시
npx skills add <owner>/<skill-name>
위 명령어를 실행하면 원격 저장소에서 스킬 정의 파일을 가져와 프로젝트 내에 설치합니다. 이후 Claude Code, Cursor, Windsurf와 같은 AI 코딩 에이전트나 Vercel AI SDK로 구축된 커스텀 에이전트가 이 파일을 참조하여 능력을 확장합니다.
예를 들어, Vercel 팀이 제공하는 에이전트 스킬 모음을 설치하려면 다음과 같이 입력합니다:
# Vercel이 제공하는 Agent Skill 모음(https://github.com/vercel-labs/agent-skills) 설치를 위한 명령어
npx skills add vercel-labs/agent-skills
여러 AI 에이전트를 지원하는 호환성 및 확장성
Skills는 특정 플랫폼에 종속되지 않도록 설계되었습니다.
- 지원 에이전트: Claude Code, Cursor, Windsurf, Vercel Agent 등 다양한 AI 코딩 도구와 호환됩니다. 지원하는 전체 에이전트 목록 및 설치 위치는 다음과 같습니다:
| Agent | --agent |
Project Path | Global Path |
|---|---|---|---|
| Amp, Kimi Code CLI | amp, kimi-cli |
.agents/skills/ |
~/.config/agents/skills/ |
| Antigravity | antigravity |
.agent/skills/ |
~/.gemini/antigravity/global_skills/ |
| Claude Code | claude-code |
.claude/skills/ |
~/.claude/skills/ |
| Moltbot | moltbot |
skills/ |
~/.moltbot/skills/ |
| Cline | cline |
.cline/skills/ |
~/.cline/skills/ |
| CodeBuddy | codebuddy |
.codebuddy/skills/ |
~/.codebuddy/skills/ |
| Codex | codex |
.codex/skills/ |
~/.codex/skills/ |
| Command Code | command-code |
.commandcode/skills/ |
~/.commandcode/skills/ |
| Continue | continue |
.continue/skills/ |
~/.continue/skills/ |
| Crush | crush |
.crush/skills/ |
~/.config/crush/skills/ |
| Cursor | cursor |
.cursor/skills/ |
~/.cursor/skills/ |
| Droid | droid |
.factory/skills/ |
~/.factory/skills/ |
| Gemini CLI | gemini-cli |
.gemini/skills/ |
~/.gemini/skills/ |
| GitHub Copilot | github-copilot |
.github/skills/ |
~/.copilot/skills/ |
| Goose | goose |
.goose/skills/ |
~/.config/goose/skills/ |
| Junie | junie |
.junie/skills/ |
~/.junie/skills/ |
| Kilo Code | kilo |
.kilocode/skills/ |
~/.kilocode/skills/ |
| Kiro CLI | kiro-cli |
.kiro/skills/ |
~/.kiro/skills/ |
| Kode | kode |
.kode/skills/ |
~/.kode/skills/ |
| MCPJam | mcpjam |
.mcpjam/skills/ |
~/.mcpjam/skills/ |
| Mux | mux |
.mux/skills/ |
~/.mux/skills/ |
| OpenCode | opencode |
.opencode/skills/ |
~/.config/opencode/skills/ |
| OpenHands | openhands |
.openhands/skills/ |
~/.openhands/skills/ |
| Pi | pi |
.pi/skills/ |
~/.pi/agent/skills/ |
| Qoder | qoder |
.qoder/skills/ |
~/.qoder/skills/ |
| Qwen Code | qwen-code |
.qwen/skills/ |
~/.qwen/skills/ |
| Roo Code | roo |
.roo/skills/ |
~/.roo/skills/ |
| Trae | trae |
.trae/skills/ |
~/.trae/skills/ |
| Windsurf | windsurf |
.windsurf/skills/ |
~/.codeium/windsurf/skills/ |
| Zencoder | zencoder |
.zencoder/skills/ |
~/.zencoder/skills/ |
| Neovate | neovate |
.neovate/skills/ |
~/.neovate/skills/ |
| Pochi | pochi |
.pochi/skills/ |
~/.pochi/skills/ |
그 외에도 Vercel AI SDK 통합을 지원하여 개발자가 직접 만든 에이전트에도 쉽게 통합할 수 있으며, zod 스키마 등을 활용한 도구 정의와 원활하게 연동됩니다.
Skill Hub를 지향하는 Skills.sh 웹사이트
Skills.sh 웹사이트는 사용 가능한 스킬을 검색할 수 있는 허브 역할을 합니다.
-
익명 텔레메트리: CLI를 통해 스킬이 설치될 때마다 익명화된 사용 통계가 수집되어, 커뮤니티에서 가장 인기 있는 스킬이 무엇인지 리더보드 형태로 보여줍니다.
-
개인정보 보호: 텔레메트리는 오직 스킬의 설치 횟수 등 집계 데이터만 수집하며, 개인 식별 정보나 코드 내용은 전송되지 않습니다. 만약 이 기능을 끄고 싶다면
DISABLE_TELEMETRY=1환경 변수를 설정할 수 있습니다.
Skills 홈페이지: Skill 목록 및 리더보드
Vercel의 Skills 공개 블로그
Skills 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 