목록 · 가이드
클로드 스킬 설치하는 법: npx skills add 한 줄과 오류 해결NEW
클로드 스킬은 대부분 Claude Code 의 명령 입력 칸에 npx skills add <저장소> -g -a claude-code 한 줄을 붙여 넣어 설치합니다. 이 사이트가 정리한 스킬 68개 가운데 52개가 이 방식이고, 나머지 16개는 플러그인(7개), 저장소 내려받기(5개), npm·uv 명령줄 도구(3개), 목록(1개)입니다. 이 장은 어디에 붙여 넣는지부터 다시 시작, 확인 명령, 자주 나는 오류까지 한 번에 정리했습니다. 각 스킬의 정확한 명령은 그 스킬의 상세 장 맨 위 "설치 한 줄"에 있습니다.
2026년 10월 13일 이 사이트의 스킬 데이터(data/skills.json) 기준입니다.
어디에 붙여 넣나
Claude Code 는 네 가지 모습으로 씁니다. 어느 쪽이든 명령을 넣는 자리에 같은 한 줄을 붙여 넣으면 됩니다.
| 쓰는 곳 | 넣는 곳 | Node.js |
|---|---|---|
| 터미널 | 맥은 터미널, 윈도우는 PowerShell | 따로 설치해야 합니다 |
| 데스크톱 앱 | 맥·윈도우용 Claude Code 앱의 입력 칸 | 들어 있습니다 |
| 웹 | claude.ai/code 의 입력 칸 | 들어 있습니다 |
| 편집기 확장 | VS Code·JetBrains 확장의 입력 칸 | 들어 있습니다 |
대화만 하는 Claude 앱의 채팅창은 Claude Code 가 아닙니다. 거기에 붙여 넣으면 Claude 가 명령을 글로 읽고 설명만 해 줍니다. 스킬도 그쪽에는 들어가지 않습니다.
저장소 스킬 넣기: 다섯 단계
터미널을 엽니다
맥은 Spotlight(Command + 스페이스)에서 "터미널"을, 윈도우는 시작 메뉴에서 "PowerShell"을 엽니다. 데스크톱 앱·웹·편집기 확장으로 쓰시면 이 단계를 건너뛰고 그 안의 입력 칸을 쓰십시오.
Node.js 를 확인합니다
터미널에 node -v 를 쳐서 v20.1.2 처럼 버전이 나오면 준비된 것입니다. "찾을 수 없습니다"가 나오면 nodejs.org 에서 LTS 버전을 먼저 설치하십시오.
설치 한 줄을 붙여 넣습니다
스킬 상세 장의 "설치 한 줄"을 복사해 붙여 넣습니다. 모양은 아래와 같습니다. 성공하면 Installed 1 skill → ~/.claude/skills/... 한 줄이 나옵니다.
-g 는 계정 전체(~/.claude/skills)에 넣습니다. 빼면 지금 열린 폴더(./.claude/skills)에만 깔려서, 다른 폴더에서 열면 스킬이 보이지 않습니다. -a claude-code 는 Claude Code 에만 넣습니다. 빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간 "Failed to install"이 뜨지만, 실제로는 설치가 끝난 상태입니다. 저장소에 스킬이 여러 개면 무엇을 넣을지 물어보고, 미리 보려면 --list 를 붙입니다.
Claude Code 를 다시 시작합니다
실행 중인 세션은 시작할 때 읽은 스킬 목록을 그대로 씁니다. 터미널이면 claude 를 끝내고 다시 실행하고, 데스크톱 앱·웹·편집기 확장이면 세션을 새로 여십시오.
설치를 확인합니다
npx skills list -g 를 치면 전역으로 넣은 스킬이 이름·경로와 함께 나옵니다. -g 를 빼면 지금 폴더의 스킬만 보여 "없다"고 나올 수 있습니다. 그다음 그 스킬이 맡는 일을 시키면 Claude 가 알아서 불러 씁니다.
플러그인으로 넣는 스킬
superpowers 처럼 플러그인으로 배포되는 스킬은 마켓플레이스를 먼저 등록하고 플러그인을 넣습니다. 두 줄 모두 Claude Code 안에서 칩니다.
위는 superpowers 의 예입니다. 다른 플러그인은 상세 장의 두 줄을 그대로 쓰십시오. 넣은 뒤에는 Claude Code 를 다시 시작합니다. 플러그인은 스킬·명령어·훅·MCP 서버를 한 번에 묶은 단위이고, 차이는 스킬·MCP·플러그인 차이에 정리했습니다.
npm·uv 명령줄 도구
agent-browser 나 graphify 처럼 명령줄 도구로 배포되는 스킬은 도구를 먼저 깔고, 도구의 설치 명령을 한 번 더 돌립니다. 예를 들어 agent-browser 는 npm install -g agent-browser 다음에 agent-browser install 을 칩니다. npm 도구는 Node.js 가, uv 도구는 uv(astral.sh/uv)가 있어야 합니다. 두 번째 줄까지 실행해야 준비가 끝나고, 그 뒤 Claude 를 완전히 껐다 켭니다.
저장소를 내려받는 스킬
gstack 처럼 git clone 으로 받는 스킬은 내려받은 폴더의 README 에 적힌 설정 명령까지 실행해야 끝납니다. gstack 은 받은 폴더에서 ./setup 을 실행해야 슬래시 명령이 생기고, 업데이트는 /gstack-upgrade 로 합니다(2026-10-13 확인). 업데이트 명령이 없는 클론형 스킬은 가끔 저장소를 다시 받아 최신으로 맞추십시오.
안 될 때 확인할 것
| 증상 | 원인 | 할 일 |
|---|---|---|
| 깔았는데 스킬이 안 보입니다 | -g 없이 넣어 다른 폴더에만 깔렸습니다 | -g 를 붙여 다시 넣고 세션을 새로 엽니다 |
| 빨간 "Failed to install"이 뜹니다 | -a claude-code 가 빠져 다른 도구 설치가 실패했습니다 | npx skills list -g 로 확인하면 대개 이미 깔려 있습니다 |
| Claude 가 명령을 설명만 합니다 | 대화용 Claude 앱 채팅창에 붙여 넣었습니다 | Claude Code 의 입력 칸이나 터미널에 넣습니다 |
| "npx 를 찾을 수 없습니다" | 터미널에 Node.js 가 없습니다 | nodejs.org 에서 LTS 를 설치합니다 |
| 깔았는데 안 씁니다 | 실행 중인 세션이 예전 목록을 씁니다 | Claude Code 를 다시 시작합니다 |
MCP 서버 연결이 안 될 때는 MCP 서버 연결 안 될 때 점검할 8가지를 보십시오. MCP 를 처음 붙인다면 Claude 에 MCP 서버 설치하는 법이 먼저입니다.
넣기 전에 SKILL.md 를 읽으십시오
스킬은 Claude 에게 그대로 들어가는 지시문입니다. 무엇을 시키는지 확인하지 않고 넣으면 의도하지 않은 동작을 할 수 있습니다. 저장소의 별 개수는 인기 지표일 뿐 품질 보증이 아니므로, npm 패키지를 고를 때처럼 SKILL.md 를 열어 직접 읽고 판단하십시오.
자주 묻는 질문
npx skills add <저장소> -g -a claude-code 를 붙여 넣고, Claude Code 를 다시 시작하면 됩니다. 이 사이트 스킬 68개 가운데 52개가 이 방식입니다.npx skills list -g 를 치면 전역으로 넣은 스킬이 이름과 경로와 함께 나옵니다. 목록에 있는데 Claude 가 쓰지 않으면 Claude Code 세션을 새로 여십시오.