Vercel Labs의 skills.sh 홈페이지는 900,000을 훌쩍 넘는 헤드라인 숫자를 내세우지만, 실제로 신뢰할 만한 카탈로그는 342개 항목입니다. 이 차이가 핵심입니다.
900K가 세는 것과 342가 세는 것
두 숫자는 서로 다른 대상을 측정합니다. skills.sh 홈페이지 리더보드에는 "All Time (908,452)" 라벨이 표시된 적이 있습니다 . 이는 검토되지 않은 전체 디렉터리에서 추적된 모든 목록과 설치를 합산한 원시 코퍼스 수치입니다. 그 뒤에는 검수 관문이 없습니다. 반면 큐레이션 엔드포인트인 /api/v1/skills/curated는 2026-03-31 기준 87개 소유자의 스킬 342개를 정확히 반환합니다 . 이는 진입 기준이 의미 있게 적용된, 사람이 선별한 하위 집합입니다.
여기에 중간 추적기들이 각자 다른 분모를 보고하면서 상황은 더 흐려집니다. 어떤 스냅샷에서는 고유 스킬이 약 87,000개로 집계됐고, 2026년 6월 집계에서는 약 670,000개로 보고됐습니다 . 이 숫자들은 서로 직접 비교할 수 없습니다. 누적 활동, 설치 집계, 중복 제거된 고유 스킬은 각각 별개의 지표입니다.
| 숫자 | 세는 대상 | 검수 관문 |
|---|---|---|
| 908,452 | 전체 디렉터리의 누적 목록 + 설치 | 없음 |
| ~670,000 | 2026년 6월 추적기 스냅샷 | 없음 |
| ~87,000 | 고유 스킬(한 추적기의 중복 제거 기준) | 없음 |
| 342 | 큐레이션 엔드포인트, 87개 소유자(2026-03-31) | 편집 선별 |
이 차이는 큐레이션에는 선별 기준이 필요하지만, 900K+ 수치는 편집 기준 없이 코퍼스 전반의 원시 활동을 반영하기 때문에 생깁니다. 어디선가 "700K skills"라는 표현을 본다면, 그것은 설치할 가치가 있는 것들의 수가 아니라 디렉터리 규모를 뜻합니다.
find-skills는 MCP 프로토콜이 아니라 부트스트랩 SKILL.md입니다
"자동 발견"이라는 설명과 달리, find-skills는 MCP 서버가 아니며 전체 코퍼스를 컨텍스트에 로드하지도 않습니다. 이것은 한 번 .claude/skills/에 설치되는 단일 SKILL.md입니다. YAML과 Markdown으로 된 지침 패키지로, Claude Code에게 필요할 때 skills.sh 생태계를 언제, 어떻게 조회할지 알려줍니다 . 지속 실행되는 서비스도, 데몬도, 프로토콜 핸드셰이크도 없습니다. 이 파일은 쿼리가 활성화하기 전까지 대기 상태로 남아 있는 정적 텍스트입니다.
활성화는 대화 속에서 일어납니다. 사용자가 "X를 어떻게 하지", "X용 스킬을 찾아줘"라고 묻거나 특화된 기능을 요청하면, 에이전트는 지침을 읽고 skills.sh 리더보드를 확인한 뒤 npx skills find [query]를 실행하고(필요하면 --owner 사용), 결과를 평가한 다음에야 추천합니다 .
품질 관문은 별도의 검증 단계가 아니라 파일 안에 직접 들어 있는 휴리스틱입니다.
- 설치 수 1K+인 스킬을 선호하고, 100 미만은 주의해서 다룹니다.
vercel-labs,anthropics,microsoft같은 평판 있는 소유자를 우선합니다.- GitHub 스타가 100개 미만인 저장소는 신중하게 봅니다 .
이 설계는 의도적으로 자기참조적입니다. find-skills 자체가 설치 수 기준 skills.sh 최상단 스킬입니다 . 자기 순위가 곧 에이전트에게 따르라고 지시하는 리더보드 우선 패턴을 보여줍니다. 신뢰하라고 말하는 바로 그 지표에서 1위를 차지한 부트스트랩인 셈입니다.
Claude Code에 find-skills 넣기
find-skills 설치에는 명령어 하나면 충분하고 설정은 필요 없습니다. 머신에 Node 18 이상, npm, Claude Code가 이미 있어야 합니다. skills npm 패키지는 버전 1.5.15이며, MIT 라이선스이고, 전역 설치 없이 npx로 실행되는 두 바이너리(skills, add-skill)를 제공합니다.
프로젝트 수준에서 find-skills를 추가하려면 다음을 실행합니다.
npx skills add https://github.com/vercel-labs/skills --skill find-skills그러면 현재 저장소의 .claude/skills/find-skills/에 SKILL.md가 들어가며, 해당 프로젝트 범위에만 적용됩니다 [1]. 모든 Claude Code 세션에서 사용할 수 있게 하려면 agent 플래그를 덧붙입니다.
npx skills add https://github.com/vercel-labs/skills --skill find-skills --agent claude-code그러면 파일이 전역 경로인 ~/.claude/skills/에 배치됩니다 [2].
npx skills list로 설치를 확인하면 find-skills가 표시되어야 합니다. skills.sh를 대상으로 실시간 발견을 직접 시험하려면 npx skills find [topic]을 실행합니다. 예를 들어 npx skills find "content writing"을 실행하면 CLI가 디렉터리에서 순위가 매겨진 매칭 결과를 반환합니다. add, list, find 외에도 CLI는 use, remove, update, init을 제공하므로, 스킬이 저장소에 정적 파일로 들어온 뒤에도 같은 도구로 전체 수명주기를 관리할 수 있습니다 [1].
900K가 검증을 뜻하지 않는 이유
skills.sh에 보이는 아홉 자리 숫자는 승인이 아니라 채택 규모를 나타냅니다. 역대 순위표는 익명 CLI 텔레메트리, 즉 설치 핑을 기준으로 매겨지며, 제출 양식도, 사람의 검토도, 공개된 저장소와 순위 사이의 편집 게이트도 없습니다 . 높은 순위는 많은 에이전트가 그 저장소를 대상으로 npx skills add를 실행했다는 뜻이고, 이는 유용성과는 관련이 있을 수 있지만 정확성이나 안전성을 보증하지는 않습니다. skills.sh도 모든 등록 스킬의 품질이나 보안을 보장할 수 없다고 경고하며 이 한계를 직접 밝히고 있습니다 .
스킬이 무엇인지 생각하면 이 위험은 구체적입니다. 임의의 SKILL.md를 설치하면 그 지침이 곧바로 에이전트의 컨텍스트 창에 주입되고, Claude Code의 자체 문서도 프로젝트 스킬이 도구 접근 권한을 부여할 수 있으므로 저장소를 신뢰하기 전에 검토해야 한다고 경고합니다 . 악의적이거나 부주의하게 작성된 스킬 본문은 패키지 매니저를 앞세운 프롬프트 인젝션입니다.
"Prefer skills with 1K+ installs, exercise caution below 100, prioritize reputable owners, and treat repos under 100 GitHub stars skeptically," — find-skills 품질 휴리스틱 (source: find-skills SKILL.md).
이런 휴리스틱, 즉 설치 수, 스타 수, 소유자 평판은 합리적인 대리 지표일 뿐 검증 인증서는 아닙니다 . 잡음을 걸러낼 수는 있지만 파일을 읽어주지는 않습니다. 무엇이든 채택하기 전에 SKILL.md를 열고, 어떤 도구를 요청하는지 확인한 뒤, 의도적으로 커밋하세요.
342개 큐레이션 카탈로그 다음에 볼 곳
전체 역대 목록이라는 물줄기부터 뒤지지 말고, 먼저 큐레이션된 세트에서 시작하세요. 문서화된 샘플에서 /api/v1/skills/curated 엔드포인트는 342개의 스킬과 87명의 소유자를 반환했으며, skills.sh에서는 도메인과 소유자별로 필터링할 수 있습니다. 검색은 한 단어 쿼리에는 퍼지 매칭을, 여러 단어 쿼리에는 시맨틱 검색을 사용하며, limit은 최대 200까지 설정할 수 있고 선택적으로 소유자 필터도 적용할 수 있습니다 (source: skills.sh API).
직접 만들려면 npx skills init으로 새 SKILL.md의 뼈대를 만들 수 있습니다. Agent Skills 명세는 YAML frontmatter의 name과 description, 그리고 Markdown 본문만 요구하므로 형식이 이식 가능하게 유지됩니다 (source: Agent Skills spec).
아직 빠져 있는 것은 네이티브 런타임 자동 발견입니다. 기능 요청 anthropics/claude-code #38253은 바로 이를 위해 skill:// MCP 리소스 URI를 제안하지만, 현재는 사용할 수 없습니다. 그리고 발견 계층은 통합되기보다 조각나고 있습니다. K-Dense-AI의 벡터 검색 MCP와 VoltAgent의 1,000개 이상 카탈로그는 skills.sh에 합쳐지기보다 서로 경쟁합니다. 결론은 이렇습니다. skills.sh를 여러 발견 소스 중 하나로 보고, 먼저 큐레이션된 342개를 살펴본 다음, 커밋하기 전에 각 SKILL.md를 계속 검토하세요.
자주 묻는 질문
skills.sh에는 900K+가 보이는데 큐레이션 목록은 왜 342개뿐인가요?
서로 다른 것을 세기 때문입니다. 900K+ 수치는 전체 미검토 코퍼스를 대상으로 한 역대 목록과 설치 텔레메트리 숫자입니다. skills.sh 홈페이지에는 "All Time (908,452)" 라벨이 표시된 적이 있습니다 . 342는 /api/v1/skills/curated 엔드포인트에서 온 숫자로, 2026-03-31 기준 87명의 소유자에 걸친 선별 하위 집합입니다. 하나는 원시 규모와 인기도를 재고, 다른 하나는 검토된 짧은 목록을 잽니다. 둘은 비교 가능한 분모가 아닙니다.
find-skills는 MCP 서버인가요?
아닙니다. find-skills는 .claude/skills/에 로컬로 설치되는 단일 SKILL.md 파일이지, 계속 실행되는 서비스나 프로토콜이 아닙니다 . 이 파일은 Claude Code가 필요할 때 npx skills find [query]를 실행해 skills.sh를 조회하도록 지시합니다. MCP 핸드셰이크도 백그라운드 프로세스도 없습니다. 에이전트는 스킬의 지침을 읽고, 사용자가 기능을 찾으라고 요청하면 CLI를 셸로 실행할 뿐입니다.
skills.sh에서 설치 수가 높은 스킬은 믿어도 되나요?
높은 설치 수는 인기도를 반영할 뿐 안전성을 뜻하지 않습니다. skills.sh는 제출 게이트나 사람의 검토 없이 익명 CLI 텔레메트리로 항목 순위를 매기며, 사이트 자체도 모든 목록의 품질이나 보안을 보장할 수 없다고 경고합니다 . 스킬 내용은 에이전트 컨텍스트에 주입되므로 채택하기 전에 항상 SKILL.md를 읽으세요. vercel-labs, anthropics, microsoft처럼 평판 있는 소유자를 우선하고, GitHub 스타가 100개 미만인 저장소는 회의적으로 보세요 .
프로젝트 수준 find-skills와 전역 find-skills의 차이는 무엇인가요?
범위입니다. 프로젝트 수준 설치는 .claude/skills/에 있으며 해당 저장소 안에서만 적용됩니다. 전역 설치는 ~/.claude/skills/에 있으며 모든 Claude Code 세션에 적용됩니다 . 어디서나 쓰고 싶은 범용 발견 기능에는 전역 경로를 사용하고, 단일 코드베이스에 커밋해 공유하려는 도메인 특화 도구에는 프로젝트 경로를 사용하세요. 같은 스킬이 양쪽에 정의되어 있으면 Claude Code는 프로젝트 범위보다 개인 범위를 우선합니다.
Claude Code는 언제 네이티브 스킬 자동 발견을 지원하나요?
아직은 아닙니다. 현재 Claude Code에는 네이티브 런타임 자동 발견 기능이 없습니다. 공개 기능 요청 anthropics/claude-code #38253은 스킬을 자동으로 로드하기 위한 skill:// MCP 리소스 URI를 제안합니다 . 하지만 아직 출시되지 않았습니다. 그때까지는 find-skills SKILL.md 부트스트랩을 한 번 설치하고, 필요할 때 npx skills find를 실행하게 해야 합니다.
이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.
