클로드 스킬 모음 — 공식 Skills와 고르는 법·설치법

클로드 스킬(Agent Skills)은 특정 작업의 절차·규칙·스크립트를 폴더 하나에 묶어 두고, Claude가 필요할 때만 꺼내 쓰게 하는 구조입니다. 평소에는 이름과 설명만 읽고, 작업이 맞아떨어질 때 본문을 불러오기 때문에 여러 개를 등록해도 부담이 적습니다. 개념과 단계적 로딩 원리는 Claude Skills란 무엇인가에서 자세히 다룹니다.

이 글은 "이미 만들어진 Skill을 어디서 찾아, 무엇을 골라, 어떻게 안전하게 넣을 것인가"에 집중합니다. 직접 만드는 방법은 SKILL.md 작성법을 참고하세요.

핵심 요약

• 클로드 스킬 모음의 출발점은 Anthropic 공식 저장소 github.com/anthropics/skills입니다.
• 공식 Skills는 Claude Code에서 /plugin marketplace add anthropics/skills로 한 번에 등록합니다.
• claude.ai 등 Claude 앱에서는 Customize > Skills 화면에서 켜고 끄며, 직접 만든 Skill은 ZIP으로 올립니다.
• 서드파티 Skill은 스크립트를 실행할 수 있으므로 설치 전에 SKILL.md와 스크립트를 읽어야 합니다.

공식 Skills 저장소 한눈에 보기

Anthropic은 GitHub의 anthropics/skills 저장소에 Skill 예제를 공개하고 있습니다. skills/ 폴더에 Skill들이, spec/에 Agent Skills 규격이, template/에 새 Skill의 틀이 들어 있습니다. Agent Skills 규격은 agentskills.io에 공개 표준으로도 게시돼 있습니다.

저장소의 Skill은 다섯 개의 플러그인으로 묶여 배포되며, 설치는 플러그인 단위로 합니다.

문서 작업용 — document-skills

이 네 가지는 소스는 공개돼 있지만 오픈소스 라이선스가 아닌 "소스 공개(source-available)" 방식입니다. 각 폴더의 LICENSE.txt에서 조건을 확인하세요.

예제 모음 — example-skills

example-skills 쪽 Skill은 대부분 Apache 2.0 오픈소스입니다. 저장소 README는 이 Skill들이 시연·교육용이므로 중요한 업무에 쓰기 전에 충분히 시험해 보라고 안내합니다.

단독 플러그인 3종

저장소 구성은 바뀔 수 있으니 설치 전에 skills/ 폴더를 한 번 확인하세요.

Claude Code에서 Skills 추가하는 법

Claude Code에서 스킬을 추가하는 길은 두 가지입니다. 마켓플레이스에서 플러그인으로 설치하거나, Skill 폴더를 정해진 위치에 직접 두는 방법입니다.

방법 1. 마켓플레이스에서 플러그인으로 설치

공식 Skills 저장소를 마켓플레이스로 등록한 뒤 필요한 플러그인을 설치합니다. 마켓플레이스 이름은 anthropic-agent-skills입니다.

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

설치할 때 범위를 고릅니다. user는 나만 모든 프로젝트에서, project는 이 저장소의 모든 협업자가(.claude/settings.json에 기록), local은 나만 이 저장소에서 씁니다. /plugin의 Discover 탭에서 플러그인을 고르면 매 턴 추가되는 컨텍스트 비용 추정치와, 설치될 Skill·에이전트·훅·MCP 서버 목록을 설치 전에 보여 줍니다.

플러그인으로 들어온 Skill은 플러그인 이름이 앞에 붙습니다. 예를 들어 skill-creator는 /example-skills:skill-creator처럼 부를 수 있고, 평소에는 Claude가 description을 보고 알아서 꺼내 씁니다.

그 밖에 알아 둘 공식 마켓플레이스는 다음과 같습니다.

공식 마켓플레이스 목록은 claude.com/plugins 에서도 볼 수 있습니다.

방법 2. Skill 폴더를 직접 두기

GitHub에서 받은 Skill 폴더나 직접 만든 Skill은 아래 위치에 두면 인식됩니다.

이름이 겹치면 조직 관리 설정, 개인, 프로젝트 순으로 우선합니다. 이미 있는 skills 폴더 안에서 SKILL.md를 추가하거나 고치면 재시작 없이 현재 세션에 반영되지만, skills 폴더 자체를 처음 만들었다면 Claude Code를 다시 시작해야 합니다. 인식됐는지는 /skills로 확인합니다.

Claude 앱(claude.ai)에서 Skills 쓰는 법

Skills는 Free·Pro·Max·Team·Enterprise 요금제에서 쓸 수 있고, 코드 실행 기능이 켜져 있어야 동작합니다.

1. 개인 요금제는 Settings > Capabilities 에서 "Code execution and file creation"을 켭니다. Team·Enterprise는 관리자가 Organization settings > Skills 에서 허용해야 합니다.
2. Customize > Skills 로 가서 Anthropic이 제공하는 Skill을 필요에 따라 켜고 끕니다. Word·Excel·PowerPoint·PDF 문서 작업 Skill이 여기에 해당하며, 관련 작업이면 자동으로 쓰입니다.
3. 직접 만든 Skill은 폴더를 ZIP 파일로 묶은 뒤, 같은 화면의 "+" → "+ Create skill" → "Upload a skill"로 올립니다.

Team·Enterprise에서는 관리자가 승인한 Skill을 조직 전체에 배포할 수 있고, Notion·Figma·Atlassian 같은 파트너가 만든 Skill도 제공됩니다. claude.ai 계정에서 켠 Skill은 Claude Code 세션에도 /anthropic-skills:<이름> 형태로 동기화됩니다. 요금제별 세부 조건은 요금제 비교와 공식 요금제 페이지를 확인하세요.

클로드 스킬 고르는 기준

"클로드 스킬 추천"을 검색해 목록을 모으는 것보다, 지금 내 업무에 맞는지를 따지는 편이 결과가 좋습니다. 설치 전에 아래 항목을 확인하세요.

• 지금 매주 반복하는 작업과 직접 연결되는가
• 출처가 분명한가(공식 저장소, 사내 저장소, 신원이 확인되는 작성자)
• description이 언제 쓰이는지를 구체적으로 적고 있는가
• 이미 쓰는 Skill과 역할이 겹치지 않는가
• scripts 폴더가 있다면 무엇을 실행하는지 이해할 수 있는가
• 외부 패키지 설치나 네트워크 접속을 요구하는가
• allowed-tools로 어떤 도구를 미리 허가하는가
• 라이선스가 사내·상업적 사용을 허용하는가
• 최근까지 관리되고 있는가

역할이 겹치는 Skill이 많으면 Claude가 엉뚱한 것을 고를 수 있으므로, 필요한 것만 넣고 안 쓰는 것은 정리하세요. 어떤 일이 Skill로 만들 가치가 있는지는 Skills가 해결하는 과제에서 이어집니다.

서드파티 Skill 설치 전 보안 점검

GitHub에는 커뮤니티가 모아 둔 클로드 스킬 모음 저장소도 많지만 검증 수준은 제각각입니다. 공식 저장소가 아닌 곳의 Skill은 다음 사항을 알고 써야 합니다.

• Skill은 스크립트를 담을 수 있고, 외부 패키지 설치를 지시할 수도 있습니다.
• SKILL.md에 셸 명령을 넣어 두면 Skill이 불릴 때 권한 확인 창 없이 실행됩니다. 권한 설정의 거부(deny) 규칙에 걸리면 실행이 중단됩니다.
• allowed-tools는 폴더 신뢰 여부와 관계없이 적용되므로, Skill이 스스로 넓은 도구 권한을 미리 허가할 수 있습니다.
• 공식 도움말은 신뢰할 수 있는 출처의 Skill만 설치하라고 권하며, 프롬프트 인젝션과 데이터 유출 위험을 명시합니다.
• 플러그인과 마켓플레이스는 내 사용자 권한으로 임의의 코드를 실행할 수 있는 구성 요소입니다.

그래서 설치 전 점검 순서는 이렇게 잡습니다.

1. SKILL.md 전체를 읽고, 셸 명령과 allowed-tools 항목을 확인합니다.
2. scripts 폴더의 파일을 열어 네트워크 전송, 파일 삭제, 인증 정보 접근이 있는지 봅니다.
3. requirements.txt 같은 의존성 목록을 확인합니다.
4. 먼저 테스트용 프로젝트에 project 범위로 설치해 동작을 봅니다.
5. 문제가 없으면 개인 또는 팀 범위로 넓힙니다.

조직 차원에서는 관리 설정으로 추가 가능한 마켓플레이스를 제한하거나, disableSkillShellExecution으로 Skill 안의 셸 명령 실행을 막을 수 있습니다. Enterprise에서는 업로드된 Skill을 실행 전에 악성 여부를 검사하는 기능도 켤 수 있습니다. 권한 설정 전반은 권한 설정을 참고하세요.

팀에 Skills 배포하기

팀에서 같은 Skill을 쓰게 하는 가장 간단한 방법은 프로젝트의 .claude/skills/에 넣고 git에 커밋하는 것입니다. 여러 저장소에 걸쳐 배포하려면 사내 git 저장소를 마켓플레이스로 만듭니다.

저장소 루트에 .claude-plugin/marketplace.json을 둡니다. 필수 항목은 마켓플레이스 name, 관리자 owner, 플러그인 목록 plugins입니다.

{
  "name": "company-tools",
  "owner": { "name": "DevTools Team" },
  "plugins": [
    { "name": "report-skills", "source": "./plugins/report-skills" }
  ]
}

그다음 각 프로젝트의 .claude/settings.json에 마켓플레이스와 켤 플러그인을 적어 둡니다.

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": { "source": "github", "repo": "your-org/claude-plugins" }
    }
  },
  "enabledPlugins": {
    "report-skills@company-tools": true
  }
}

팀원이 프로젝트 폴더를 신뢰하면 마켓플레이스가 자동으로 추가됩니다. 외부 저장소에서 오는 플러그인은 각자 한 번 설치해야 불러와지며, 설치 명령은 Claude Code가 안내합니다. 비공개 저장소는 기존 git 인증(gh auth login, ssh-agent)을 그대로 씁니다. 수정은 저장소에 push하고, 팀원은 /plugin marketplace update로 받습니다. 팀 운영 방식은 팀 워크플로에서 이어서 볼 수 있습니다.

정리

• 클로드 스킬 모음은 공식 저장소 anthropics/skills에서 시작하고, 마켓플레이스로 추가해 플러그인 단위로 설치합니다.
• Claude Code는 마켓플레이스 설치와 ~/.claude/skills·.claude/skills 폴더 배치, Claude 앱은 Customize > Skills 화면을 씁니다.
• 반복 업무와 맞는지, 출처와 실행 내용이 분명한지를 기준으로 고릅니다.
• 서드파티 Skill은 SKILL.md와 스크립트를 읽은 뒤 테스트 프로젝트에서 먼저 써 봅니다.
• 팀에는 git 저장소 마켓플레이스와 .claude/settings.json 등록으로 배포합니다.

Skills를 업무에 맞게 설계하고 팀에 정착시키는 과정은 Claude 교육에서 실습으로 다룹니다.

이 글의 내용은 2026년 9월 기준 공식 문서와 anthropics/skills 저장소를 확인해 작성했습니다.