Claude Code Skills는 지침, 스크립트, 리소스로 구성된 폴더입니다. 작업이 일치하면 Claude Code가 이를 스스로 찾아 활성화하므로, AI 코딩 agent가 세션 간에 사용자의 기술 스택, 규칙, 워크플로를 잊지 않습니다. 사용자의 선호도를 한 번만 설명하면 Claude가 다시 알려주지 않아도 매번 적용합니다.
이 페이지
이 가이드에서는 Claude Code Skills가 무엇인지, 사용할 두 가지 유형, 자동 활성화 방식, 저장 위치, 그리고 Skills를 사용해 실제 기능을 출시하는 실전 검증 워크플로를 다룹니다.
해결하는 문제
AI 코딩 어시스턴트는 대화가 끝나면 모든 것을 잊습니다. 도움이 없으면 새로운 세션마다 프레임워크, 폴더 구조, 이름 지정 규칙, 검토 표준을 다시 설명해야 합니다. Skill은 이러한 지식을 한 번만 저장하므로, Claude Code가 "AI slop"을 만들어 내는 일반적인 패턴 대신 사용자의 규칙을 일관되게 따릅니다.
Claude Code Skills의 두 가지 유형
- 기능 향상 - 문서 생성, 웹 앱 테스트, 스크래핑처럼 Claude에 없던 새로운 능력을 부여하는 Skill입니다. agent가 할 수 있는 일을 확장합니다.
- 인코딩된 선호도 - Claude가 사용자의 방식으로 작업을 수행하게 만드는 Skill입니다. 프런트엔드 디자인 규칙, React 모범 사례, 팀의 커밋 규칙 등이 해당합니다. 작업이 어떻게 수행되는지를 제한합니다.
대부분의 개발자는 새로운 기능을 위한 몇 가지 기능 Skill과 팀의 스타일을 적용하는 여러 선호도 Skill을 함께 사용하게 됩니다.
위에서 설명한 "검토 표준" 예시를 구체화한 것입니다. Yuri를 추가하면 Claude가 매 세션마다 시니어 리뷰어처럼 모든 diff에서 버그, 보안 허점, 성능 문제를 확인합니다.
Yuri - Code Reviewer AI Skill 보기 →Skill이 활성화되는 방식
Skill을 이름으로 호출할 필요는 없습니다. Claude Code는 대화를 살펴보다가 설명과 일치하는 내용을 설명하면 Skill을 자동으로 활성화합니다. 코드의 취약점 검토를 언급하면 security-review Skill이 자동으로 실행될 수 있고, 컴포넌트를 요청하면 React-standards Skill이 작동합니다. 이 동작을 제어하는 것은 각 Skill의 SKILL.md에 있는 설명이므로, 명확한 설명을 작성하는 것이 무엇보다 중요합니다.
Claude Code Skills가 있는 위치
Skills는 skills 디렉터리에 있으며 시작할 때 로드됩니다.
-
개인:
~/.claude/skills/<name>/- 모든 프로젝트에서 사용할 수 있습니다. -
프로젝트:
.claude/skills/<name>/- 저장소에 커밋되어 전체 팀이 공유합니다.
유효한 항목 확인 SKILL.md 폴더 루트에 위치한 다음 Claude Code를 다시 시작하고 실행합니다. /skills 로드되었는지 확인합니다. 패키지로 제공되는 Skill 설치는 대개 다음과 같습니다. unzip skill.zip -d ~/.claude/skills/.
검증된 워크플로: 조사 → 계획 → 구현
Claude Code로 복잡한 기능을 안정적으로 출시하는 가장 확실한 방법은 사고와 타이핑을 분리하는 것입니다:
-
조사. 먼저 Claude에게 관련 코드를 파악하도록 하세요. 기존 패턴, 종속성, 확장 지점을 짧은
research.md에 정리합니다. 아직 코드는 작성하지 않습니다. - 계획. Claude가 구현 없이 계획을 작성하도록 하세요. 에디터에서 열어 잘못된 부분에 모두 주석을 단 다음, "모든 메모를 반영하되, 아직 구현하지 마세요."라고 다시 보내세요. 모든 결정이 해결될 때까지 반복합니다.
- 구현. 이제야 Claude가 합의된 계획에 따라 코드를 작성하도록 합니다.
"feature-dev" 선호 Skill은 이 루프를 정확하게 인코딩하여 매번 같은 방식으로 실행할 수 있습니다. 이것이 바로 Skills의 핵심입니다. 훌륭한 워크플로를 반복 가능한 형태로 바꾸는 것입니다.
조사 → 계획 → 구현 루프를 처음부터 구축하는 대신, 5개의 코딩 Agents 전체를 Claude에 불러와 코드 리뷰, 버그 수정, 문서화, DevOps, 풀스택 구현을 하나의 번들로 처리하세요.
코딩 에이전트 번들 보기 →Claude Code Skills를 구할 수 있는 곳
직접 만들 수도 있고, 미리 만들어진 것을 설치할 수도 있습니다. 검증된 파일로 시작하고 싶다면 Claude Code Skills 컬렉션 또는 더 폭넓은 테크 및 개발 라이브러리를 살펴보세요. Skills가 처음이라면 Claude Skill 설치 방법에서 시작하거나 무료 Skill을 받아 구조를 확인해 보세요.
경로 3: 플러그인
Skills는 Claude Code 플러그인 내부에 포함할 수도 있으며, 파일을 옮기는 대신 플러그인 명령으로 설치합니다. 플러그인 Skills에는 해당 플러그인의 네임스페이스가 붙으므로, 이름이 같은 두 Skill이 충돌하지 않습니다.
설치할 가치가 있는 엔지니어링 Skills 전체 목록
CLI 도구에 유용한 Skills는 실제 엔지니어링 직무와 연결된 것들입니다. 실제 업무가 그렇게 나뉘기 때문입니다. Claude Code에 대해 관리하는 전체 분류는 다음과 같으며, 총 14개 역할입니다:
- 검토 및 품질: 코드 리뷰어, 코드 감사자, QA 엔지니어.
- 개발: 풀스택 개발자, 백엔드 개발자, 프론트엔드 개발자, 워드프레스 개발자.
- 인프라: DevOps 엔지니어, 클라우드 엔지니어, 데이터베이스 엔지니어.
- 설계 및 방향: 소프트웨어 아키텍트, 테크 리드, 엔지니어링 매니저.
- 보안: 사이버 보안 분석가.
전체 세트는 Claude Code Skill 컬렉션에 있습니다. 아래에서 두 가지를 소개하니, 실제로 설명이 어떻게 보이는지 확인해 보세요.
캐싱, 스테이징 게이트와 롤백 트리거를 갖춘 CI/CD 파이프라인, 멀티 스테이지 Docker 빌드, Kubernetes 매니페스트와 Helm 차트, 원격 상태를 사용하는 Terraform 모듈, 플레이스홀더가 아닌 실제 알림 임계값을 갖춘 모니터링 스택을 제공합니다.
Rami - DevOps Engineer AI Skill 보기 →
한 줄로 결론을 제시한 다음, 정확성, 보안, 성능, 유지 관리성에 걸쳐 심각도 순으로 Critical부터 Medium까지 결과를 정리합니다. 모든 결과에는 이를 유발하는 정확한 입력이나 순서를 명시하고, 수정된 코드 조각을 함께 제공합니다.
Soren - Code Auditor AI Skill 보기 →GitHub 무료와 유료: 실제 차이는 무엇인가요?
둘 다 존재하며, 그렇지 않은 척하는 것은 정직하지 않습니다.
Anthropic은 예시 Skill을 공개적으로 게시하고 있습니다. github.com/anthropics/skills그리고 더 많은 Skill을 모아 둔 커뮤니티 저장소도 있습니다. 비용이 들지 않고 모든 줄을 읽어볼 수 있으며, 일반적인 경우에는 충분히 좋은 출발점입니다. 메커니즘이 한 번 작동하는 모습만 보고 싶다면 여기서 시작하세요.
유료로 얻는 것은 대개 다른 메커니즘이 아니라 깊이와 일관성입니다. 차이는 보통 네 가지 부분에서 드러납니다.
- 트리거의 정확성. 무료 Skill은 대개 자신의 문제를 해결하던 사람이 작성하므로 설명에 작성자의 설정이 전제되어 있습니다. 낯선 사람을 위해 작성한 설명은 더 좁고 명확해야 합니다.
- 완성된 결과물의 예시. 실제 작업 예시를 함께 제공하는 팩은 결제하기 전에 결과물을 보여줍니다. README가 40줄뿐인 저장소는 여러분에게 추측을 요구합니다.
- 범위 관리. 백엔드, 프런트엔드, 인프라, 보안을 하나의 Skill에서 다루면 반쪽짜리 답변 네 개가 나옵니다. 역할별로 나눈 네 개의 Skill은 네 개의 올바른 답변을 제공합니다.
- 유지 관리. 1년 전에 마지막으로 업데이트된 저장소는 여전히 1년 전의 도구와 버전을 참조합니다.
데스크톱 Claude Skill은 Claude Code에서 작동하나요?
대체로 그렇지만, 한 가지 알아둘 점이 있습니다.
Claude 앱에 업로드하는 Skill과 Claude Code가 디스크에서 읽는 Skill은 같은 개념과 같은 파일 형식인 Markdown frontmatter를 따릅니다. 패키징 방식은 다릅니다. 앱은 인터페이스를 통해 ZIP 파일을 받는 반면, Claude Code는 파일 시스템에서 폴더를 읽습니다. 또한 서로 별도로 저장되므로 한쪽에 Skill을 설치해도 다른 쪽에 나타나지 않습니다. 양쪽에서 사용하려면 두 번 설치해야 합니다.
Claude Code는 CLI에만 적용되는 frontmatter 옵션도 지원합니다. 앱용으로 작성된 Skill은 Claude Code에서 작동하지만, CLI 전용 옵션에 의존하는 Skill을 앱에 업로드하면 해당 추가 기능은 사라집니다. 다만 방법 자체는 여전히 적용됩니다. 앱 경로에 대한 단계별 안내는 Claude Skill 설치 방법에 나와 있습니다.
자주 묻는 질문
Claude Code Skill을 수동으로 호출해야 하나요?
아니요. 작업이 설명과 일치하면 Claude Code가 Skill을 자동으로 활성화합니다. 명시적으로 참조할 수도 있지만, 자동 트리거가 가장 큰 장점입니다.
개인 Skill과 프로젝트 Skill의 차이는 무엇인가요?
개인 Skill은 ~/.claude/skills/ 모든 프로젝트에서 사용할 수 있고, 프로젝트 Skill은 .claude/skills/ 저장소에 두면 팀 전체가 동일한 것을 사용할 수 있습니다.
내 Skill이 트리거되지 않는 이유는 무엇인가요?
대개 설명이 너무 모호합니다. Skill을 언제 사용해야 하는지 구체적으로 작성하고, 유효한 SKILL.md 폴더 루트에 있다면 Claude Code를 다시 시작하고 다음을 실행하세요 /skills 로드되었는지 확인하려면
Claude Code Skills는 MCP와 같은 것인가요?
아니요. Skills는 Claude에게 작업 방식을 가르치고, MCP는 Claude를 외부 시스템에 연결합니다. 많은 설정에서 둘 다 사용합니다.
코드 리뷰용 SKILL.md를 직접 작성하고 싶지 않다면 Albert를 사용하세요. Albert는 패키지 형태로 제공되는 구조화된 Senior Code Review Agent로, Claude에 불러와 모든 언어 또는 프레임워크에서 즉시 사용할 수 있습니다.
Albert - AI Code Review Agent 보기 →Skill 하나로 시작하기
워크플로에서 가장 자주 다시 설명하는 부분 - 사용하는 스택, 리뷰 규칙, 커밋 방식 - 을 골라 이를 인코딩하세요. 테스트된 시작점을 보려면 Claude Code Skills 컬렉션을 살펴보거나, 먼저 Claude Skills란 무엇인지 읽어보세요.
요약:
코드를 자주 리뷰한다면 Yuri - Code Reviewer AI Skill ($19) 또는 바로 사용할 수 있는 Albert - AI Code Review Agent ($39)부터 시작하세요. 조사 → 계획 → 구현의 전체 루프를 다루고 싶다면 Coding Agent Bundle ($99)로 코딩 agent 5개를 하나의 번들로 이용할 수 있습니다. 모두 Claude, ChatGPT 및 모든 AI 채팅에서 코딩 없이 사용할 수 있으며 30일 환불 보장이 제공됩니다.