안녕하세요, 자바파커입니다.
에이전트 스킬이 많아지면서 "이런 일을 해 주는 스킬이 있을까?"를 찾는 일이 생겼습니다. skills.sh는 Vercel이 운영하는 에이전트 스킬 디렉터리이고, Claude Code, Codex, Cursor 등 20종의 에이전트를 지원한다고 밝힙니다. 이 글은 skills.sh에서 스킬을 찾는 세 가지 방법을 직접 써 보고 비교한 기록입니다.
결과부터 말씀드리면 이렇습니다.
- 웹 검색창과
npx skills find는 같은 검색 API를 씁니다. 한 단어는 퍼지 검색, 여러 단어는 의미 검색이고 결과는 최대 100개입니다. - "convert pdf tables to excel"로 검색하니 1위가 보안 감사 세 곳 중 두 곳에서 Fail을 받은 스킬이었습니다. 같은 요청을 find-skills를 설치한 Claude에게 맡기니 pdf와 xlsx로 나눠 검색해 Anthropic 공식 스킬을 추천했습니다.
- 한국어 문장 검색은 고르지 않았습니다. "맞춤법 검사"는 잘 찾았지만 "PDF 표를 엑셀로"는 관련 없는 스킬 1건만 나왔습니다.
- 설치 통계를 끄면 설치할 때 보여 주는 보안 점검표도 함께 사라집니다.
스킬이 무엇인지는 Claude Code Skill 사용법에, 스킬 하나를 깊게 검증한 예는 unslop 스킬 실측에 정리해 두었습니다.
skills.sh는 무엇인가
skills.sh 첫 화면은 설치 수 순위표입니다. 전체 기간, 최근 24시간 급상승(Trending), 인기(Hot) 탭이 있고 주제별 분류, 공식 스킬(Official), 보안 감사(Audits) 메뉴가 있습니다. 순위는 skills CLI가 보내는 익명 설치 통계로 매깁니다. 문서에는 어떤 스킬이 설치됐는지만 기록하고 개인 정보는 모으지 않는다고 적혀 있습니다.
바탕이 되는 CLI는 vercel-labs/skills로 공개돼 있습니다. MIT 라이선스이고 2026년 11월 10일 기준 GitHub 별 3.9만 개입니다. 순위표 1위는 이 저장소의 find-skills 스킬로, 설치 수가 430만입니다.
스킬을 찾는 세 가지 방법
npx skills find pdf. 설치 명령과 설치 수, 상세 페이지 링크를 함께 보여 줍니다.웹 검색창에서 입력할 때 브라우저가 보내는 요청을 확인해 보니 /api/search?q=...&limit=100이었고, CLI 소스(src/find.ts)도 같은 주소를 부릅니다. "convert pdf tables to excel"로 비교해 보니 웹과 CLI의 결과 14개가 같은 순서로 나왔습니다.
검색은 어떻게 동작하나
skills.sh API 문서에 따르면 검색어가 한 단어면 퍼지 검색, 여러 단어면 의미 검색을 씁니다. 응답에 searchType 필드로 어느 쪽이었는지 나오고, 실제 응답에서 검색 엔진은 Algolia(searchVersion: algolia)였습니다.
CLI를 쓸 때 주의할 점이 하나 있습니다. skills 1.7.6은 Node.js 22.20 이상이 필요합니다. Node 20에서 npx skills find를 실행하면 fs/promises에 glob이 없다는 SyntaxError로 바로 종료됐습니다.
직접 검색해 본 결과
2026년 11월 10일에 검색어 9개로 시험했습니다. 결과 수와 1위는 이렇습니다.
| 검색어 | 방식 · 결과 수 | 1위 (설치 수) |
|---|---|---|
| 퍼지 · 100 | anthropics/skills의 pdf (22.6만) | |
| pdff (오타) | 퍼지 · 7 | pdffiller (57), 2위가 anthropics pdf |
| code review | 의미 · 100 | mattpocock/skills의 code-review (87.3만) |
| review my pull request before merge | 의미 · 22 | 같은 code-review |
| convert pdf tables to excel | 의미 · 14 | tanis90의 pdf-converter (9.7천) |
| korean | 퍼지 · 100 | korean-spell-check (1.2만) |
| 맞춤법 검사 | 의미 · 7 | daleseo/korean-skills의 grammar-checker (2.4천) |
| 한국어 | 퍼지 · 100 | korean-humanizer (9.4천) |
| PDF 표를 엑셀로 | 의미 · 1 | lark-sheets (Lark 스프레드시트용) |
한국어 검색은 결과가 갈렸습니다. "맞춤법 검사"는 한국어 맞춤법 스킬을 잘 찾았지만, "PDF 표를 엑셀로"는 PDF와 상관없는 스프레드시트 스킬 1건만 나왔습니다. 영어로 같은 뜻을 쓰면 14건이 나옵니다. 한국어로 찾다가 결과가 이상하면 영어 키워드로 다시 검색하는 편이 낫습니다.
find-skills: 에이전트에게 검색을 맡기면
find-skills는 스킬을 찾는 방법을 에이전트에게 가르치는 스킬입니다. SKILL.md에는 검색하기 전에 순위표부터 보고, 설치 수 1천 미만이나 별 100개 미만 저장소는 조심하고, 공식 출처를 우선하라는 기준이 적혀 있습니다.
빈 테스트 프로젝트에 find-skills만 설치하고, Claude Code(2.1.322, claude-opus-5-5)에게 스킬 이름을 말하지 않고 물었습니다. 비교군은 스킬이 없는 빈 프로젝트입니다. 에이전트가 실행할 수 있는 명령은 npx skills find와 skills.sh·GitHub 조회로 제한했고, 설치 명령은 막았습니다. 요청마다 한 번씩 돌렸습니다.
에이전트는 요청을 PDF 추출과 엑셀 생성으로 나눠 키워드 검색을 했습니다. 문장 하나로 의미 검색을 한 결과보다 나은 선택이었습니다. 다만 xlsx도 Socket 감사에서 Warn이 있었고, 에이전트는 이 점을 언급하지 않았습니다. find-skills의 SKILL.md에 적힌 확인 기준(설치 수, 출처, GitHub 별 수)에도 보안 감사는 없습니다.
다른 두 요청도 돌렸습니다.
- "Is there a skill that can help me check Korean spelling?": find-skills가 켜져 korean-spell-check(1.2만)를 추천했습니다. GitHub 별 수를 확인하려던 명령이 막히자 "출처를 확인하지 못했고, 외부 맞춤법 서비스로 글을 보내는지 모른다"고 그대로 밝혔습니다.
- "PR 리뷰를 좀 더 꼼꼼하게 하고 싶어": find-skills가 켜지지 않았습니다. Claude Code에 기본으로 있는
/code-review를 안내했습니다.
설치 전에 확인할 것
스킬은 에이전트에게 지시를 넣는 파일입니다. 설치를 마치면 CLI도 "Review skills before use; they run with full agent permissions."라고 경고합니다. 실험하면서 확인한 주의점은 네 가지입니다.
-g -y(전역 설치, 확인 생략)로 설치하라고 안내합니다. 에이전트 안에서 실행되면 CLI도 확인 없이 설치합니다.2번은 CLI 소스에서 확인했습니다. 보안 점검 데이터를 받아오는 함수(fetchAuditData)가 통계 설정이 꺼져 있으면 바로 빈 값을 돌려줍니다. 실제로 통계를 끄고 find-skills를 설치했을 때 점검표가 나오지 않았습니다. 통계를 끌 생각이라면 설치 전에 웹 페이지에서 감사 결과를 직접 확인해야 합니다.
3번의 예가 korean-spell-check입니다. 이 스킬의 SKILL.md는 npx -y @nomadamas/k-skill@0 instruct korean-spell-check를 실행해서 나온 내용을 지시로 따르라고 안내합니다. 버전이 @0으로만 고정돼 있어 패키지가 업데이트되면 지시도 바뀝니다. 설명에는 Nara·PNU(부산대) 맞춤법 검사기를 쓴다고 적혀 있어, 검사할 글이 외부 서비스로 나갈 수 있습니다. 보안 감사 결과는 Gen Agent Trust Hub와 Socket이 Pass, Snyk가 Warn이었습니다. 악성이라는 뜻은 아니지만, 사내 문서에 쓰기 전에 지시 원문을 확인할 필요는 있습니다.
명령어 정리
# 검색 (Node.js 22.20 이상)
npx skills find pdf
npx skills find "code review" --owner anthropics
# 저장소에 어떤 스킬이 있는지만 보기
npx skills add anthropics/skills --list
# 지금 프로젝트에만 설치 (전역 설치는 -g)
npx skills add anthropics/skills --skill pdf -a claude-code
# find-skills 설치
npx skills add vercel-labs/skills --skill find-skills--skill 없이 저장소만 지정하면 그 저장소의 스킬을 여러 개 고르게 됩니다. 필요한 스킬만 지정하는 편이 안전합니다. 프로젝트에 설치하면 skills-lock.json에 출처와 파일 해시가 기록됩니다.
자주 묻는 질문 (FAQ)
skills.sh 검색과 npx skills find는 결과가 다른가요?
같습니다. 둘 다 skills.sh의 /api/search를 부르고, 같은 검색어에서 같은 순서의 결과가 나왔습니다. 웹은 보안 감사 결과를 상세 페이지에서 바로 볼 수 있고, CLI는 설치 명령을 바로 복사할 수 있다는 차이 정도입니다.
한국어로 검색해도 되나요?
됩니다. 다만 결과가 들쭉날쭉합니다. "맞춤법 검사"는 한국어 맞춤법 스킬을 잘 찾았지만, "PDF 표를 엑셀로"는 관련 없는 1건만 나왔습니다. 결과가 이상하면 "pdf", "excel"처럼 영어 키워드로 다시 찾아보세요.
find-skills를 설치하면 무엇이 달라지나요?
"이런 일을 해 주는 스킬이 있어?"라고 물을 때 에이전트가 skills.sh를 검색하고, 설치 수와 출처를 기준으로 골라 추천합니다. 이번에 한 번 돌린 실험에서는 요청을 키워드 여러 개로 나눠 검색해 직접 검색보다 나은 스킬을 골랐습니다. 다만 보안 감사 결과는 확인하지 않았습니다.
설치 수가 많으면 안전한가요?
아닙니다. 순위는 설치 통계로 매길 뿐이고, 이번 검색에서도 설치 수 9.7천의 스킬이 보안 감사 두 곳에서 Fail을 받았습니다. 설치 전에 skills.sh 상세 페이지의 감사 결과와 SKILL.md 원문을 확인하세요.
처음 써 볼 때
- Node.js 22.20 이상인지 확인합니다.
- 한두 단어 키워드로
npx skills find를 실행하거나 skills.sh에서 검색합니다. - 후보의 skills.sh 페이지에서 보안 감사 세 곳의 결과와
SKILL.md를 봅니다. --skill로 필요한 스킬만 골라 프로젝트에 먼저 설치해 봅니다.- 자주 찾게 되면 find-skills를 설치하고, 에이전트의 추천도 3번 기준으로 한 번 더 확인합니다.