Claude Code의 잘 알려지지 않은 Skills 시스템 — SKILL.md 파일 활용법
Claude Code has a Skills system most people don't know about — here's how SKILL.md files work
핵심 요약
Claude Code에서 반복적인 작업을 자동화하는 SKILL.md 파일의 기능과 활용법을 소개합니다.
- Skills 시스템 — 특정 명령어나 상황에 따라 자동으로 활성화되는 커스텀 동작 설정
- SKILL.md 파일 — 특정 경로에 파일을 생성하여 별도 설정 없이 즉시 적용 가능
- 셸 컨텍스트 활용 — !command 구문을 통해 셸 명령 결과를 Claude에게 직접 전달
- 워크플로우 자동화 — PR 작성, 커밋 메시지, 보안 감사 등 반복 작업 효율화
Claude Code를 사용 중이라면, 사용자의 말에 따라 자동으로 활성화되는 커스텀 동작을 추가할 수 있는 Skills라는 기능이 있습니다.
개념
스킬은 ~/.claude/skills/<skill-name>/SKILL.md 경로에 넣는 SKILL.md 파일입니다. Claude Code가 이를 자동으로 인식하므로 재시작이나 별도의 설정이 필요 없습니다.
활성화 방법
파일의 frontmatter에 description 필드가 있습니다. Claude가 이를 읽고 요청 내용과 일치하면 스킬을 트리거합니다. 예를 들어 설명에 "PR 설명 작성 시 사용"이라고 적혀 있다면, "내 PR 작성해줘"라고 말할 때 자동으로 로드됩니다.
/skill-name을 통해 수동으로 트리거할 수도 있습니다.
내용 구성
본문은 마크다운 형식으로 단계, 지침, 출력 형식, 규칙 등을 작성합니다. !command 구문을 사용하여 실시간 셸 컨텍스트를 주입할 수 있습니다. 이 구문은 명령을 실행하고 Claude가 응답하기 전에 그 결과를 Claude에게 전달합니다.
예시:
---
description: Audits code for OWASP Top 10 security issues.
allowed-tools: Read, Grep, Glob
---
## Security Scanner
Read the files the user mentions. Check for SQL injection, hardcoded secrets, missing auth...
유용한 이유
매번 똑같은 긴 프롬프트를 붙여넣는 대신, 한 번 설치해두면 바로 사용할 수 있습니다. PR 설명, 커밋 메시지, 보안 감사, 코드 리뷰 체크리스트 등 반복적인 작업에 매우 효과적입니다.
이 형식은 Agent Skills 오픈 표준을 따르므로 Claude Code뿐만 아니라 다른 런타임에서도 스킬이 작동합니다.
혹시 커스텀 스킬을 만들고 계신 분 있나요? 다들 어떤 워크플로우를 자동화하고 있는지 궁금하네요.
