Skip to main content
Tilnote
Tilnote로 만들기
R
richmusk
Views 169•

에이전트 개발, 더 이상 노가다 금지 💥 Vercel Skills로 한 번에 끝내보기

Summary

AI 에이전트 만들어 보신 분들은 다 공감하실 거예요.
모델 자체야 API 한 줄로 끝인데, 막상 뭘 시키려면 그때부터가 진짜 시작이죠.

이 API는 이런 파라미터를 받고, 저 도구는 저런 JSON 스키마를 써야 하고, 에이전트가 헷갈리지 않게 프롬프트에 도구 설명을 또 넣어주고…
결국 대부분의 시간은 모델이 아니라 도구 정의와 설정에 들어가게 됩니다.

Vercel이 공개한 Vercel Skills, 혹은 Skills.sh은 이 번거로운 과정을 아예 다른 방식으로 재정의한 프로젝트입니다!
npm으로 라이브러리 설치하듯, 에이전트에게 능력을 패키지로 설치하는 개념에 가까워요.

이 글에서는 Vercel Skills가 뭔지, 기존 방식과 뭐가 다르고, 실제로 개발자 입장에서 어떤 변화가 생길지 제 관점에서 정리해 보겠습니다. 개발자가 아니더라도 AI 에이전트에 관심 있다면 충분히 따라오실 수 있게 풀어서 설명할게요.

참고로 원본 정보는 여기서 직접 보실 수 있습니다.

🚀 Vercel Skills란? 한 줄로 설치하는 에이전트 능력치 시스템

Vercel Skills는 쉽게 말해서 AI 에이전트 전용 npm 같은 생태계입니다.
정식 표현으로는 오픈 에이전트 스킬 생태계, 그리고 그것을 다루는 CLI 도구라고 보면 됩니다.

여기서 말하는 스킬은 LLM이 직접 배우는 지식이 아니라, 에이전트가 사용할 수 있는 도구와 절차적 지식의 묶음입니다.
예를 들어 이런 것들이 스킬이 될 수 있습니다.

  • GitHub에서 PR을 만들고 설명까지 달아주는 기능

  • Linear 같은 이슈 트래커에 티켓을 생성하고 상태를 갱신하는 기능

  • 브라우저를 자동으로 열어서 검색하고 결과를 정리하는 기능

기존에는 이런 기능을 붙이려면:

에이전트에게 쓸 API를 고르고 문서를 읽고, JSON 스키마를 직접 만들고, 도구 호출 규칙을 프롬프트에 세세하게 적어주고, 테스트하고, 또 수정하고 이 과정을 계속 되풀이해야 했습니다.

Vercel Skills는 이걸 이렇게 바꿉니다.

  • 필요한 능력을 검색해서

  • npx skills add 한 줄로

  • 에이전트가 이해할 수 있는 포맷의 스킬을 설치

이걸 보고 느낀 점은, 이제 에이전트 쪽에서도 패키지 매니저 시대가 열리는구나 하는 거였어요. 프레임워크나 SDK마다 도구 정의를 다시 쓰던 시대에서, 공통 스킬 생태계를 공유하는 방향으로 넘어가는 느낌입니다.

🧊 콜드 스타트 지옥에서 탈출: 기존 방식과의 차이

AI 에이전트 개발할 때 가장 피곤했던 부분이 콜드 스타트 문제였습니다.
도구 하나 추가할 때마다 해야 할 일이 너무 많았거든요.

기존 방식은 대략 이런 흐름이었습니다.

먼저, 사용할 API 문서를 읽습니다.
파라미터 정의, 인증 방식, 반환 형식까지 다 파악해야 하죠.

그다음 OpenAI의 함수 호출 포맷이나, Claude의 도구 호출 포맷에 맞게 JSON 스키마를 직접 만듭니다.
이때 이름과 설명을 얼마나 잘 써주느냐에 따라 에이전트가 도구를 제대로 쓸지 말지가 갈립니다.

여기에 실제 실행 코드를 붙이고,
모델이 도구를 오용하지 않는지, 파라미터를 제대로 넣는지 여러 번 테스트합니다.

그리고 가장 골치 아픈 부분이 남습니다.
API가 바뀌면요. 문서 다시 보고, 스키마 다시 고치고, 코드 고치고, 관련 프롬프트까지 고쳐야 합니다.

Vercel Skills 접근은 훨씬 단순합니다.

필요한 스킬을 스킬 생태계에서 찾습니다.
npx skills add <owner>/<skill-name> 명령으로 설치합니다.
프로젝트 안에 에이전트가 이해할 수 있는 스킬 정의 파일이 들어옵니다.
Claude Code든 Cursor든 Windsurf든, 또는 Vercel AI SDK 기반 에이전트든 이 파일을 읽고 바로 능력을 확장합니다.

결국, 개발자가 하던 노가다성 반복 작업을 스킬 생태계로 외주를 준 셈입니다.
제가 체감하기로는, 도구 설계보다는 실제로 에이전트가 어떤 플로우를 가져야 하는지에 더 집중할 수 있는 구조라서 꽤 매력적입니다.

📄 SKILL.md: 사람이 읽고, 에이전트가 이해하는 스킬 정의

Skills 생태계의 핵심은 SKILL.md라는 파일입니다.
이게 일종의 스킬 패키지 설명서이자, 에이전트용 사용 설명서 역할을 동시에 합니다.

SKILL.md는 크게 두 부분으로 구성됩니다.

첫 번째는 YAML 프론트매터입니다.
여기에는 스킬 이름과 설명 등이 들어갑니다.
에이전트 입장에서는 이 정보를 바탕으로 언제 어떤 상황에서 이 스킬을 써야 할지 판단하게 됩니다.

두 번째는 마크다운 본문입니다.
여기에 에이전트가 따라야 할 절차, 주의사항, 사용 규칙, 코드 패턴 같은 것들을 적습니다.
즉, 사람이 읽어도 이해가 되고, LLM에게 넣어줘도 충분히 구조적으로 의미를 전달할 수 있는 형태입니다.

제가 여기서 흥미로웠던 부분은 스킬 정의를 프롬프트 엔지니어링과 도구 정의 사이 어딘가에 위치시키고 있다는 점이에요.

기존에는 프롬프트는 프롬프트대로, 도구 스키마는 스키마대로, 문서는 문서대로 따로 존재했는데, 여기서는 그걸 SKILL.md라는 공통 포맷으로 통합하려는 시도처럼 보입니다.

이게 잘 자리 잡으면, 앞으로는 에이전트에게 기능을 알려줄 때 코드보다 먼저 SKILL.md부터 정의하는 식으로 흐름이 바뀔 수도 있겠다는 생각이 들었습니다.

🛠 npx skills: 설치는 npm처럼, 대상은 에이전트

Skills CLI는 npx 기반이라, 별도 설치 없이 바로 사용 가능합니다.
명령어 패턴도 npm과 꽤 비슷해서 개발자라면 금방 적응할 수 있습니다.

가장 핵심이 되는 명령어는 이거 하나입니다.

npx skills add <owner>/<skill-name>

이 명령을 실행하면, 원격 저장소에서 해당 스킬의 정의 파일을 내려받고 에이전트가 인식할 수 있는 위치에 자동으로 배치해 줍니다.

예를 들어 Vercel 팀이 만들어 둔 에이전트 스킬 모음은 여기서 볼 수 있고요.
https://github.com/vercel-labs/agent-skills

이걸 통째로 프로젝트에 설치하려면 이렇게 하면 됩니다.

npx skills add vercel-labs/agent-skills

그럼 여러 스킬이 한 번에 들어오고, Claude Code나 Cursor 같은 코딩 에이전트들이 이걸 자동으로 읽어서 새로운 능력이 생기는 구조입니다.

실제로 써보면 느낌이 좀 독특할 것 같아요. 코드는 거의 안 건드렸는데, 에이전트가 갑자기 GitHub랑 Linear랑 브라우저까지 쓴다고 생각해 보면 말이죠.

저는 이쪽이 꽤 빠르게 표준적인 워크플로우가 될 가능성이 높다고 봅니다. 지금도 LLM은 점점 도구 중심으로 진화하고 있는데, 도구를 패키지화하는 쪽 생태계가 먼저 자리 잡는 쪽이 결국 이 판을 주도할 확률이 높거든요.

🤝 여러 AI 에이전트와의 호환성: 특정 플랫폼 전용이 아니다

개인적으로 가장 마음에 들었던 부분 중 하나가 바로 이 호환성 전략입니다.
Vercel이 만든 도구지만, Vercel 플랫폼에 가두지 않았습니다.

Skills는 다양한 에이전트와 호환되도록 설계되어 있습니다.
예를 들어 다음과 같은 도구들이 공식적으로 지원 대상에 포함됩니다.

  • Claude Code

  • Cursor

  • Windsurf

  • GitHub Copilot 기반 에이전트

  • Continue, Roo Code, Cline 등 각종 코드 어시스턴트

  • Gemini CLI, OpenHands, Amp 같은 도구들

각 에이전트별로 스킬을 읽어들이는 디렉터리 경로가 정리되어 있고,
npx skills가 그 위치를 알아서 맞춰주는 구조입니다.

이 말은 곧, 한 번 만들어진 스킬이 특정 IDE나 특정 AI 도구에 종속되지 않는다는 뜻입니다.

동일한 SKILL.md가 Cursor에서도 쓰이고, Claude Code에서도 쓰이고, GitHub Copilot 기반 워크플로우에서도 재사용될 수 있는 겁니다.

게다가 Vercel AI SDK와도 통합이 잘 되어 있어서:
https://sdk.vercel.ai/docs

직접 만든 커스텀 에이전트에도 스킬을 붙여서 쓸 수 있습니다.
zod 스키마 기반 도구 정의와도 연동된다고 해서, 타입 세이프한 도구 정의와 스킬 생태계를 자연스럽게 엮을 수 있는 구조를 의도하고 있다는 느낌을 받았습니다.

제 입장에서 이건 꽤 전략적인 선택으로 보입니다. 에이전트 생태계가 IDE, 클라우드, 프레임워크마다 갈라져 버리면 도구 제작자 입장에서는 똑같은 기능을 여러 번 구현해야 하거든요.

Skills는 그 위에 공통 레이어를 하나 세워서, 스킬 제작자는 한 번 만들고, 여러 에이전트가 나눠 쓰게 하는 방향을 지향하는 것 같습니다.

🌐 Skills.sh: 에이전트 스킬을 위한 패키지 허브 지향

Skills.sh 웹사이트는 말 그대로 스킬 디렉터리 역할을 합니다.
https://skills.sh

여기서 사용 가능한 스킬을 검색하고, 인기 스킬을 리더보드 형태로 볼 수 있습니다.
npm, PyPI, VS Code Marketplace 같은 것을 떠올리시면 이해가 쉬울 거예요.
다만 대상이 라이브러리가 아니라 에이전트 스킬이라는 차이만 있을 뿐입니다.

재미있는 포인트 하나는 익명 텔레메트리입니다. CLI로 누군가 스킬을 설치하면, 이 사실이 익명 통계로 수집되고 어떤 스킬이 많이 쓰이고 있는지 리더보드에 반영됩니다.

수집하는 데이터는 설치 횟수 같은 집계 정보에 한정되고, 개인 정보나 코드 내용은 전송하지 않는다고 명시되어 있습니다. 원치 않으면 환경 변수 DISABLE_TELEMETRY=1로 꺼버릴 수 있고요.

이걸 보면서 든 생각은, 앞으로는 에이전트에게 어떤 능력을 붙였는지가 곧 프로덕트의 경쟁력으로 이어질 거라는 점이었습니다.

예를 들어, 에이전트 앱 하나를 만들었는데 그 안에 들어간 스킬 조합이 대부분의 유저들이 많이 쓰는 상위 스킬들로 구성돼 있다면, 그 앱의 사용성도 자연스럽게 따라 올라갈 가능성이 높겠죠.

반대로, 아무도 안 쓰는 스킬만 잔뜩 붙여 놓으면, 겉으로는 기능이 많아 보이는데 실제로는 체감 효용이 떨어지는 앱이 될 수도 있고요.

Skills.sh의 리더보드는 이 부분에서 일종의 시장 신호 같은 역할을 해 줄 수 있을 것 같다는 생각이 들었습니다.

🧩 개발자로서 본 활용 포인트: 어디에 써먹을 수 있을까?

이제 이걸 실제로 어디에 써먹을 수 있을지, 제 관점에서 몇 가지를 정리해 볼게요.

우선, 에이전트 기반 코딩 도구를 이미 쓰고 있다면 (Claude Code, Cursor, Windsurf, Continue, GitHub Copilot 등)
Skills를 통해 그 에이전트의 행동 반경을 확실하게 넓힐 수 있습니다.

예를 들어 이런 시나리오가 가능합니다.

코드 리뷰 에이전트를 만들고 싶다. 단순히 코드만 보는 게 아니라, GitHub에서 브랜치를 만들고, 커밋하고, PR까지 생성해 주면 더 좋을 것 같다.

예전이라면 이 모든 걸 직접 구현해야 했지만, 이제는 GitHub 관련 스킬을 설치해서 에이전트가 그 능력을 바로 사용할 수 있게 할 수 있습니다.

또 하나는 팀 차원의 에이전트 환경 세팅입니다.

지금은 팀마다 에이전트 프롬프트 규칙, 도구 호출 방식, API 사용 패턴을 문서로 정리해서 공유하는 경우가 많은데, 이걸 SKILL.md 기반 스킬로 패키징해서 팀 공용 스킬로 관리하는 방식이 유용해 보입니다.

새로 합류한 팀원이든, 새로운 에이전트 도구를 도입하든, 공통 스킬 세트를 그냥 설치하면 팀에서 합의한 방식 그대로 에이전트가 움직이는 구조를 만들 수 있을 테니까요.

그리고 장기적으로는, 에이전트 SDK, 워크플로 엔진, RAG 시스템 등과 결합해서
에이전트 애플리케이션의 핵심 구성 요소로 사용될 확률이 높다고 봅니다.
특히 Vercel AI SDK와 연동된다는 점은, 프론트엔드, 풀스택 개발자가 에이전트 기능을 서비스에 붙일 때 가장 먼저 고려하게 되는 옵션 중 하나가 될 가능성이 큽니다.

🔍 직접 살펴보고 싶은 분들을 위한 링크 모음

중간중간 언급한 주요 링크들을 한 번 더 정리해볼게요.
관심 있는 부분은 직접 눌러서 살펴보시는 걸 추천합니다.

이 정도만 훑어봐도, 앞으로 에이전트 관련 생태계가 어떻게 움직일지 감이 꽤 올 거예요.

💡 정리와 개인적인 시사점: 에이전트 개발의 패러다임 전환

마무리로 핵심 포인트를 짧게 정리해 볼게요.

Vercel Skills는 AI 에이전트용 패키지 매니저에 가깝습니다.
스킬은 도구 정의와 절차적 지식을 묶은 단위이고, SKILL.md라는 마크다운 파일로 정의됩니다.

npx skills add 한 줄로
에이전트에게 새로운 능력을 부여할 수 있고, 여러 에이전트 도구에서 공통 포맷으로 재사용이 가능합니다.

Skills.sh은 이 스킬들을 검색하고 설치 횟수 기반 랭킹을 보는 허브 역할을 합니다.
텔레메트리는 익명 집계만 수집하며, 환경 변수로 끌 수 있습니다.

개발자로서 제가 느낀 가장 큰 변화는 에이전트의 능력을 코드 수준이 아닌 패키지 단위로 다루기 시작했다는 점입니다.

지금까지는 에이전트의 행동을 세밀하게 설계하려면 도구 정의, 프롬프트, 문서를 모두 직접 관리해야 했는데, 이제는 그 중 많은 부분을 스킬 생태계에 위임할 수 있게 되었습니다.

물론 아직은 초기 단계라서, 스킬의 품질 편차나, 버전 관리 방식, 보안 이슈 같은 부분은 계속 지켜봐야 할 것 같아요.

하지만 에이전트 시대에 공유 가능한 능력 패키지라는 개념이 필요하다는 점에는 개인적으로 전적으로 동의합니다.

앞으로 에이전트를 조금이라도 진지하게 써볼 생각이 있다면, 이 생태계를 한 번쯤 직접 만져보는 걸 추천합니다.

에이전트를 모델 튜닝으로만 좋게 만들던 시대에서, 스킬 조합과 오케스트레이션으로 차별화하는 시대로 넘어가고 있다는 걸 체감하는 좋은 지점이 될 거예요.

에이전트 개발, 더 이상 노가다 금지 💥 Vercel Skills로 한 번에 끝내보기