Claude Code Skills는 지침, 스크립트, 리소스가 담긴 폴더입니다. Claude Code는 작업이 해당 내용과 일치하면 이를 스스로 찾아 활성화하므로, AI 코딩 agent가 세션마다 여러분의 기술 스택, 규칙, 워크플로를 잊지 않게 됩니다. 선호 사항을 한 번 설명하면 Claude가 다시 알려 주지 않아도 매번 적용합니다.
이 가이드에서는 Claude Code Skills가 무엇인지, 사용할 두 가지 유형, 자동 활성화 방식, 저장 위치, 그리고 Skills를 활용해 실제 기능을 제공하는 검증된 워크플로를 설명합니다.
해결하는 문제
AI 코딩 어시스턴트는 대화가 끝나면 모든 것을 잊습니다. 도움이 없으면 새로운 세션을 시작할 때마다 사용 중인 프레임워크, 폴더 구조, 명명 규칙, 리뷰 기준을 다시 설명해야 합니다. Skill은 이러한 지식을 한 번만 저장하므로, Claude Code가 "AI 슬롭"을 만들어 내는 일반적인 패턴으로 돌아가지 않고 여러분의 규칙을 일관되게 따릅니다.
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개의 코딩 에이전트로 구성된 전체 팀을 Claude에 불러와 코드 리뷰, 버그 수정, 문서화, DevOps, 풀스택 구현을 하나의 팩으로 처리하세요.
코딩 에이전트 번들 보기 →Claude Code Skills를 구할 수 있는 곳
직접 작성할 수도 있고, 바로 사용할 수 있는 것을 설치할 수도 있습니다. 검증된 파일로 시작하고 싶다면 Claude Code Skills 컬렉션 또는 더 폭넓은 Tech & Development 라이브러리를 살펴보세요. Skills가 완전히 처음인가요? Claude Skill 설치 방법부터 시작하거나 무료 Skill을 받아 구조를 확인해 보세요.
경로 3: 플러그인
Skills는 Claude Code 플러그인에 포함되어 제공될 수도 있으며, 파일을 옮기는 대신 플러그인 명령으로 설치합니다. 플러그인 Skills는 해당 플러그인별 네임스페이스를 사용하므로 이름이 같은 두 Skills가 충돌하지 않습니다.
설치할 가치가 있는 엔지니어링 Skills 전체 목록
CLI 도구에 유용한 Skills는 실제 엔지니어링 직무명과 연결된 것들입니다. 실제 업무가 그런 방식으로 나뉘기 때문입니다. 다음은 Claude Code를 위해 관리하는 전체 분류이며, 총 14개 역할로 구성됩니다:
- 검토 및 품질: 코드 리뷰어, 코드 감사자, QA 엔지니어.
- 개발: 풀스택 개발자, 백엔드 개발자, 프론트엔드 개발자, WordPress 개발자.
- 인프라: 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은 같은 개념과 같은 파일 형식인 frontmatter가 포함된 Markdown을 따릅니다. 패키징 방식은 다릅니다. 앱은 인터페이스를 통해 ZIP 파일을 받는 반면, Claude Code는 파일 시스템에서 폴더를 읽습니다. 또한 서로 별도로 저장되므로 한쪽에 Skill을 설치해도 다른 쪽에 나타나지 않습니다. 두 곳 모두에서 사용하려면 두 번 설치해야 합니다.
Claude Code는 CLI에만 적용되는 프런트매터 옵션도 지원합니다. 앱용으로 작성된 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 ($29) 또는 바로 사용할 수 있는 Albert - AI Code Review Agent ($32)부터 시작하세요. 연구 → 계획 → 구현 전체 루프를 다루고 싶다면 Coding Agent Bundle ($99)로 코딩 agent 5개를 하나의 팩으로 모두 사용할 수 있습니다. 모두 Claude, ChatGPT 및 모든 AI 채팅에서 코딩 없이 사용할 수 있으며 30일 환불 보장이 제공됩니다.
