스킬

Claude에게 팀의 코딩 표준을 설명할 때마다, 여러분은 같은 말을 반복하고 있는 것입니다. PR 리뷰를 할 때마다 피드백을 어떻게 구성하고 싶은지 다시 설명합니다. 커밋 메시지를 작성할 때마다 Claude에게 선호하는 형식을 다시 알려줍니다. 스킬은 이 문제를 해결합니다.

스킬은 Claude에게 무언가를 하는 방법을 한 번 가르치는 마크다운 파일이며, Claude는 관련이 있을 때마다 그 지식을 자동으로 적용합니다. Claude 스킬은 에이전트가 더 정확하고 효율적으로 작업을 수행하기 위해 발견하고 사용할 수 있는 지침, 스크립트, 리소스 폴더입니다.

Claude Code에는 SKILL.md 파일이 있습니다. 설명(description)은 Claude가 스킬을 사용할지 여부를 결정하는 방법입니다. 이 PR을 리뷰해 달라고 Claude에게 요청하면, Claude는 여러분의 요청을 사용 가능한 스킬 설명과 대조하여 이 스킬을 찾아냅니다. Claude는 여러분의 요청을 읽고, 이를 사용 가능한 모든 스킬 설명과 비교한 다음, 일치하는 것들을 활성화합니다.

스킬은 누가 필요로 하는지에 따라 몇 군데에 저장할 수 있습니다. 개인 스킬은 홈 디렉터리의 .claude/skills에 저장되며, 모든 프로젝트에서 여러분을 따라다닙니다. 이는 여러분의 선호 사항, 커밋 메시지 스타일, 문서 형식, 코드 설명을 원하는 방식 등입니다. 프로젝트 스킬은 저장소 루트 디렉터리 안의 .claude/skills에 저장됩니다. 저장소를 클론하는 사람은 이러한 스킬을 자동으로 얻게 됩니다. 이곳은 회사의 브랜드 가이드라인, 웹 디자인에 사용하는 선호 글꼴과 색상 같은 팀 표준이 있는 곳입니다.

Claude Code에는 동작을 커스터마이즈하는 여러 방법이 있습니다. 스킬은 자동으로 적용되고 작업에 특화되어 있다는 점에서 독특합니다. CLAUDE.md 파일은 모든 대화에 로드됩니다. Claude가 항상 TypeScript strict 모드를 사용하기를 원한다면, 그것은 CLAUDE.md 파일에 들어갑니다. 반면 스킬은 여러분의 요청과 일치할 때 필요에 따라 로드됩니다. 이름과 설명만 로드되므로 컨텍스트 윈도우 전체를 채우지 않습니다. 디버깅을 하고 있을 때는 PR 리뷰 체크리스트가 컨텍스트에 있을 필요가 없습니다. 실제로 리뷰를 요청할 때 로드됩니다.

슬래시 명령어는 직접 입력해야 하지만, 스킬은 그렇지 않습니다. Claude는 상황을 인식하면 스킬을 적용합니다. 이는 특정 작업에 적용되는 전문 지식에 가장 적합합니다. 팀이 따르는 코드 리뷰 표준, 선호하는 커밋 메시지 형식, 조직의 브랜드 가이드라인 등이 그 예입니다. Claude에게 같은 것을 반복해서 설명하고 있다는 것을 깨닫는다면, 그것이 바로 작성해야 할 스킬입니다.