Claude Code 스킬

세션 끝날 때 /wrapup
한 줄이면 오늘 한 일이 정리된다

작업을 마치고 /wrapup을 치면 Claude가 오늘 바뀐 파일과 커밋을 스스로 훑어서 완료 항목, 파일 목록, 다음에 할 일, 확정된 규칙을 session_log.md에 기록합니다. 다음 세션에서 "내가 어디까지 했더라"를 다시 설명할 필요가 없어집니다.

설치는 3단계, 2분이면 끝납니다

  1. Claude Code를 켭니다 아무 폴더에서나 상관없습니다. 개인 스킬이라 모든 프로젝트에서 쓰입니다.
  2. 아래 상자의 내용을 통째로 복사해 붙여넣고 엔터 Claude가 알아서 폴더를 만들고 스킬 파일을 저장해 줍니다. 직접 파일을 만들 필요 없습니다.
  3. 작업을 마칠 때 /wrapup 이라고 칩니다 목록에 안 보이면 Claude Code를 껐다 다시 켜세요.

붙여넣을 내용

Claude Code 프롬프트에 그대로 붙여넣기
아래 명세대로 Claude Code 개인 스킬을 하나 만들어줘.

[할 일]
1. 홈 디렉토리의 .claude/skills/wrapup/ 폴더를 만들 것
   (Windows면 C:\Users\내계정\.claude\skills\wrapup\, Mac/Linux면 ~/.claude/skills/wrapup/)
2. 그 안에 SKILL.md 파일을 만들고, 아래 [파일 내용] 을 그대로 저장할 것
3. 저장 후 파일 경로를 알려줄 것

[파일 내용]
---
name: wrapup
description: |
  세션 종료 시 작업 내용을 분석하고 ~/.claude/session_log.md에 기록하는 마무리 스킬.
  Use when asked to "wrapup", "세션 마무리", "랩업", "정리해줘", or at the end of a session.
allowed-tools:
  - Bash
  - Read
  - Write
  - Glob
  - Grep
---

세션 종료 시 작업 내용을 분석하고 `.claude/session_log.md`에 기록하는 마무리 스킬입니다.

아래 단계를 순서대로 수행하세요.

## Step 1: 현재 작업 상태 분석

현재 작업 디렉토리와 관련 경로에서 최근 변경된 파일들을 확인하세요.

확인 대상:
- 현재 작업 디렉토리 내 최근 수정 파일 (ls -lt, 최근 24시간 기준)
- ~/.claude/commands/ 내 변경된 스킬 파일
- ~/.claude/projects/*/memory/ 내 변경된 메모리 파일
- git이 있으면 git diff --stat, git log --oneline -10

## Step 2: 세션 로그 작성

분석 결과를 바탕으로 아래 구조로 `.claude/session_log.md` 파일을 작성하세요.
이전 로그가 있으면 파일 상단에 새 로그를 추가하고, 이전 로그는 구분선(---) 아래에 유지하세요.

# Session Log — {날짜}

## Session Summary
{한 줄 요약: 이번 세션에서 무엇을 했는가}

## 1. 완료 항목
- {해결한 기능/버그/작업을 불릿으로 요약}
- {구체적 수치가 있으면 포함 (파일 수, 데이터 건수 등)}

## 2. 생성/수정된 파일 목록
### 신규 생성
{파일 경로와 한 줄 설명}

### 수정
{파일 경로와 변경 내용 요약}

### 삭제/이동
{있으면 기록}

## 3. Next Actions
### 즉시 (다음 세션)
- [ ] {바로 이어서 해야 할 것}

### 단기
- [ ] {1~2주 내 해야 할 것}

### 중기
- [ ] {한 달 이내}

## 4. 기억해야 할 규칙/결정
- {이번 세션에서 확정된 규칙이나 중요 결정}

## Step 3: 아카이브 관리

새 로그를 session_log.md 상단에 추가한 뒤, **최근 3~5개 세션만 유지**하고 나머지는 `session_log_archive.md`로 이동하세요.

규칙:
- session_log.md: 최근 3~5개 세션만 유지
- session_log_archive.md: 그 이전 세션 보관 (파일 상단에 추가, 기존 내용 유지)
- 아카이브로 이동 시 각 세션의 "4. 기억해야 할 규칙/결정"은 반드시 보존
  (완료 항목·파일 목록은 요약 압축 가능)
- session_log_archive.md 최상단에 "세션 N부터 session_log.md로 분리 (날짜)" 메모 유지

## Step 4: 화면 출력

작성한 로그의 핵심 내용을 화면에도 출력하세요.
- Session Summary (1줄)
- 완료 항목 (불릿 요약)
- 생성/수정 파일 수
- Next Actions 중 "즉시" 항목만

## 주의사항
- 파일 목록은 실제 확인된 것만 기록 (추측 금지)
- Next Actions는 구체적이고 실행 가능한 형태로 (막연한 "검토" 금지)
- API 키 등 민감 정보는 로그에 포함하지 말 것

[참고]
- 위 [파일 내용] 의 맨 위 --- 부터 allowed-tools 아래 --- 까지가 프론트매터(설정 영역)이고, 그 아래가 실제 지시문 본문임
- 파일을 다 만든 뒤 /wrapup 이라고 치면 동작함. 목록에 안 뜨면 Claude Code를 껐다 다시 켜면 됨

복사 버튼이 동작하지 않으면 상자 안을 드래그해서 직접 복사하셔도 됩니다.

스킬이란 게 별거 아닙니다

Claude Code의 스킬은 파일 하나입니다. ~/.claude/skills/이름/SKILL.md 경로에 파일을 두면 그 순간부터 /이름 으로 불러 쓸 수 있습니다. 설치도, 등록도, 재빌드도 없습니다.

파일 구조도 딱 두 부분뿐입니다.

영역위치역할
프론트매터 맨 위 --- 사이 name은 호출할 이름, description은 언제 쓰는 스킬인지, allowed-tools는 이 스킬이 쓸 수 있는 도구 목록
본문 그 아래 전부 Claude에게 시킬 일을 한국어로 순서대로 쓰면 끝. 프로그래밍 문법이 아니라 그냥 업무 지시서입니다.
핵심. 스킬 본문은 코드가 아니라 사람에게 일을 넘겨줄 때 쓰는 인수인계 문서에 가깝습니다. "이런 걸 확인하고, 이런 형식으로 정리하고, 이건 하지 마라"를 평소 말투로 적으면 됩니다.

내 스킬을 직접 만들려면

위 구조를 그대로 두고 폴더 이름과 name만 바꾼 뒤, 본문을 원하는 지시로 갈아끼우면 됩니다. 사실 가장 빠른 방법은 Claude Code에게 말로 시키는 것입니다.

예시
~/.claude/skills/릴리즈노트/SKILL.md 스킬을 만들어줘.
하는 일: 최근 커밋 로그를 읽어서 사용자에게 보여줄 릴리즈 노트를
"새 기능 / 개선 / 버그 수정" 3개 섹션으로 정리해주는 것.
개발자 용어는 빼고 일반 사용자가 이해할 표현으로 쓸 것.

개인용과 프로젝트용의 차이

자주 나오는 질문

목록에 스킬이 안 보입니다

Claude Code를 완전히 껐다 다시 켜세요. 그래도 안 보이면 파일 경로와 프론트매터의 name 값이 폴더 이름과 같은지 확인하면 됩니다.

로그가 어디에 쌓이나요

~/.claude/session_log.md 에 최근 3~5개 세션이 쌓이고, 그보다 오래된 것은 session_log_archive.md 로 자동으로 밀려납니다. 파일이 무한정 커지지 않습니다.

매번 /wrapup 이라고 쳐야 하나요

"세션 마무리", "랩업", "정리해줘" 라고 말해도 Claude가 알아서 이 스킬을 씁니다. 프론트매터의 description 에 그 표현들을 적어뒀기 때문입니다. 자기만의 트리거 단어를 추가하고 싶으면 그 줄에 끼워 넣으면 됩니다.