Claude Code Skills 활용법, 직접 만든 5가지 스킬 후기

Claude Code Skills 기능을 직접 써보고 만든 5가지 스킬을 공유합니다. 스킬이 무엇인지, 언제 쓰면 좋은지, 만드는 법과 실제 작업 시간을 줄인 사례까지 비개발자도 따라올 수 있게 정리했습니다.

Claude Code Skills를 한 달 정도 써보면서 반복 작업이 눈에 띄게 줄었습니다. 처음엔 "그냥 프롬프트를 길게 써서 저장해두는 거 아닌가?" 싶었는데, 막상 만들어 쓰다 보니 단순 프롬프트 저장 그 이상이더군요. 이 글에서는 Skills가 무엇인지부터 시작해서 제가 실제로 만들어 쓰는 5가지 스킬, 그리고 비개발자가 첫 스킬을 만들 때 막히는 지점까지 다룹니다. 코드 한 줄 안 짜본 분도 따라올 수 있게 풀어서 설명했으니 부담 없이 읽어보세요.

Claude Code Skills가 뭐길래

Claude Code Skills는 Claude에게 "이런 작업이 들어오면 이런 절차로 처리해줘"라고 미리 알려주는 재사용 가능한 작업 설명서입니다. 공식 소개에 따르면 Anthropic이 2025년 하반기에 Claude Code(터미널에서 Claude를 부려 코드·문서 작업을 시키는 도구)에 정식 추가한 기능으로, 폴더 하나 + 마크다운 파일 하나만 있으면 누구나 만들 수 있습니다.

비유하자면 이렇습니다. 회사에 새 인턴이 왔다고 칩시다. 매번 "보고서 양식은 이렇고, 폰트는 이거고, 첨부파일은 여기에 둬"라고 설명하면 시간이 아깝잖아요. 그래서 매뉴얼 PDF 한 장을 쥐여줍니다. Skills는 Claude에게 그 매뉴얼을 쥐여주는 일과 비슷합니다.

구분	일반 프롬프트	Skills
저장 위치	매번 다시 입력	폴더에 영구 저장
호출 방식	사용자가 복붙	Claude가 상황 보고 자동 사용
첨부 자료	없음	예시 파일·템플릿 포함 가능
공유	어려움	폴더째 깃허브로 공유

특히 마지막 "Claude가 알아서 상황 보고 사용한다"가 핵심입니다. 사용자가 "이 스킬 써줘"라고 호출하지 않아도, 작업 요청을 들은 Claude가 "어, 이건 그 스킬이 필요한 일이네" 하고 스스로 찾아 적용합니다.

스킬이 어떻게 동작하는지 한 장으로

내부 동작을 흐름으로 그리면 이렇습니다.

사용자 요청
   ↓
Claude가 요청 내용 분석
   ↓
스킬 폴더 훑어보기 (이름·설명만 먼저 확인)
   ↓
   ├─ 맞는 스킬 발견 → 본문(SKILL.md) 읽기 → 절차대로 작업
   └─ 없음           → 평소처럼 일반 응답

여기서 재밌는 건 "이름·설명만 먼저 확인"입니다. Claude는 모든 스킬의 본문을 매번 다 읽지 않습니다. 폴더 이름과 짧은 설명(description)만 훑은 뒤, 관련 있어 보이는 스킬만 본문을 펼쳐 봅니다. 그래서 스킬을 100개 만들어도 토큰(AI가 한 번에 처리하는 글자 단위) 비용이 폭발하지 않습니다.

스킬 하나의 최소 구성은 폴더 안에 SKILL.md라는 마크다운 파일 하나입니다. 그 안에 "이 스킬은 언제 써야 하는지", "어떤 순서로 일을 처리할지"를 자연어로 적어두면 끝입니다. 코드는 필수가 아닙니다.

직접 만들어 쓰는 5가지 스킬

한 달 동안 만든 스킬은 십여 개인데, 그중 거의 매일 발동하는 5개만 추렸습니다. 모두 제 작업 흐름에서 반복되는 작업들입니다.

1. 블로그 초안 검수 스킬

블로그 글 초안을 마크다운으로 쓰면 자동으로 다음을 점검합니다.

• 제목이 30~40자 사이인지
• TL;DR 박스가 첫머리에 있는지
• H2 제목이 모두 의문문으로만 되어 있지 않은지 (AI 양산글 패턴)
• 외부 도구 이름이 처음 등장할 때 풀이 문장이 붙어 있는지

SKILL.md 첫머리는 이렇게 시작합니다.

---
name: blog-draft-review
description: 마크다운 블로그 초안을 받아 제목 길이,
  구조, AI 양산글 패턴을 점검하고 수정안을 제시한다.
---

## 언제 쓰는가
사용자가 .md 파일을 주면서 "검수해줘",
"초안 봐줘"라고 할 때 자동으로 발동한다.

## 점검 항목
1. 제목 글자 수 ...

이 스킬 하나로 매번 길게 적던 점검 프롬프트를 안 써도 됩니다. "이 글 봐줘"만 하면 알아서 체크리스트대로 돕니다.

2. 커밋 메시지 다듬기 스킬

코드 변경 사항을 git(코드 변경 이력을 저장하는 도구)에 기록할 때 메시지를 영문 컨벤션에 맞게 다듬어줍니다. "버튼 색 바꿈"이라고 한국어로 쓰면 style(ui): adjust primary button color처럼 변환합니다. 회사마다 컨벤션이 달라 SKILL.md에 우리 팀 규칙을 박아둘 수 있다는 게 장점입니다.

3. 스크린샷 → 마크다운 표 변환

엑셀·노션 캡처 이미지를 던지면 마크다운 표로 옮겨줍니다. 회의록 정리할 때 가장 많이 발동합니다. 스킬 본문에는 "병합 셀이 있으면 풀어서 평면 표로 만들 것", "숫자 천 단위 콤마 유지" 같은 디테일이 적혀 있습니다.

4. API 응답 샘플 → 타입 정의

외부 서비스에서 받아온 JSON(데이터를 주고받을 때 흔히 쓰는 형식, 중괄호와 따옴표로 이뤄진 텍스트) 응답을 붙여 넣으면 TypeScript 타입을 만들어줍니다. 비슷한 도구가 웹에도 많지만, 우리 프로젝트의 명명 규칙을 반영해주는 건 직접 만든 스킬뿐이라 손이 자꾸 갑니다.

5. 하루 작업 로그 정리

이게 가장 의외로 좋았습니다. 하루 끝에 "오늘 한 거 정리해줘"라고만 하면 그날 수정한 파일·커밋·열어본 이슈를 훑어 일일 보고서 형식으로 묶어줍니다. 처음엔 회의적이었는데, 주간 회고할 때 이 로그가 쌓여 있으면 기억력에 의존하지 않아도 돼서 마음이 편합니다.

비개발자가 첫 스킬을 만드는 방법

복잡해 보여도 핵심 절차는 4단계입니다.

[1] 스킬 폴더 만들기
       ↓
[2] SKILL.md 파일 작성
       ↓
[3] 약속된 위치에 폴더 두기
       ↓
[4] Claude Code 실행해서 확인

준비물 체크리스트입니다.

• [ ] Claude Code가 설치되어 있다 (없다면 공식 문서 따라 설치, 약 15분)
• [ ] 텍스트 편집기 하나 (메모장도 OK, VS Code 추천)
• [ ] 자동화하고 싶은 반복 작업이 머릿속에 1개 있다

스킬 폴더의 이름은 영문 소문자에 하이픈으로 짓습니다. 예: meeting-notes-cleaner. 그 안에 SKILL.md라는 파일을 만들고 다음 골격을 채우면 됩니다.

---
name: meeting-notes-cleaner
description: 회의록 초안을 받아 헤더, 액션 아이템,
  결정사항 세 부분으로 정리한다.
---

## 언제 쓰는가
사용자가 회의록이라고 부른 텍스트를 주거나,
"회의록 정리"라는 말이 포함될 때 발동.

## 작업 절차
1. 입력 텍스트에서 발화자를 식별한다.
2. 결정된 사항을 따로 모아 "결정사항" 섹션에 둔다.
3. "○○가 ○○까지 한다" 패턴은 액션 아이템으로 분류.
4. 결과는 마크다운으로 출력.

상단의 ---로 감싼 부분이 메타 정보(프론트매터라고 부릅니다)이고, 그 아래는 그냥 한국어로 줄글을 써도 됩니다. 코드는 한 줄도 없죠. 이 폴더를 Claude Code가 정한 스킬 디렉터리에 두면(공식 문서 기준 사용자별 또는 프로젝트별 위치 두 곳 중 선택) 다음번 실행부터 자동 인식됩니다.

💡 처음 만들 때 description을 너무 짧게 쓰면 Claude가 언제 발동할지 헷갈려합니다. "○○일 때 ○○를 한다" 형식으로 한 문장 길게 쓰는 게 발동률이 훨씬 높았습니다.

자주 막히는 부분

제가 한 달 동안 부딪힌 것과 주변에서 들은 사례를 모았습니다.

증상	원인	해결
스킬을 만들었는데 발동을 안 한다	description이 너무 추상적	트리거 단어를 명시적으로 넣기
비슷한 스킬 두 개가 동시에 발동	이름·설명이 겹침	둘을 합치거나 description을 좁히기
스킬이 매번 처음부터 다시 묻는다	절차가 너무 모호함	단계별 번호 매기기
한국어 출력이 어색하다	출력 형식 명시 누락	"한국어로, ~합니다체" 한 줄 추가

특히 첫 번째 문제가 가장 흔합니다. 저도 description에 "회의록 정리"라고만 적었더니 Claude가 회의록을 줘도 그냥 일반 응답을 하더군요. "사용자가 회의록·미팅·회의 내용 등의 단어를 포함한 텍스트를 줄 때 발동"이라고 풀어 쓰니 그제야 잘 잡았습니다.

또 하나, 스킬은 만능이 아닙니다. 한 번 쓰고 말 작업까지 스킬로 만들면 폴더만 지저분해집니다. 저는 "최소 주 2회 이상 반복되는가"를 기준으로 삼습니다. 그 미만은 그냥 그때그때 프롬프트로 처리하는 게 낫습니다.

어떤 작업이 스킬로 만들 가치가 있나

판단이 어렵다면 이 표를 참고해보세요.

작업 특성	스킬로?
매번 같은 출력 형식이 필요	적합
회사·팀의 고유 규칙이 있다	매우 적합
입력은 다양하지만 처리 절차는 동일	적합
한 번만 쓰고 안 쓸 작업	부적합
매번 사람의 감각적 판단이 필요	부적합

비개발자 독자분들이 떠올릴 만한 사용 시나리오 몇 가지를 들어보겠습니다.

• 마케팅 담당자: SNS 게시물 초안을 채널별 글자 수 제한에 맞게 다듬는 스킬
• 블로그 운영자: 글마다 들어가는 메타 설명·태그 자동 생성 스킬
• 엑셀 작업이 많은 사람: CSV 데이터를 받아 정해진 보고 양식으로 변환하는 스킬
• 번역 작업자: 자기 스타일 가이드(존칭·용어 통일 규칙)를 적용한 번역 스킬

핵심은 "내가 매번 같은 설명을 반복해서 쓰고 있다"는 자각입니다. 그 순간이 스킬로 옮길 타이밍입니다.

마무리

한 달 써보고 느낀 건, Skills의 진짜 가치는 자동화 자체보다 나만의 작업 규칙을 글로 정리하게 만드는 것에 있다는 점이었습니다. 회의록 스킬을 만들면서 처음으로 "내가 회의록을 어떤 순서로 정리하고 있었지?"를 명문화했고, 그 과정에서 빠뜨리던 항목도 발견했습니다. 사람에게 인수인계하는 문서를 만드는 셈인데, 그걸 받아 쓰는 게 Claude일 뿐이죠.

오늘 당장 시작하고 싶다면, 지금 여러분이 ChatGPT나 Claude에 가장 자주 복사·붙여넣기 하는 프롬프트가 무엇인지 떠올려보세요. 그게 첫 스킬 후보입니다. SKILL.md 한 장으로 시작해서, 안 맞으면 지우고 다시 만들면 그만입니다. 부담 없이 한 번 만들어보시길 권합니다.