Skills 셋업과 기본 조작

직접 만들어 봅니다. 예제는 "회의록을 표준 형식으로 정리하는 Skill"입니다.

1. 폴더 만들기

mkdir -p .claude/skills/meeting-notes

개인용으로 쓰려면 ~/.claude/skills/ 아래에 두세요. 팀 공유는 프로젝트 안에 두고 커밋합니다.

2. SKILL.md 작성

---
name: meeting-notes
description: 회의 녹취나 메모를 사내 표준 회의록 형식으로 정리한다.
  "회의록 정리", "미팅 노트 만들어줘", "회의 요약" 요청 시 사용한다.
---

## 절차

1. 입력된 원문을 읽는다
2. 다음 형식으로 정리한다

### 출력 형식

**일시 / 참석자**

**논의 사항**
- 항목별로 한 줄씩

**결정 사항**
- 결정된 것만. 논의 중인 건 여기 넣지 않는다.

**액션 아이템**
| 담당 | 내용 | 기한 |

**보류 / 다음 회의 안건**

## 규칙

- 원문에 없는 내용을 추측해 채우지 마라
- 담당자가 불명확하면 "미정"으로 표기하라
- 기한이 언급되지 않았으면 "미정"으로 두고 별도로 알려라
- 개인에 대한 평가성 발언은 회의록에 옮기지 마라

3. 동작 확인

새 세션을 열고 자연스럽게 요청합니다.

어제 회의 메모인데 회의록으로 정리해줘.

[메모 붙여넣기]

Skill이 불리면 정의한 형식대로 나옵니다. 불리지 않는다면 description이 모호한 것입니다.

4. 개선하기

첫 버전은 대체로 부족합니다. 실제로 써 보면서 다음을 반복하세요.

• 결과가 어긋난 지점 → 규칙에 추가
• 매번 손으로 고치는 부분 → 형식에 명시
• 안 쓰는 항목 → 삭제

같은 수정을 세 번 했다면 그건 Skill에 들어가야 합니다.

5. 스크립트 붙이기

기계적인 변환이 있다면 스크립트로 분리하세요.

.claude/skills/meeting-notes/
  SKILL.md
  scripts/to-confluence.sh

본문에 이렇게 적습니다.

3. 정리가 끝나면 scripts/to-confluence.sh 를 실행해 업로드한다

6. 팀에 배포

git add .claude/skills/
git commit -m "회의록 정리 Skill 추가"

팀원이 git pull 하면 즉시 사용할 수 있습니다. 별도 설치나 설정이 없습니다.

운영 요령

• README에 목록을 남기세요 — 팀원이 어떤 Skill이 있는지 알아야 씁니다
• 소유자를 정하세요 — 관리자 없는 Skill은 금방 낡습니다
• 분기마다 점검하세요 — 안 쓰이는 건 지우는 게 낫습니다

다음 레슨

하네스 엔지니어링 기초