스킬이 뭔지 감은 왔는데 '그래서 실제로 하나 만들어 쓰면 어떤 느낌이냐'가 궁금하다면, 이 글이 그 예시다. 개발할 때 매번 귀찮은 커밋 메시지 작성을 AI에게 규칙대로 맡기는 완성형 스킬 하나를 통째로 준다.

이 스킬이 하는 일

설치해 두면, 커밋할 때 AI가 스테이징된 변경(git diff --staged)을 읽고 Conventional Commits 형식으로 메시지를 써 준다. 'feat / fix / docs …' 같은 타입을 알아서 붙이고, 제목은 짧게, 본문은 '무엇을·왜'로 정리해 준다.

SKILL.md 전문 (복붙용)

아래 내용을 그대로 쓰면 된다. 하단 첨부파일로도 받을 수 있다.

---
name: commit-message
description: git 커밋 메시지를 Conventional Commits 형식으로 작성한다. 사용자가 "커밋 메시지 써줘", "이 변경 커밋해줘"라고 하거나 스테이징된 변경을 커밋하려 할 때 사용한다.
---

# 목적
스테이징된 변경(diff)을 읽고, 팀이 읽기 좋은 커밋 메시지를 Conventional Commits 규칙으로 작성한다.

# 작업 순서
1. git diff --staged 로 스테이징된 변경을 확인한다. 없으면 사용자에게 알린다.
2. 변경 성격으로 type을 고른다: feat / fix / docs / refactor / test / chore / perf / style.
3. 아래 형식으로 작성한다.

# 형식
<type>(<scope>): <제목 — 50자 이내, 명령형, 마침표 없음>

<본문 — 무엇을·왜 바꿨는지. 72자에서 줄바꿈>

# 규칙
- 저장소의 기존 커밋 스타일(한국어/영어)을 따른다.
- 성격이 여럿 섞였으면 커밋을 나눌 것을 제안한다.
- 의도가 불확실하면 단정하지 말고 확인한다.

# 예시
feat(auth): 로그인 API에 요청 속도 제한 추가

무차별 대입 로그인 시도를 막기 위해 IP당 분당 10회로 제한한다.
초과 시 429를 반환한다.

설치 방법

Claude Code 기준, 프로젝트 폴더에 아래 경로로 파일을 저장하면 끝이다.

.claude/skills/commit-message/SKILL.md

모든 프로젝트에서 쓰고 싶으면 ~/.claude/skills/commit-message/SKILL.md에 둔다. 그다음부터 '커밋 메시지 써줘' 하면 이 규칙대로 나온다.

응용

이 파일을 뼈대로 삼아 여러분 팀 규칙(예: 이슈 번호 붙이기, 한국어 고정)을 규칙 항목에 추가하면, 팀 전용 커밋 스킬이 된다. 스킬을 어떻게 만드는지 더 알고 싶으면 이 게시판의 'Claude 스킬 완전정복' 글을 참고하자.

다운로드

하단 첨부파일(SKILL.md)을 받아 위 경로에 그대로 저장하면 바로 동작한다.