에이전트 스킬 비용은 '라벨'보다 '파일 내용'으로 확인하는 것이 좋다 (가격 라벨 4,902개 조사 기반)

Claude Code나 Codex에서 사용하는 에이전트 스킬 중 가격 라벨이 붙은 것만 한정한다면, 설치된 대부분의 스킬은 무료에 속합니다. 2026년 10월 16일자 Skillselion의 조사에 따르면, 가격 라벨이 붙은 4,902개 스킬이 가진 설치 중 89.7%가 무료 스킬이었습니다. 다만, 라벨과 파일 내용이 다를 수 있으므로, 사용하기 전에 파일을 확인해 볼 가치가 있습니다.

먼저 기준을 설명하겠습니다. 이 숫자는 카탈로그 전체가 아니라 가격 라벨이 붙은 스킬만에 대한 이야기입니다. 2026년 10월 16일자 카탈로그에는 63,336개의 스킬이 있으며, 그중 가격 라벨이 붙어 있는 것은 4,902개입니다. 스킬 수로 보면 7.7%에 불과하지만, 기록된 전체 설치의 39.2%를 차지하며 인기 있는 스킬에 편중되어 있습니다. 나머지 58,434개에 대해서는 언급하지 않았습니다. 또한, 라벨은 거의 모두 모델이 붙인 것이지 사람이 체계적으로 감사한 것은 아닙니다.

조사의 전체 내용은 Skillselion의 에이전트 스킬 가격 조사(2026년 10월 버전)에 있으며, 모든 수치는 가격 조사 전체 데이터(CSV)에서 재계산할 수 있습니다(63,336행, CC BY 4.0).

본 기사는 Skillselion에서 작성했습니다. 저희는 Claude Code, Codex, Cursor 등의 코딩 에이전트를 위한 스킬을 모은 독립적인 디렉토리를 운영하고 있으며, Anthropic, OpenAI, Cursor 어느 곳과도 제휴하지 않았습니다. 카탈로그는 skills.sh, GitHub, MCP 레지스트리에서 매일 업데이트되며 실제 설치 수로 정렬되어 있습니다.

에이전트 스킬은 무료인가? 가격 라벨 4가지 종류 분석

라벨은 4가지 종류가 있습니다.

• 무료: 3,450개(70.4%)
• 자신의 API 키를 가져오는 것 (BYOK, Bring Your Own Key): 1,215개(24.8%). 스킬 자체는 무료이며, 내부적으로 호출되는 서비스에 사용자의 키와 계정이 필요합니다.
• 프리미엄: 181개(3.7%)
• 유료: 56개(1.1%)

비용이 발생하는 세 가지 라벨을 합치면 1,452개(29.6%)이며, 그중 83.7%는 BYOK 스킬입니다. 스킬 자체에 비용을 지불하기보다는, 스킬이 구동하는 API나 SaaS 계정에 비용을 지불하는 형태가 대부분입니다.

설치 수로 보면 무료의 비율은 어떻게 달라지나요?

개수(건수)가 아니라 설치 수로 계산하면, 무료의 비율은 더 커집니다. 가격 라벨이 붙은 4,902개가 가진 설치는 84,668,769개이며, 내역은 다음과 같습니다.

• 무료: 89.7%
• BYOK: 7.7%
• 프리미엄: 2.1%
• 유료: 0.5%(56개 전체 합계로 454,127 설치)

즉, 비용이 드는 스킬은 가격 라벨이 붙은 스킬의 29.6%를 차지하지만, 설치 수에서는 10.3%에 그칩니다. 반면, 일반적인 스킬 규모는 거의 동일합니다. 무료 스킬 설치 수 중앙값은 40이고, 어떤 비용이 드는 스킬의 중앙값은 43이었습니다.

여기서의 '설치'는 레지스트리에 기록된 누적 설치 이벤트를 의미하며, 활성 사용자 수나 유료 고객 수가 아닙니다. 번들로 한꺼번에 설치되는 스킬은 각각 개별적으로 계산되므로, 스위트(suite)를 출시하는 공개자의 비중이 커집니다.

데이터셋에서 가격 라벨이 붙은 스킬 중 가장 많은 설치 수를 가진 find-skills 스킬(Vercel Labs) 역시 무료 라벨입니다.

라벨과 SKILL.md의 내용은 일치하나요?

항상 일치하는 것은 아닙니다. 조사에서는 라벨과는 별도로, 스킬 문서의 발췌 내용(대부분은 SKILL.md의 시작 부분)에 OPENAI_API_KEY나 GITHUB_TOKEN과 같은 인증 정보로 보이는 변수명이 언급되는지 여부를 계산하고 있습니다.

• 무료 라벨 중 발췌 내용이 저장된 763개 스킬 중, 50개(6.6%)는 발췌 내용에서 인증 정보로 보이는 변수명을 언급했습니다.
• BYOK 라벨 중 발췌 내용이 있는 173개 스킬 중, 변수명을 언급한 것은 69개(39.9%)입니다.

즉, 무료임에도 키 이름이 나오는 스킬도 있고, BYOK인데도 발췌 내용에 키 이름이 나오지 않는 스킬도 있다는 것입니다. 데이터에서 구체적인 예를 들겠습니다.

• HeyGen의 product-launch-video 스킬은 무료 라벨이지만, 발췌 내용에 GEMINI_API_KEY와 GOOGLE_API_KEY가 나옵니다.
• Vercel AI SDK 스킬도 무료 라벨이며, 발췌 내용에 AI_GATEWAY_API_KEY가 나옵니다.

가 있습니다 - Cloudflare의 이메일 전송 스킬은 무료 라벨로, CLOUDFLARE_API_TOKEN을 제시하고 있습니다. 반대로 Microsoft의 Foundry 스킬은 BYOK(Bring Your Own Key) 라벨이지만, 저장된 발췌문에는 변수명이 나와 있지 않습니다.

어느 것이 정확한지는 이 수치만으로는 알 수 없습니다. 무료 라벨이라도 예시 코드에 변수명이 적혀 있을 뿐일 수도 있습니다. BYOK라 하더라도 키 설명이 파일의 후반부에 있을 수도 있습니다. 발췌문은 파일의 시작 부분만 가지고 있기 때문에, 뒤쪽의 내용은 계산하지 않았습니다.

어떤 API 키가 자주 나오나요?

발췌문이 저장된 스킬은 15,455건(스킬의 24.4%, 설치의 95.1%)이며, 그중 1,421건(9.2%)이 인증 정보로 보이는 변수명을 제시하고 있습니다. 변수명의 종류는 742개입니다.

• OPENAI_API_KEY: 107건, 39개 계정 -
• ANTHROPIC_API_KEY: 62건, 30개 계정 -
• GITHUB_TOKEN: 35건, 28개 계정 -
• GEMINI_API_KEY: 29건, 21개 계정

건수만 보면 가장 많은 것은 RUNCOMFY_TOKEN의 132건이지만, 공개된 것은 단 5개 계정에 불과합니다. 서비스 이름이 붙은 키 중 가장 많은 사용자에게 퍼져 있는 것은 OPENAI_API_KEY입니다. 예를 들어 steipete/clawdis의 OpenAI Whisper API 스킬은 BYOK 라벨이며, 발췌문에 OPENAI_API_KEY가 나옵니다.

1,421이라는 숫자는 필요한 키의 정확한 수가 아니라 패턴에 일치한 수입니다. 예시 코드에 나오는 이름도 필수 키와 동일하게 계산하며, 공개해도 좋은 키나 CSRF 토큰과 같은 비밀이 아닌 것도 포함합니다.

설치 전에 API 키가 필요한지 확인하려면?

라벨도 발췌문도 참고용일 뿐입니다. 최종적으로는 직접 파일을 읽어야 합니다. 절차는 간단합니다.

• 스킬 폴더를 확보하고, SKILL.md뿐만 아니라 scripts/ 등도 포함하여 변수명을 찾습니다. 조사 패턴과 유사한 것은 다음과 같습니다.

grep -rnoE '[A-Z][A-Z0-9_]*(_API_KEY|_APIKEY|_API_TOKEN|_ACCESS_TOKEN|_SECRET_KEY|_TOKEN|_SECRET|_KEY)' ./path/to/skill/

• 발견된 이름별로, 그것을 읽는 코드(os.environ, process.env, $NAME)와 요청을 보내는 목적지 호스트를 확인합니다. 그 호스트의 회사가 청구 주체입니다. - 이름이 발견되지 않아도, curl이나 fetch, SDK의 import를 통해 외부 API를 호출하고 있는지 확인합니다. Foundry 스킬의 예처럼, 발췌문에 키명이 나오지 않는 BYOK 스킬도 있습니다. - 키가 필요하다고 판단되면, 어떤 계정의 키를 전달할지 결정합니다. 셸 환경 변수에 있는 키는 에이전트가 실행하는 명령어에도 대부분 그대로 전달됩니다. 운영(Production) 앱과 같은 키가 아닌, 상한을 설정한 별도의 키를 준비해 두는 것이 안전합니다.

키 외에, 스킬이 로컬 머신에서 무엇을 할 수 있는지는 에이전트 스킬 보안 조사에서 다루고 있습니다. browser-use와 같은 프리미엄/무료(Freemium) 스킬(발췌문에 BROWSER_USE_API_KEY가 있음)은 무료 한도를 초과하는 부분부터 과금이 되므로, 상한 설정이 특히 효과적입니다.

조사 데이터 및 관련 자료는 어디에 있나요?

• 수치 출처와 도표는 가격 조사 보고서 본문에 있습니다.
• 라벨링 규칙과 검증 스크립트 설명은 Skillselion Research의 조사 방법에 있습니다.
• 그 외 조사는 Skillselion의 조사 목록에 모아두었습니다.
• 조사에서는 AI 분야 BYOK 비율이 39.4%였습니다. 사이트에서 이 분야의 스킬을 보려면 AI/에이전트 계열 스킬 카테고리가 진입점입니다.

본 조사는 고정 버전이며, 모든 수치는 2026-10-16 시점 기준입니다.

Discussion