반복 프롬프트를 자동 호출로 | Skill 만들기

Overview

코드 변경을 마칠 때마다 상태를 확인하고 Conventional Commit 메시지를 정하는 절차를 다시 설명하고 있다면, 그 절차는 Skill로 분리할 수 있습니다.

앞 Lesson에서 Skill의 구조와 자동 선택 원리를 살펴봤습니다. 이번에는 반복하던 절차와 호출 조건을 Skill Creator에 설명해 commit Skill을 만들고, 생성된 파일이 의도대로 동작하는지 직접 확인합니다.

학습 목표

• 반복 작업의 절차와 호출 조건을 Skill 요구사항으로 정리합니다.
• Skill Creator로 프로젝트 Skill을 만들고 생성된 SKILL.md를 검토합니다.
• 긍정·부정 요청으로 새 Skill의 자동 호출 범위를 확인합니다.

시작하기 전 확인사항

실습 프로젝트의 시작 브랜치로 전환합니다.

git fetch origin
git checkout ch06-03

ch06-03에는 앞 Lesson에서 만든 Rules가 있고, 아직 commit Skill은 없습니다.

Skill Creator 준비하기

Skill Creator는 새 Skill을 만들고 기존 Skill을 검토·개선하는 Anthropic 공식 Plugin입니다. 이번 Lesson에서는 새 Skill을 만드는 기능만 사용합니다. 여러 테스트로 Skill의 수정 전후를 비교하는 방법은 참고 자료 · Skill 개선과 Eval에서 다룹니다.

공식 마켓플레이스의 skill-creator를 설치합니다.

/plugin install skill-creator@claude-plugins-official

설치한 Skill이 현재 세션에 보이지 않으면 /reload-plugins를 실행해 Plugin을 다시 불러옵니다.

/plugin marketplace add anthropics/claude-plugins-official

[미션] Skill Creator로 commit Skill 만들기

Step 1: 반복하던 커밋 절차 정리하기

Skill Creator를 호출하기 전에 무엇을 반복하고, 언제 이 절차가 필요한지 정리합니다.

1. 변경된 파일과 diff를 확인합니다.
2. 이번 작업과 관련된 파일만 스테이징합니다.
3. 저장소의 최근 커밋 형식에 맞춰 Conventional Commit 메시지를 작성합니다.
4. 커밋한 뒤 결과를 확인합니다.

이 절차는 어떤 파일을 수정했는지와 관계없이 커밋 요청에서 반복됩니다. 파일 경로에 따라 켜지는 Rules보다 작업 종류에 따라 선택되는 Skill에 적합합니다.

호출 조건도 함께 정합니다.

• 사용할 때: 코드 변경 후 커밋이나 변경사항 정리를 요청할 때
• 사용하지 않을 때: 단순히 Git 명령어의 의미나 사용법을 물을 때

Step 2: 자연어로 Skill 생성 요청하기

설치된 Skill Creator는 Skill을 만들어 달라는 요청을 보고 자동으로 선택됩니다. 별도 명령어를 먼저 입력하지 않고 다음과 같이 요청합니다.

다음 절차를 이 프로젝트에서 사용하는 commit Skill로 만들어줘.

- 변경된 파일과 diff를 확인한다.
- 이번 작업과 관련된 파일만 스테이징한다.
- 저장소의 최근 커밋 형식에 맞춰 Conventional Commit 메시지를 작성한다.
- 커밋한 뒤 결과를 확인한다.
- 코드 변경 후 커밋이나 변경사항 정리를 요청할 때 사용한다.
- 단순 Git 명령어 질문에는 사용하지 않는다.
- .claude/skills/commit/SKILL.md에 만든다.

Skill Creator가 추가로 묻는 내용이 있으면 답해 호출 조건과 절차를 구체화합니다. 생성이 끝나면 .claude/skills/commit/SKILL.md가 생겼는지 확인합니다.

Skill Creator가 자동으로 선택되지 않으면 /skill-creator:skill-creator로 직접 호출해 설치와 로드 상태를 확인합니다.

Step 3: 생성된 SKILL.md 검토하기

Skill Creator가 만든 결과는 다음 위치에 있습니다.

앞 Lesson에서 배운 구조와 연결해 세 가지를 확인합니다.

• name이 commit Skill을 식별할 수 있게 작성됐는가?
• description이 커밋 요청과 단순 Git 질문을 구분하는가?
• 본문에 실행 순서와 커밋 후 확인 절차가 들어 있는가?

Skill Creator가 파일을 만들어도 어떤 요청에서 실행할지와 무엇을 완료로 볼지는 사용자가 검토해야 합니다. 빠진 내용이 있다면 같은 대화에서 수정해 달라고 요청한 뒤 diff를 확인합니다.

Step 4: 자연어 자동 호출 확인하기

Claude Code는 기존 .claude/skills/ 아래에서 Skill이 추가되거나 바뀌면 현재 세션에 반영합니다. 이번 실습에서 .claude/skills/ 폴더 자체가 처음 생겼다면 새 폴더를 인식하도록 Claude Code를 다시 시작합니다.

먼저 commit Skill이 필요한 요청을 보냅니다.

변경사항을 정리해서 커밋해줘.

Claude가 commit Skill을 불러오고, Skill 본문에 적힌 순서로 변경을 확인한 뒤 커밋하는지 봅니다. 실행 전에 스테이징 대상이 이번 Lesson에서 만든 파일과 일치하는지 확인합니다.

다음에는 commit Skill이 필요하지 않은 질문을 보냅니다.

git rebase가 뭐야?

첫 요청에는 commit Skill이 선택되고 두 번째 질문에는 선택되지 않아야 합니다. 결과가 다르면 description의 긍정·부정 조건을 고친 뒤 두 요청을 다시 확인합니다.

핵심 포인트 정리

1. 요구사항 먼저 정하기: Skill Creator를 호출하기 전에 반복할 절차, 사용할 때와 사용하지 않을 때를 정합니다.
2. 생성 결과 검토하기: Skill Creator가 만든 SKILL.md의 description, 실행 순서와 완료 조건을 직접 확인합니다.
3. 자동 호출 범위 확인하기: 긍정·부정 요청을 각각 보내 필요한 상황에서만 Skill이 선택되는지 확인합니다.

FAQ

이어서 배울 내용

Skill Creator로 프로젝트에 필요한 commit Skill을 만들고 자동 호출 범위를 확인했습니다. 다음 Lesson에서는 모든 Skill을 직접 만들지 않고, Plugin과 skills.sh에서 범용 Skill을 가져와 사용합니다.

• Plugin으로 Skill 번들 설치하기
• skills.sh에서 개별 Skill 설치하기
• 직접 만들 때와 가져다 쓸 때 구분하기