클로드 스킬이란? 구성과 사용 방법 알아보기

새 대화에서 보고서를 부탁할 때마다 양식부터 설명하고 있나요? 대화 기록이 남아 있어도 새 작업에 그 지시가 자동으로 적용되는 것은 아니에요. 이럴 때 자주 쓰는 지시를 스킬로 정리하면 편해요.

프롬프트는 지금 할 일을 전달하고, 스킬은 여러 작업에서 재사용할 방법을 담아요. 팀이 같은 스킬 파일을 공유하면 각자 설명을 새로 작성하는 수고도 줄일 수 있어요.

Claude Code는 스킬의 이름과 설명을 보고 요청에 맞는 스킬을 고를 수 있어요. 직접 이름을 지정해 호출할 수도 있고요. 스킬을 수정한 뒤에는 새 지침이 실제 작업에 적용됐는지 확인해 주세요.

MCP는 AI가 외부 도구나 자료와 연결되는 방식을 정한 규약이에요. 데이터베이스에서 값을 읽거나 업무 관리 서비스에 할 일을 등록하는 도구를 제공할 수 있어요.

스킬에는 그 도구로 무엇을 할지 적어요. 예를 들어 MCP로 디자인 자료를 가져온 뒤, 스킬에 적힌 색상·글자 크기·검토 순서에 맞춰 화면을 만들 수 있어요. 연결과 작업 절차가 모두 필요한 일에서는 둘을 함께 써요.

기본은 SKILL.md 파일 하나예요. 맨 위에는 이름과 사용 상황을 적고, 본문에는 작업 순서와 확인할 내용을 써요.

설명이 길어지면 참고 자료를 별도 파일로 나누고 SKILL.md에서 연결해 주세요. 예시, 결과물 템플릿, 반복 실행할 코드도 같은 폴더에 넣을 수 있어요.

Claude Code는 스킬의 이름과 설명을 먼저 확인하고, 필요한 스킬을 사용할 때 본문을 읽어요. 참고 파일까지 전부 한꺼번에 읽는 구조는 아니에요. 다만 스킬이 늘면 설명 목록도 길어지므로 설치 개수가 전혀 부담을 주지 않는다고 볼 수는 없어요.

스킬이 자동으로 선택되지 않으면 description부터 살펴보세요. “문서 작업을 돕는다”보다 “회의록에서 결정 사항과 담당자별 할 일을 정리할 때 사용한다”처럼 요청 상황을 구체적으로 적으면 좋아요.

같은 작업을 하며 비슷한 설명을 반복했다면 스킬로 정리해 볼 만해요. 주간 보고서 양식, 코드 리뷰 순서, 브랜드 표현 규칙처럼 다시 쓸 기준이 있는 일이 잘 맞아요.

일회성 요청은 대화만으로도 충분해요. 작업 방식이 아직 정해지지 않았다면 몇 번 해 보며 기준부터 찾아보세요. 창의적인 일도 자료 조사나 검토처럼 반복되는 부분은 스킬로 만들 수 있어요.

Agent Skills 형식을 지원하는 도구에서는 SKILL.md와 참고 자료를 재사용할 수 있어요. 다만 설치 위치, 지원하는 설정, 실행 도구가 달라서 옮긴 뒤 확인이 필요해요.

Claude Code는 .claude/skills, Codex는 .agents/skills를 사용해요. Cursor는 .agents/skills와 .cursor/skills 등을 지원하고, Gemini CLI도 Agent Skills를 지원해요. 아래 공식 문서에서 사용 중인 도구의 경로를 확인해 주세요.

문서 지침은 옮기기 쉽지만 특정 명령어나 외부 서비스에 의존하는 스킬은 수정이 필요할 수 있어요. 같은 입력으로 한 번 실행해 결과와 필요한 권한을 확인해 보세요.

공개된 스킬을 열어 보면 설명과 참고 자료를 어떻게 나눴는지 배울 수 있어요. 내 업무와 가까운 스킬 하나를 골라 사용 조건과 포함 파일부터 읽어 보세요.

스킬샵에서도 분야별 스킬을 찾아볼 수 있어요. 가격이나 인기만 보기보다는 내가 쓰는 도구를 지원하는지, 어떤 입력과 결과물을 다루는지 확인하면 고르기 쉬워요.