Vercel Agent Skills로 Claude Code를 훨씬 더 강력하게 만드는 방법

BBetter Stack
Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00에이전트 스킬 디렉토리인 'Skills By The Cell'을 소개합니다. 어떤 에이전트에든 스킬을 추가하여
00:00:04React 숙련도를 높이거나, 프런트엔드 디자이너로 변신시키거나,
00:00:10심지어 모션 그래픽 에디터로 만들 수도 있죠. 이 시스템은 레포지토리를 클론하고 스캔하여
00:00:15스킬을 설치하기 전 skills.md 파일이 있는지 확인합니다. 그런데 Cloudflare의 새로운 제안이
00:00:22이 놀라운 리소스를 무용지물로 만들까요? 구독 버튼을 누르고 자세히 알아봅시다.
00:00:27에이전트 스킬은 작년 Anthropic이 특정 작업에 대한 Claude의 성능을 향상시키기 위해 도입했으며,
00:00:32.cloud 디렉토리에 skills 디렉토리를 추가한 다음, 그 안에 스킬 이름으로 된
00:00:37또 다른 디렉토리를 만들고 skills.md 파일을 넣는 방식으로 작동합니다.
00:00:42이 파일이 제대로 작동하려면 몇 가지 핵심 요소가 포함되어야 합니다. 먼저 상단 섹션은
00:00:47YAML 형식의 프런트 매터로, 최소한 스킬 이름과 설명이 포함되어야 합니다.
00:00:52그 아래 프런트 매터 밖의 영역에는 해당 스킬의 지침을 작성합니다.
00:00:58이 지침은 모델의 컨텍스트에 로드되어 특정 작업에 사용됩니다.
00:01:03스킬의 묘미는 '단계적 공개(Progressive Disclosure)'라는 기법에 있습니다. 처음에는 핵심 정보만 보여주고,
00:01:08모델이 필요할 때만 더 깊은 정보를 찾아볼 수 있게 하는 방식이죠.
00:01:13따라서 에이전트가 실행될 때는 각 스킬의 프런트 매터 정보만 컨텍스트에 로드됩니다.
00:01:19프롬프트를 읽은 후, 에이전트는 각 스킬의 설명을 확인하여 프롬프트 처리에
00:01:24도움이 될 스킬이 있는지 찾습니다. 적절한 스킬을 찾으면 프런트 매터 밖의 모든 내용을
00:01:31모델의 활성 컨텍스트에 추가합니다. 심지어 다른 파일을 스킬에 연결하여
00:01:36모델이 필요하다고 판단할 때 참고 자료로 가져오게 할 수도 있습니다.
00:01:40이후 Microsoft, OpenAI, OpenCode 같은 기업들도 에이전트 스킬을 채택했습니다.
00:01:46하지만 여러 에이전트에 스킬을 설치하려면 매번 해당 디렉토리로 이동해 레포지토리를 클론해야 하는 번거로움이 있었습니다.
00:01:52특히 Vercel이 사람들에게 자신들의 도구용 스킬을 공유하고 싶어 했을 때 이 문제가 두드러졌습니다.
00:01:58그래서 그들은 16가지의 다양한 에이전트에 쉽게 스킬을 추가할 수 있는 'Add Skill' 프로젝트를 만들었습니다.
00:02:03단순히 'npx add-skill' 뒤에 스킬 이름이나 레포지토리 주소를 입력하면 됩니다.
00:02:14누군가 'Add Skill'로 아무 레포지토리나 추가하면 어쩌나 걱정되시나요?
00:02:19명령어를 실행하면 먼저 레포지토리를 클론한 뒤 skills.md 파일이 있는지 확인합니다.
00:02:25파일이 없으면 레포지토리를 삭제해 정리합니다. 파일이 있다면,
00:02:32설정 값을 훑어 사용자가 설치한 에이전트를 자동 감지하고,
00:02:37'.agents/skills'에서 해당 에이전트의 스킬 위치로 심볼릭 링크를 생성합니다. Cursor는 .cursor, Claude Code는 .claude가 되겠죠.
00:02:44나중에 설명하겠지만 추적을 위한 텔레메트리 기능도 포함되어 있습니다. 어쨌든 Vercel은 스킬을 쉽게 설치할 수 있는 방법을 마련한 셈이죠.
00:02:55그럼 스킬 탐색은 어떻게 할까요? 여기서 'skills.sh'가 등장합니다. 현재는 카테고리 구분이나 페이지 나눔 없이 긴 목록으로 나열되어 있습니다.
00:03:01이 목록은 누군가 'Add Skill' 등을 통해 스킬을 처음 설치할 때 자동으로 채워지는 것 같습니다.
00:03:08설치 시 패키지 내부의 텔레메트리가 작동하여 이름, 에이전트 등의 정보를 수집하기 때문입니다.
00:03:14이 텔레메트리는 완전히 익명이며, 목록 구성뿐만 아니라
00:03:20스킬의 다운로드 횟수나 특정 에이전트별 사용량을 파악하는 데 사용됩니다. 이를 통해 지난 24시간 동안의 인기 스킬도 알 수 있죠.
00:03:32추적이 걱정된다면 텔레메트리를 완전히 비활성화할 수도 있습니다.
00:03:37Vercel Labs가 스킬 탐색 분야에 쏟은 노력은 대단합니다. 이미 많은 이들이
00:03:42React Native 스킬, Better Auth를 위한 모범 사례, 그리고 엄청난 인기를 끄는 ReMotion 스킬 등
00:03:48멋진 스킬들을 찾아 사용하고 있습니다. ReMotion은 프롬프트 하나로 온갖 놀라운 영상을 만드는 데 쓰이죠.
00:03:53그런데 Cloudflare의 새로운 제안이 이 모든 노력을 헛되게 만들까요? 이 제안은 에이전트가
00:03:59스킬을 탐색하는 대안적인 방식을 제시합니다. 먼저 사용 가능한 모든 스킬을 나열한 가벼운 JSON 파일을
00:04:05잘 알려진(well-known) 경로에서 가져오는 방식이죠.
00:04:12예를 들어 “Wrangler를 사용해 Cloudflare 프로젝트를 만들어 줘”라고 프롬프트를 작성하면,
00:04:18에이전트는 프롬프트를 읽은 뒤 '[cloudflare.com/.well-known](https://www.google.com/search?q=https://cloudflare.com/.well-known)' 같은 위치를 먼저 확인합니다.
00:04:24물론 실제 경로는 '.well-known'이 아니라 '/skills' 같은 형식이 될 것입니다.
00:04:30거기서 index.json을 가져오는데, 여기엔 이름, 설명, 관련 파일 개수 등 스킬당 필수 정보가 들어있습니다.
00:04:38그 후 에이전트는 이 정보를 파악하고,
00:04:44index.json 파일을 바탕으로 프롬프트 수행에 Wrangler 스킬이 필요하다는 것을 인지합니다.
00:04:55에이전트는 해당 경로에서 스킬 관련 파일을 모두 가져오고, 다음 프롬프트에서 재사용할 수 있도록 캐싱합니다.
00:05:01그리고 그 스킬을 활용해 사용자에게 답변을 제공하죠.
00:05:08Cloudflare의 제안이 매력적이긴 하지만, 스킬을 탐색 가능하게 만들기 위해
00:05:14index.json 파일을 작성하고 특정 URL에 올리는 등의 추가 단계가 필요합니다.
00:05:20정확히 어떤 의미인지는 모르겠지만, 단순히 GitHub에 스킬을 올려 Vercel의 방식에 노출시키는 것과 비교했을 때
00:05:27Cloudflare의 방식은 이러한 번거로운 절차 때문에 소규모 개발자들에게 불리할 수 있다고 생각합니다.
00:05:33만약 이 제안이 받아들여진다면 (누가 검토하고 승인하는지는 모르겠지만),
00:05:40Vercel의 skills.sh 프로젝트와는 작별하게 될지도 모릅니다.
00:05:46하지만 두 방식이 상생할 방법도 분명 있을 겁니다. skills.sh는 인디 개발자나 덜 알려진 개발자의
00:05:52스킬을 찾는 데 사용하고,
00:05:57Cloudflare의 방식은 대기업의 스킬을 자동으로 탐색하는 데 쓰는 식이죠. 어쨌든
00:06:03이런 스킬들을 활용해 멋진 프로젝트를 만들다 보면,
00:06:07예상치 못한 오류를 추적해야 할 상황이 생기기 마련입니다. 이때 Better Stack이 큰 도움이 됩니다.
00:06:12백엔드 로그 수집은 물론, AI 기반 오류 추적 기능을 통해 프런트엔드 에러까지 모니터링할 수 있죠.
00:06:18게다가 아름다운 상태 페이지(Status Page)까지 만들어 줍니다. 지금 바로 Better Stack을 확인해 보세요.

Key Takeaway

Vercel의 간편한 스킬 설치 시스템과 Cloudflare의 자동 탐색 제안은 AI 에이전트의 능력을 극대화하며 개발 생태계를 혁신하고 있습니다.

Highlights

Vercel의 'Skills By The Cell'을 통한 에이전트 능력 확장 방법

Claude Code 및 Cursor 등 다양한 AI 에이전트와의 호환성

단계적 공개(Progressive Disclosure) 기법을 활용한 효율적인 컨텍스트 관리

npx add-skill 명령어를 이용한 간편한 스킬 설치 및 자동 감지 기능

Cloudflare가 제안한 .well-known 경로 기반의 새로운 스킬 탐색 방식

중소 개발자와 대기업 간의 스킬 배포 방식 차이 및 상생 가능성

에러 모니터링 도구인 Better Stack의 AI 기반 추적 기능 소개

Timeline

에이전트 스킬 소개 및 작동 원리

영상은 Vercel이 제공하는 에이전트 스킬 디렉토리인 'Skills By The Cell'을 소개하며 시작됩니다. 이 시스템은 React 숙련도를 높이거나 모션 그래픽 에디터 기능을 추가하는 등 AI 에이전트의 역할을 다양하게 변신시킬 수 있습니다. 기술적으로는 .cloud 디렉토리 내에 skills.md 파일을 생성하고 YAML 형식의 프런트 매터를 포함하는 구조로 작동합니다. 사용자는 이 파일을 통해 에이전트에게 필요한 구체적인 지침과 설명을 전달할 수 있습니다. 결과적으로 개발자는 복잡한 설정 없이도 에이전트의 작업 수행 능력을 비약적으로 향상시킬 수 있게 됩니다.

단계적 공개 기법과 컨텍스트 로드 방식

에이전트 스킬의 핵심 매력은 '단계적 공개(Progressive Disclosure)'라는 효율적인 정보 전달 기법에 있습니다. 처음에는 스킬의 이름과 설명이 담긴 프런트 매터 정보만 컨텍스트에 로드하여 불필요한 자원 낭비를 방지합니다. 이후 에이전트가 사용자 프롬프트를 분석하여 특정 스킬이 필요하다고 판단할 때만 나머지 상세 지침을 활성 컨텍스트에 추가합니다. 이 방식은 모델의 제한된 컨텍스트 창을 효율적으로 사용하면서도 깊이 있는 참조 자료를 활용할 수 있게 해줍니다. 이를 통해 대규모 프로젝트에서도 AI가 혼란 없이 정확한 정보를 바탕으로 답변을 생성할 수 있습니다.

Vercel의 'Add Skill' 프로젝트와 설치 자동화

기존에는 여러 에이전트에 스킬을 설치하기 위해 매번 레포지토리를 클론해야 하는 번거로움이 있었습니다. Vercel은 이를 해결하기 위해 'npx add-skill' 명령어로 16가지 이상의 에이전트에 스킬을 즉시 추가할 수 있는 시스템을 구축했습니다. 이 도구는 자동으로 사용자의 개발 환경을 스캔하여 Cursor(.cursor)나 Claude Code(.claude) 같은 에이전트의 설정 위치를 찾아냅니다. 또한 심볼릭 링크를 생성하여 파일 관리를 일원화하고 설치 프로세스를 극도로 단순화했습니다. 이러한 자동화는 개발자가 도구 설정에 들이는 시간을 줄이고 실제 코딩 작업에 집중할 수 있도록 돕습니다.

스킬 탐색 플랫폼 skills.sh와 텔레메트리

설치된 스킬들을 한눈에 확인하고 새로운 기능을 찾을 수 있는 'skills.sh' 웹사이트의 역할에 대해 설명합니다. 이 플랫폼은 사용자들이 설치한 스킬 정보를 익명의 텔레메트리 데이터를 통해 수집하여 실시간 인기 목록을 구성합니다. 텔레메트리는 스킬의 다운로드 횟수나 에이전트별 사용량을 파악하는 데 사용되며, 개인 정보 보호를 위해 비활성화 옵션도 제공합니다. 현재 React Native나 ReMotion 같이 영상 제작을 돕는 강력한 스킬들이 활발하게 공유되고 있습니다. 사용자들은 이 커뮤니티 주도형 목록을 통해 검증된 스킬을 손쉽게 발견하고 자신의 워크플로우에 적용할 수 있습니다.

Cloudflare의 새로운 제안과 미래 전망

Cloudflare는 특정 URL의 '.well-known' 경로에서 index.json 파일을 가져와 스킬을 자동으로 탐색하는 대안적인 방식을 제안했습니다. 이 방식은 에이전트가 실시간으로 필요한 기술을 검색하고 캐싱하여 사용할 수 있게 해주지만, 소규모 개발자에게는 호스팅의 번거로움을 줄 수 있습니다. 발표자는 Vercel의 커뮤니티 중심 방식과 Cloudflare의 기업 표준 방식이 서로 보완하며 상생할 수 있을 것으로 내다봅니다. 영상의 마지막에는 프로젝트 진행 중 발생할 수 있는 오류를 추적하기 위한 Better Stack 도구를 추천하며 마무리됩니다. 결국 이러한 기술적 경쟁과 협업이 AI 개발 생태계를 더욱 풍요롭게 만들 것이라는 메시지를 전달합니다.

Community Posts

View all posts