Skill 고급 자동화 패턴

이 페이지를 보기 전에

Skill 기본과 Skill 중급을 먼저 읽었다는 전제로 작성되었습니다.
Reference/Task 스킬의 차이, SKILL.md 구조, 폴더 설계를 이해하고 있어야 합니다.

비개발자라면? 이것만 기억하세요

이 페이지의 코드 예시는 Claude에게 "이렇게 만들어줘"라고 보여주는 템플릿입니다. 직접 코드를 쓸 필요가 없습니다.

"동적 컨텍스트를 활용해서, /review를 실행하면 현재 브랜치 변경사항을 자동으로 읽어서 코드 리뷰해주는 스킬을 만들어줘"

Claude가 이 페이지에 나오는 고급 기법들을 자동으로 적용해서 만들어 줍니다.

STEP 1

동적 컨텍스트 주입

스킬 실행 시 "지금 상황"을 자동으로 읽어와서 Claude에게 알려줍니다

이게 뭔가요?

SKILL.md 안에 ! 명령어를 넣으면, 스킬 실행할 때 그 순간의 실시간 정보를 Claude에게 전달합니다.

비유: 요리 레시피에 "지금 냉장고에 뭐가 있는지 확인해"가 자동으로 실행되는 것.

SKILL.md에 ! 명령어 추가하기

!로 시작하는 줄은 스킬 실행 시 셸 명령어로 실행되고, 그 결과가 Claude에게 전달됩니다.

동적 컨텍스트 예시 SKILL.md

--- name: 스마트 코드 리뷰 description: 현재 브랜치 변경사항을 자동 분석하고 리뷰합니다 command: /review --- # 스마트 코드 리뷰 현재 프로젝트 상태: !git diff --stat ← 변경된 파일 목록을 자동으로 가져옴 !git log --oneline -5 ← 최근 5개 커밋을 자동으로 가져옴 프로젝트 설정: !cat package.json ← package.json 내용을 자동으로 읽어옴 ## Instructions 위 정보를 바탕으로 코드 리뷰를 진행하세요: 1. 변경된 파일 각각에 대해 리뷰 2. 버그 가능성, 성능 이슈, 보안 문제 체크 3. 개선 제안을 구체적으로 제시

자주 쓰는 동적 명령어 익히기

아래 명령어들을 SKILL.md에 넣으면 매번 수동으로 정보를 붙여넣을 필요가 없습니다.

작동 원리

!로 시작하는 줄 = 셸 명령어
스킬 실행 시 결과가 자동 주입
매번 복붙 불필요

자주 쓰는 명령어

!git status 현재 변경사항
!cat 파일명 파일 내용 읽기
!ls src/ 폴더 구조 파악

주의사항

! 명령어는 실제 터미널 명령을 실행합니다. rm이나 delete 같은 위험한 명령은 절대 넣지 마세요.

STEP 1 완료 체크

! 명령어가 셸 명령을 실행한다는 것을 이해했다

git diff, git log, cat 등 자주 쓰는 명령을 알았다

위험한 명령(rm, delete)을 넣으면 안 된다는 것을 이해했다

완료: 0 / 3

완료! 다음 스텝으로 이동하세요

STEP 2

변수 치환 $ARGUMENTS와 친구들

스킬에 넘기는 정보를 변수로 받아서 유연하게 사용합니다

변수 치환이 뭔가요?

/report 2월 3주차라고 치면, "2월 3주차"가 자동으로 스킬 안의 $ARGUMENTS 위치에 들어갑니다.

비유: 편지 양식에서 "○○○님께"의 빈칸이 자동으로 채워지는 것.

사용 가능한 변수 목록 파악하기

아래 변수들은 스킬 실행 시 자동으로 값이 채워집니다.

변수	자동으로 들어가는 값	예시
`$ARGUMENTS`	사용자가 명령어 뒤에 입력한 텍스트 전체	/review src/App.tsx
`$GIT_BRANCH`	현재 Git 브랜치 이름	feature/login-page
`$GIT_REMOTE_URL`	원격 저장소 URL	github.com/my-team/project
`$DATE`	오늘 날짜	2026-02-25
`$CWD`	현재 작업 디렉토리 경로	/Users/me/my-project

변수를 활용한 실전 스킬 만들기

동적 컨텍스트(!)와 변수($)를 조합하면 강력한 자동화 스킬을 만들 수 있습니다.

변수 치환 활용 SKILL.md

--- name: 커밋 메시지 생성기 description: 변경사항을 분석해서 커밋 메시지를 자동 생성합니다 command: /commit-msg --- # 커밋 메시지 생성기 현재 브랜치: $GIT_BRANCH 날짜: $DATE 추가 요청사항: $ARGUMENTS 변경 내역: !git diff --cached --stat ## Instructions 1. 위 변경 내역을 분석합니다 2. 컨벤셔널 커밋 형식으로 메시지를 작성합니다 - feat: 새 기능 / fix: 버그 수정 / refactor: 리팩터링 3. 한국어로 작성하되, 커밋 타입은 영어로 유지합니다 4. 사용자의 추가 요청사항이 있으면 반영합니다

사용 방법

/commit-msg → 기본 커밋 메시지 생성
/commit-msg 긴급 핫픽스임을 강조해줘 → $ARGUMENTS에 추가 요청이 들어감

STEP 2 완료 체크

$ARGUMENTS, $GIT_BRANCH 등 주요 변수를 이해했다

변수($ )와 동적 컨텍스트(!)의 차이를 이해했다

커밋 메시지 생성기 예시 코드를 이해했다

완료: 0 / 3

완료! 다음 스텝으로 이동하세요

STEP 3

context:fork 독립 실행 모드

스킬을 별도 공간에서 실행해서, 기존 대화를 방해하지 않습니다

context:fork가 뭔가요?

보통 스킬은 현재 대화 안에서 실행됩니다. 그런데 context: fork를 쓰면 별도의 새 대화에서 실행됩니다.

비유: 사무실에서 일하는 중에 회의실에서 따로 미팅하고, 결과만 가져오는 것.

SKILL.md 프론트매터에 context: fork 추가

이 한 줄만 추가하면 스킬이 별도 공간에서 실행됩니다.

context:fork 사용 예시

--- name: 백그라운드 분석기 description: 코드 품질 분석을 별도 프로세스에서 실행합니다 command: /analyze context: fork ← 별도 공간에서 실행! --- # 코드 품질 분석기 ## Instructions 1. 전체 소스 코드를 스캔합니다 2. 코딩 컨벤션 위반 사항을 찾습니다 3. 성능 개선 포인트를 식별합니다 4. 분석 결과를 reports/analysis.md에 저장합니다

fork 사용 시 주의점 확인하기

fork 모드의 특성과 한계를 이해해야 올바르게 사용할 수 있습니다.

언제 쓰나요?

시간이 오래 걸리는 작업 (전체 코드 분석)
현재 대화 맥락을 유지하고 싶을 때
여러 스킬을 동시에 실행하고 싶을 때

주의할 점

fork된 스킬은 현재 대화 내용을 알 수 없음
결과는 파일로 저장해야 다시 볼 수 있음
복잡한 상호작용이 필요한 작업에는 부적합

STEP 3 완료 체크

context: fork가 별도 대화에서 실행된다는 것을 이해했다

fork된 스킬은 결과를 파일로 저장해야 한다는 것을 이해했다

완료: 0 / 2

완료! 다음 스텝으로 이동하세요

STEP 4

allowed-tools Claude가 쓸 수 있는 도구 제한

보안과 안전을 위해, 스킬이 할 수 있는 행동 범위를 제한합니다

왜 제한이 필요한가요?

스킬이 실수로 중요한 파일을 삭제하거나 시스템을 변경하는 것을 방지합니다.

비유: 신입 직원에게 "이 서류만 작성하세요. 다른 서류함은 열지 마세요"라고 하는 것.

프론트매터에 allowed-tools 추가하기

허용할 도구 목록을 지정하면, 나머지는 자동으로 차단됩니다.

allowed-tools 설정 예시

--- name: 안전한 보고서 생성기 command: /safe-report allowed-tools: - Read ← 파일 읽기만 허용 - Write ← 파일 쓰기 허용 - Bash(git log*) ← git log 명령만 허용 (다른 Bash 명령은 불가) --- # 이 스킬은 위 3가지 도구만 사용할 수 있습니다 # 파일 삭제, 시스템 명령, 네트워크 접근 등은 차단됩니다

주요 도구 목록과 제한 패턴 이해하기

어떤 도구를 열어줄지, 어떻게 제한할지 결정합니다.

도구	할 수 있는 일	제한 패턴 예시
`Read`	파일 읽기	-
`Write`	파일 쓰기/생성	-
`Edit`	파일 수정	-
`Bash`	터미널 명령 실행	`Bash(git*)` → git 관련 명령만
`Glob`	파일 검색	-
`Grep`	텍스트 검색	-

TIP

보고서 생성 스킬은 Read + Write만 허용하면 충분합니다. Bash까지 열어주면 예상치 못한 명령이 실행될 수 있으니, 필요한 만큼만 열어주세요.

STEP 4 완료 체크

allowed-tools로 스킬의 도구 사용을 제한할 수 있다는 것을 이해했다

Bash(git*) 같은 패턴으로 세부 제한이 가능하다는 것을 이해했다

불필요한 도구를 열어주면 위험할 수 있다는 것을 이해했다

완료: 0 / 3

완료! 다음 스텝으로 이동하세요

STEP 5

CI/CD 파이프라인 연동

스킬을 자동화 파이프라인에 연결하면, 코드 변경 시 자동으로 실행됩니다

CI/CD가 뭔가요?

CI(Continuous Integration, 지속적 통합) / CD(Continuous Delivery·Deployment, 지속적 제공·배포)의 약자로, 코드를 올리면(push) 자동으로 테스트하고 배포하는 시스템입니다.

비유: 편의점에 물건을 발주하면, 자동으로 검수 → 진열 → 가격표 부착이 실행되는 것.

GitHub Actions 워크플로우 파일 작성하기

.github/workflows/ 폴더에 YAML 파일을 만들면 자동으로 실행됩니다.

.github/workflows/skill-review.yml

name: Auto Code Review on: pull_request: ← PR이 생성될 때마다 실행 types: [opened, synchronize] jobs: review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Claude Code 리뷰 실행 run: | npx @anthropic-ai/claude-code \ --skill /review \ --output reports/review.md env: ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

주요 활용 시나리오 파악하기

CI/CD와 스킬을 연동하면 다양한 자동화가 가능합니다.

PR 자동 리뷰

PR 생성 시 코드 리뷰 스킬이 자동 실행됩니다.

자동 문서 생성

코드 변경 시 API 문서를 자동으로 업데이트합니다.

릴리즈 노트

배포 시 변경사항을 요약한 릴리즈 노트를 자동 생성합니다.

필수 설정

GitHub Actions에서 사용하려면 ANTHROPIC_API_KEY를 리포지토리 Secrets에 등록해야 합니다. Settings → Secrets and variables → Actions에서 설정하세요.

STEP 5 완료 체크

GitHub Actions에서 스킬을 자동 실행할 수 있다는 것을 이해했다

ANTHROPIC_API_KEY를 Secrets에 등록해야 한다는 것을 이해했다

완료: 0 / 2

완료! 다음 스텝으로 이동하세요

STEP 6 FINAL

성능 최적화 빠르고 정확한 스킬 만들기

스킬이 느리거나 결과가 부정확할 때 적용하는 최적화 기법

컨텍스트를 최소화하세요

SKILL.md가 길수록 Claude가 처리할 정보가 많아져 느려집니다. 꼭 필요한 정보만 넣으세요.
!cat package.json 대신 !cat package.json | head -20처럼 필요한 부분만 가져오세요.

Instructions를 명확하게 쓰세요

모호한 지시 → Claude가 여러 번 시도 → 느려짐. "A를 하고, B를 하고, C를 출력해"처럼 단계별로 구체적으로.

allowed-tools를 제한하세요

사용할 도구를 지정하면 Claude가 불필요한 탐색을 하지 않아 더 빨리 실행됩니다.

복잡한 스킬은 분리하세요

하나의 스킬이 너무 많은 일을 하면 정확도가 떨어집니다. 기능별로 스킬을 나누고, 필요하면 순차적으로 실행하세요.

Examples를 3개 이상 넣으세요

좋은 예시가 많을수록 Claude가 정확하게 이해합니다. 특히 경계 케이스(예외 상황)를 넣으면 결과물 품질이 크게 올라갑니다.

STEP 6 최종 성능 체크리스트

SKILL.md가 200줄 이하인가?

동적 컨텍스트(!)가 3개 이하인가?

allowed-tools가 설정되어 있나?

Instructions가 5단계 이내인가?

Examples가 3개 이상인가?

완료: 0 / 5

축하합니다! 고급 스킬을 모두 마스터했습니다!

고급 스킬 마스터 진행률

Skill 시리즈 전체 보기

🌱 Skill 기본 Claude.ai 스킬 입문 기본 ⚡ Skill 중급 실전 스킬 만들기 중급 🔗 Claude Code Skill 공식 문서 한국어 가이드

Skill 마스터! 다음은?

스킬의 기본부터 고급 자동화까지 모두 배웠습니다.
이제 멀티 에이전트와 전체 워크플로우 자동화를 살펴보세요.

자동화 실전 최종 코스 →