Claude Code를 한동안 사용해 오셨다면, 아마도 동일한 다단계 지침들을 터미널에 반복해서 복사하여 붙여넣었을 것입니다. "항상 TypeScript strict mode를 사용하세요." "TDD를 따르세요. 테스트를 먼저 작성하세요." "이 PR을 검토하고 변경 사항을 요약하세요."

Claude Code Skills가 그 모든 것에 대한 해답입니다.

Skills는 Claude가 전문적인 작업에서 성능을 향상시키기 위해 동적으로 로드하는 지침(instructions), 스크립트(scripts), 그리고 참조 자료(reference materials)가 담긴 폴더입니다. 매 세션마다 같은 말을 반복하는 대신, 지침을 한 번 작성하여 적절한 위치에 저장해 두면 Claude가 자동으로 이를 가져오거나, /skill-name 슬래시 명령어(slash command)를 통해 필요할 때 호출할 수 있습니다.

이 가이드는 Skills가 무엇인지, 수천 개의 Skills를 무료로 어디서 찾을 수 있는지, 어떻게 설치하는지, 그리고 어떻게 자신만의 Skills를 처음부터 구축하는지 등 모든 것을 다룹니다.

Skill이란 정확히 무엇인가?

핵심적으로 Skill은 내부에 SKILL.md 파일이 들어 있는 폴더일 뿐입니다. 해당 파일은 두 부분으로 구성됩니다:

1. YAML frontmatter — Claude가 언제 해당 skill을 활성화할지 결정하는 데 사용하는 메타데이터(metadata)
2. Markdown instructions — Claude가 실제로 수행해야 할 작업

최소한의 구조는 다음과 같습니다:

my-skill/
└── SKILL.md

그리고 최소한의 SKILL.md는 다음과 같이 생겼습니다:

---
name: code-review
description: >
...

그게 전부입니다. 이 폴더를 프로젝트의 .claude/skills/ 폴더(또는 전역 사용을 위해 ~/.claude/skills/)에 넣으면, Claude는 컨텍스트(context)가 일치할 때 자동으로 이를 사용하거나, /code-review로 명시적으로 호출할 수 있습니다.

Skills는 훨씬 더 확장될 수 있습니다. 이들은 번들링된 스크립트(모든 언어 지원), 온디맨드(on-demand) 참조 파일, `!``command``` 구문을 사용한 셸 명령어 치환(shell command substitution), 그리고 심지어 서브 에이전트(sub-agents)까지 지원합니다. 하지만 단순한 사례는 그저 Markdown 파일 하나일 뿐입니다.

Skills가 위치하는 곳 (범위 및 우선순위)

Skills는 세 가지 수준에서 저장될 수 있으며, 명확한 계층 구조에 따라 서로를 덮어씁니다:

범위 (Scope)	위치 (Location)	사용 가능 대상
개인 (Personal)	~/.claude/skills/	모든 프로젝트에 걸쳐 오직 사용자 본인만 사용 가능
...

동일한 기술(skill) 이름이 여러 수준에서 존재할 경우, 엔터프라이즈(enterprise)가 개인(personal)을 덮어쓰고, 개인(personal)이 프로젝트(project)를 덮어씁니다. code-review라는 이름을 가진 프로젝트 기술은 동일한 이름을 가진 기존의 모든 번들 기술을 완전히 대체합니다.

다음 명령어를 실행하여 무엇이 로드되었는지, 그리고 기술이 잘리지(truncated) 않았는지 확인할 수 있습니다:

plaintext /doctor

오픈 표준: agentskills.io

SKILL.md 파일의 기반이 되는 형식은 agentskills.io에서 관리되는 오픈 표준(open standard)입니다. Anthropic이 원래 Claude Code를 위해 개발했지만, 현재는 Claude Code, OpenAI Codex, Gemini CLI, Cursor 및 기타 여러 에이전트(agents)에서 지원됩니다. Claude Code를 위해 작성한 기술은 최소한의 변경만으로 다른 플랫폼에 맞게 조정할 수 있습니다. 프런트매터(frontmatter) 필드와 마크다운(Markdown) 구조가 동일하기 때문입니다.

팀에서 여러 AI 코딩 도구를 사용한다면 이러한 이식성(portability)은 매우 중요합니다.

필수 리소스

🏛️ 공식: github.com/anthropics/skills

표준 소스(canonical source)입니다. Anthropic의 공개 Skills 저장소에는 네 가지 카테고리의 기술이 포함되어 있습니다:

• 창의 및 디자인 (Creative & Design) — 예술, 음악, 브랜드 가이드라인
• 개발 및 기술 (Development & Technical) — 웹앱 테스트, MCP 서버 생성, 코드 리뷰 (code review)
• 엔터프라이즈 및 커뮤니케이션 (Enterprise & Communication) — 내부 커뮤니케이션, 런북 (runbooks), 상태 보고서
• 문서 기술 (Document Skills) — Claude의 pptx, docx, pdf, xlsx 기능의 기반이 되는 실제 제작 기술

이 문서 기술들은 소스 공개(source-available) 방식이며(오픈 소스는 아님), 복잡하고 실제적인 기술 설계에 있어 훌륭한 참고 자료가 됩니다.

마켓플레이스에서 설치:

shell /plugin install document-skills@anthropic-agent-skills /plugin install example-skills@anthropic-agent-skills

또는 특정 기술을 다음 명령어로 설치할 수 있습니다:

shell npx skills add https://github.com/anthropics/skills --skill doc-coauthoring

🌐 skills.sh

skills.sh는 Skills 생태계를 위한 커뮤니티 브라우징 레이어(browsing layer)입니다. 공개된 GitHub 저장소(repositories)를 자동으로 인덱싱하며, 원본 GitHub 저장소를 일일이 뒤져볼 필요 없이 스킬별 상세 페이지, 설치 명령어, 품질 지표를 제공합니다.

스킬을 검색하고 클릭하면 바로 복사할 수 있는 npx skills add 명령어가 나타납니다. 이는 AI 에이전트 지침(instructions)을 위한 npm 레지스트리(registry)에 가장 가까운 형태입니다.

🔍 claude-plugins.dev

claude-plugins.dev/skills는 GitHub의 모든 공개 SKILL.md 파일을 자동으로 인덱싱하는 커뮤니티 유지 관리 레지스트리입니다. Claude Code, Cursor, Codex 및 기타 에이전트들을 다루며 오픈 소스(open-source)로 운영됩니다. 목록에 있는 모든 스킬은 브라우저를 전환할 필요 없이 Claude Code 내부에서 직접 설치할 수 있습니다.

📚 skillsdirectory.com

skillsdirectory.com은 보안 테스트를 거친 스킬들을 큐레이션(curates)합니다. 모든 항목은 목록에 등록되기 전 악성코드(malware), 프롬프트 인젝션 (prompt injection), 자격 증명 탈취 (credential theft) 여부를 스캔합니다. 업무용 컴퓨터나 팀 공유 환경에서 스킬을 설치한다면, 이곳이 가장 먼저 살펴봐야 할 안전한 레지스트리입니다.

📦 claudskills.com

claudskills.com은 공개 GitHub 저장소에서 가져온 67,000개 이상의 오픈 스킬을 인덱싱합니다. 무료 티어(free tier)에서는 모든 내용을 검색하고 둘러볼 수 있습니다. Pro 티어(월 $9)를 사용하면 다중 신호 품질 점수(multi-signal quality score)와 데스크톱 앱에서의 원클릭 설치 기능이 추가됩니다.

최고의 커뮤니티 GitHub 저장소 (Repos)

github.com/anthropics/skills (공식)

참조 구현체(reference implementation)입니다. 여기서부터 시작하세요.

github.com/travisvn/awesome-claude-skills

최고의 스킬, 도구 및 리소스를 선별한 목록으로, Skills 생태계를 위한 "awesome list"입니다. docx, pdf, pptx, 웹 앱 테스트 (webapp testing), MCP 빌더 (MCP builder), 브랜드 가이드라인 (brand guidelines) 등을 다루며 각 항목에 대한 품질 참고 사항이 포함되어 있습니다.

github.com/obra/superpowers

가장 많은 스타(star)를 받은 행동 기술(behavioral skill) 컬렉션 중 하나입니다. TDD(테스트 주도 개발) 강제, 디버깅 워크플로(debugging workflows), 그리고 수 시간 동안 지속되는 자율 코딩 패턴(autonomous coding patterns)을 인코딩합니다. 서브에이전트(subagent) 기반 아키텍처는 긴 작업 수행 시 컨텍스트 드리프트(context drift)를 방지합니다. 설치 방법:

shell /plugin marketplace add obra/superpowers-marketplace

github.com/alirezarezvani/claude-skills

13개 플랫폼(Claude Code, Codex, Gemini CLI, Cursor 등)에 걸친 337개의 기술을 제공합니다. 엔지니어링, 마케팅, 컴플라이언스(compliance), C-레벨 자문(C-level advisory), 비즈니스 운영을 다룹니다. 번들로 제공되는 579개의 Python CLI 도구는 모두 표준 라이브러리(standard library)를 사용하므로, 별도의 pip 설치가 전혀 필요하지 않습니다.

`shell

Claude Code용

./scripts/install.sh --tool claude-code

기타 도구용

./scripts/convert.sh --tool all
./scripts/install.sh --tool
`

github.com/Jeffallan/claude-skills

언어, 백엔드/프론트엔드 프레임워크(frameworks), 인프라스트럭처(infrastructure), API, 테스트, DevOps, 보안, 데이터/ML, 플랫폼 전문가 등 12개 카테고리에 걸쳐 풀스택 개발자를 위한 66개의 기술을 제공합니다. 기술은 사용자의 요청 컨텍스트(request context)에 따라 자동으로 활성화됩니다.

github.com/glebis/claude-skills

커뮤니티 기술로, Gmail, Calendar, Drive, Sheets, Docs, Tasks, Chat을 터미널에서 모두 사용할 수 있는 포괄적인 Google Workspace 기술(gws)을 포함합니다. 또한 딥 리서치(deep-research) 기술과 TDD 강제 도구도 포함되어 있습니다.

shell npx skills add glebis/claude-skills --skill tdd npx skills add glebis/claude-skills --skill deep-research

github.com/tech-leads-club/agent-skills

보안을 최우선으로 하는 큐레이션 라이브러리입니다. 100% 오픈 소스이며, CI/CD에서의 정적 분석(static analysis)과 무결성 검증을 위한 콘텐츠 해싱(content hashing)을 지원합니다. README에 따르면 시중에 있는 마켓플레이스 기술의 13% 이상이 심각한 취약점을 포함하고 있는 반면, 이 리포지토리는 보안이 강화된(hardened) 대안으로 구축되었습니다.

shell npx @tech-leads-club/agent-skills install -s tlc-spec-driven npx @tech-leads-club/agent-skills install -s coding-guidelines docs-writer

기술 설치하기: 세 가지 방법

방법 1: 플러그인 마켓플레이스 (권장)

`shell

사용 가능한 플러그인 탐색

/plugin marketplace

특정 스킬 컬렉션 설치

/plugin marketplace add anthropics/skills

컬렉션 내의 특정 스킬 설치

/plugin install doc-coauthoring@anthropic-agent-skills
`

방법 2: npx skills CLI

`shell

공개된 모든 GitHub 리포지토리(repo)에서 스킬 설치

npx skills add https://github.com/anthropics/skills --skill webapp-testing

약어(shorthand)를 사용하여 설치 (등록된 경우)

npx skills add obra/superpowers --skill tdd
`

방법 3: 수동 복사 (Manual copy)

`shell

개인(전역, global) 설치

cp -r my-skill ~/.claude/skills/

프로젝트 설치 (팀 공유를 위해 git에 포함)

cp -r my-skill .claude/skills/
`

고급: 셸 명령 치환 (Shell Command Substitution)

스킬은 ! command ` 구문을 사용하여 Claude가 프롬프트를 보기 전에 실시간 데이터를 가져올 수 있습니다:

`yaml

name: pr-summary
description: 풀 리퀘스트 (pull request)의 변경 사항 요약
context: fork
agent: Explore

allowed-tools: Bash(gh *)

Pull request 컨텍스트

• PR diff: !gh pr diff
• PR comments: !gh pr view --comments
• 변경된 파일: !gh pr diff --name-only

작업 내용

이 풀 리퀘스트를 평이한 영어로 요약하세요. 무엇이 왜 변경되었는지 강조하세요.
`

이 스킬이 활성화되면, ! ... ` 블록이 먼저 실행되며, 그 출력값이 플레이스홀더(placeholder)를 대체합니다. Claude는 명령 텍스트가 아닌, 실제 PR 데이터가 포함되어 렌더링된 프롬프트를 받게 됩니다.

이 패턴은 실시간 테스트 결과, git 로그 출력, 환경 변수 (environment variables), API 응답, 데이터베이스 스키마 덤프 등 무엇에든 적용할 수 있습니다.

나만의 스킬 만들기: 실용적인 템플릿

---
name: my-skill
description: >
...

좋은 설명을 위한 팁:

• 가장 중요한 트리거 문구를 맨 앞에 배치하세요 — 컨텍스트 압박(context pressure) 상황에서는 설명이 잘릴 수 있습니다.
• 스킬이 '무엇을 하는지'와 '언제 사용해야 하는지'를 모두 포함하세요.
• 의도(

/doctor를 실행하여 스킬 설명이 잘리고 있는지 확인하고, 그에 따라 조정하세요.

스킬 품질 평가 (Evaluating Skill Quality)

skill-creator 스킬 (Anthropic 리포지토리 제공)은 전체 평가 루프 (eval loop)를 제공합니다:

• 트리거되어야 하는 (should-trigger) 프롬프트와 트리거되지 않아야 하는 (should-not-trigger) 테스트 프롬프트를 생성합니다.
• 작성한 설명에 대한 적중률 (hit rate)을 측정합니다.
• 스킬이 잘못된 요청에 실행될 경우 수정을 제안합니다.
• 정성적 피드백 (qualitative feedback)을 기록할 수 있는 HTML 보고서를 엽니다.

전체 평가 형식과 반복 워크플로 (iteration workflow)에 대해서는 agentskills.io를 참조하세요.

빠른 참조: 리소스 요약

리소스	내용	URL
agentskills.io	오픈 SKILL.md 표준	agentskills.io
...

마무리 (Wrap Up)

Claude Code Skills는 투입한 노력이 즉각적인 보상으로 돌아오는 기능 중 하나입니다. 팀의 코드 리뷰 프로세스를 위해 SKILL.md를 작성하는 데 10분만 투자하면, 그 시점부터 프로젝트의 모든 구성원이 일관되고 반복 가능한 동작을 얻게 됩니다. 더 이상 매 세션마다 동일한 프롬프트를 붙여넣을 필요가 없습니다.

공식 Anthropic 리포지토리로 시작하여 패턴을 이해하고, skills.sh나 claude-plugins.dev를 둘러보며 자신의 기술 스택에 맞는 커뮤니티 작업물을 찾아보세요. 그리고 무엇이 가능한지 확인한 후 자신만의 스킬을 구축해 보세요.

생태계는 빠르게 성장하고 있습니다. 오늘 Claude Code에서 작동하는 스킬은 동일한 SKILL.md 형식을 통해 Codex, Gemini CLI, Cursor로 이미 이식(portable)이 가능합니다. 즉, 지금 구축하는 모든 것은 여러분과 함께 이동합니다.

여기에 나열되지 않은 즐겨 찾는 스킬이나 리포지토리가 있나요? 댓글로 남겨주세요.