Claude 심화 6단계 ★ 나만의 스킬 만들기

 

 

 

 

심화 6단계 ★ 나만의 스킬 만들기

매번 설명하던 "내 방식"을 매뉴얼로 · 대화로 만들기, 직접 만들기, 설치·테스트·공유까지

Claude 심화 과정 6/12 · 2026년 9월 기준 · ⏱ 며칠 · ★ = 꼭 해볼 것

이번 단계에서 배우는 것
심화 과정의 핵심 단계입니다. 5단계에서 스킬의 구조를 이해했으니, 이제 내 업무용 스킬을 직접 만듭니다. 이 블로그 글을 쓰는 방식을 스킬로 만드는 예제를 처음부터 끝까지 따라가고, 회사 보고서 예제와 Claude Code 전용 기능까지 다룹니다. 한 번에 끝내기보다 며칠 동안 써 보며 다듬는 것이 목표입니다.

1어떤 일을 스킬로 만들까판단 기준

2★ 방법① skill-creator와 대화로 만들기추천

3★ 방법② 직접 만들기 — 블로그 글 스킬예제 1

4회사 주간보고서 스킬예제 2

5Claude Code 전용 기능개발자

6설치하기claude.ai · Claude Code

7테스트와 개선 루프 · 팀 공유다듬기

8정리 & 체크리스트마무리

1 어떤 일을 스킬로 만들까 판단 기준

모든 일을 스킬로 만들 필요는 없습니다. "내가 Claude에게 같은 설명을 세 번 이상 했다"면 스킬 후보입니다.

✔ 반복되는 일

매주 주간보고, 매번 블로그 글, 매달 정산 요약처럼 주기적으로 돌아오는 일.

✔ 규칙이 있는 일

말투, 금지 표현, 검토 순서, 코딩 컨벤션처럼 "우리는 이렇게 한다"가 정해진 일.

✔ 양식이 있는 일

보고서 템플릿, HTML 스타일, 견적서 형식처럼 결과물의 모양이 정해진 일.

✘ 스킬이 아닌 것

한 번만 할 일(그냥 대화로), 모든 대화에 늘 적용할 짧은 규칙(프로젝트 지침이나 CLAUDE.md로), 외부 서비스 접속 자체(MCP로).

첫 스킬 추천 : 이미 프로젝트 지침이나 긴 프롬프트로 잘 쓰고 있는 작업이 가장 좋은 재료입니다. 저는 이 블로그 글이 그렇습니다. "모듈비트 티스토리" 프로젝트에 sample.html과 지침을 넣어 쓰고 있었는데, 이걸 스킬로 옮기면 프로젝트 밖에서도, Claude Code에서도 같은 품질로 쓸 수 있습니다.

2 ★ 방법① skill-creator와 대화로 만들기 따라해 보기

Anthropic이 제공하는 skill-creator는 "스킬을 만들어 주는 스킬"입니다. 인터뷰하듯 질문을 주고받으며 폴더 구조와 SKILL.md를 같이 설계해 줍니다. 처음이라면 이 방법을 추천합니다.

1. 준비

코드 실행과 스킬 기능이 켜져 있는지 확인(5단계). 참고할 샘플 파일(예: sample.html)을 준비합니다.

2. 요청

새 대화에 샘플 파일을 첨부하고 아래 프롬프트를 붙여넣습니다.

3. 질문에 답하기

Claude가 "언제 쓰나요?", "꼭 지킬 규칙은?" 같은 질문을 하면 구체적으로 답합니다. 좋은 예·나쁜 예를 알려 줄수록 좋아집니다.

4. 결과 확인

만들어진 SKILL.md를 읽어 보고, 저장·설치합니다. claude.ai에서는 이후 "Edit with Claude" 로 대화하며 계속 고칠 수 있습니다.

skill-creator로 스킬 만들어줘.

[만들고 싶은 스킬]
- 이름: tistory-guide-writer
- 하는 일: 모듈비트 티스토리에 올릴 Claude 가이드 글을 HTML로 작성
- 언제: "블로그 글 써줘", "티스토리 글", "튜토리얼 HTML" 요청 시
- 첨부한 sample.html 과 똑같은 스타일(.cckr 클래스, 색상, 구성)을 지켜야 함

[규칙]
- 존댓말 습니다체, 일상 비유 하나 이상, 이모지 금지
- 명령어는 코드 블록, 모르는 메뉴 경로는 지어내지 말 것
- 마지막은 체크리스트와 이전 글/다음 글 링크

sample.html 은 참고 파일로 스킬 안에 넣어 주고,
만들기 전에 궁금한 점이 있으면 먼저 질문해줘.

팁 : 다 만들고 나서 "이 스킬로 'MCP 기초' 글을 하나 시험 삼아 써 봐"라고 바로 테스트하세요. 결과가 어긋나는 부분을 짚어 주면 skill-creator가 SKILL.md를 고쳐 줍니다.

3 ★ 방법② 직접 만들기 — tistory-guide-writer 예제 1

스킬은 결국 폴더와 마크다운 파일이라 메모장으로도 만들 수 있습니다. 직접 한 번 만들어 보면 구조가 확실히 머리에 들어옵니다.

폴더 구조

tistory-guide-writer/
├── SKILL.md                 # 매뉴얼 본문 (아래 전문)
└── references/
    └── sample.html          # 이전에 쓴 글 한 편 (스타일 원본)

SKILL.md 전문

---
name: tistory-guide-writer
description: 모듈비트 티스토리용 Claude 가이드 글을 .cckr 스타일 HTML로 작성. 블로그 글, 튜토리얼, 티스토리 포스팅, 심화 과정 N단계 글 요청 시 사용.
---

# 모듈비트 티스토리 가이드 글 작성

## 먼저 할 일
1. references/sample.html 을 읽고 스타일과 구성을 확인한다.
2. 사용자에게 받은 주제, 단계 번호, 소요시간을 확인한다. 빠진 게 있으면 묻는다.

## HTML 규칙
- sample.html 의 맨 위 주석과 <style> 블록을 한 글자도 바꾸지 않고 그대로 복사한다.
- 본문 전체를 <div class="cckr"> 로 감싼다.
- sample.html 에 정의된 클래스만 쓴다:
  cc-head, cc-sub, cc-meta, cc-lead, cc-row / cc-c / cc-d / cc-hint,
  cc-star, cc-note, cc-flow, cc-map / cc-card, cc-toc, cc-foot
- 모든 <p> 에 data-ke-size="size16", 모든 <h2> 에 data-ke-size="size26".
- h2 는 <span class="cc-n">번호</span> 제목 <span class="cc-t">태그</span> 형식.
- <pre><code> 안에서는 &lt; &gt; &amp; 로 이스케이프한다.

## 구성 순서
1. cc-head: h1(단계 + 제목), cc-sub(한 줄 부제), cc-meta(과정 N/12 · 기준일 · 소요시간)
2. "이번 단계에서 배우는 것" (cc-note 또는 cc-toc)
3. 번호 붙은 본문 섹션 5~8개
   - 개념 설명에는 일상 비유 하나 이상
   - 명령어·개념은 cc-row 표로
   - 최소 한 섹션은 "따라해 보기": 복사할 수 있는 한국어 프롬프트를 pre 블록으로
4. "정리 & 체크리스트": cc-row 에 ☐ 항목
5. cc-foot: 이전 글 · 다음 글 · 공식 문서 링크

## 톤
- 존댓말, 습니다체 위주. 문장은 짧게.
- 기초 과정을 마친 독자 기준. 전문 용어는 처음 나올 때 한 번 풀어 쓴다.
- 이모지는 쓰지 않는다. (⏱ ★ ☐ ✔ 만 예외)

## 사실 확인
- 명령어, 메뉴 경로, 요금제 정보는 확실한 것만 쓴다.
- 확실하지 않으면 "설정 화면에서"처럼 일반적으로 쓰고, 화면은 버전에 따라 다를 수 있다고 적는다.

## 마무리 체크리스트
- [ ] 헤더 주석과 style 블록이 sample.html 과 동일한가
- [ ] 정의되지 않은 클래스를 쓰지 않았는가
- [ ] 따라해 보기 프롬프트가 들어 있는가
- [ ] 태그가 모두 닫혔는가
- [ ] 이전 글 / 다음 글 제목이 맞는가

references/sample.html

이전에 쓴 글 중 가장 마음에 드는 한 편을 그대로 넣습니다. 본문에서 "먼저 읽어라"라고 적어 두었기 때문에 이 스킬이 쓰일 때만 읽힙니다. 점진적 공개 덕분에 평소에는 부담이 없습니다.

규칙은 "왜"와 함께

"style 블록을 바꾸지 마라"보다 "티스토리 스킨과 충돌하지 않도록 바꾸지 마라"처럼 이유를 붙이면 Claude가 애매한 상황에서도 판단을 잘합니다.

description 길이 확인 : 위 description은 200자 안쪽이라 claude.ai 업로드 제한(최대 200자)을 통과합니다. name도 64자 제한 안입니다. 하나의 스킬을 claude.ai와 Claude Code에서 같이 쓰려면 이 제한에 맞춰 두세요.

4 예제 2 — 회사 주간보고서 스킬 비개발자 추천

스킬은 다른 스킬과 함께 일할 수 있습니다. 이 스킬은 "무엇을 어떻게 쓸지"만 정하고, Word 파일을 만드는 일은 기본 제공 docx 스킬에 맡깁니다.

weekly-report/
├── SKILL.md
└── references/
    ├── glossary.md          # 회사 용어집 (약어 → 정식 명칭)
    └── example-report.md    # 잘 쓴 주간보고 예시 한 편

---
name: weekly-report
description: 회사 양식에 맞춘 주간보고서를 Word 파일로 작성. "주간보고", "이번 주 업무 정리", "주간 리포트" 요청 시 사용.
---

# 주간보고서 작성

## 순서
1. 사용자에게 이번 주 한 일 메모를 받는다 (없으면 물어본다).
2. references/glossary.md 로 사내 약어를 정식 명칭으로 바꾼다.
3. 아래 양식으로 정리한 뒤, Word(docx)로 만든다.

## 양식
1. 요약 (3줄 이내)
2. 이번 주 완료 — 표: 업무 | 결과 | 비고
3. 진행 중 — 진척률(%)과 예상 완료일
4. 다음 주 계획
5. 이슈 및 요청 사항

## 금지 표현
- "열심히", "최선을 다해" 같은 막연한 표현 → 수치나 결과로
- "~인 것 같습니다" → "~입니다" 또는 "~로 예상됩니다"
- 고객사 실명, 개인 연락처는 쓰지 않는다

## 마지막 확인
- 요약만 읽어도 핵심이 전달되는가
- 날짜 표기가 2026-09-24 형식으로 통일되었는가

용어집을 따로 둔 이유

용어는 계속 늘어납니다. 본문에 넣으면 SKILL.md가 길어지니 참고 파일로 분리하고, 용어만 추가할 때는 glossary.md만 고치면 됩니다.

민감 정보 주의

용어집·예시 보고서에 실제 고객 정보나 매출 수치를 넣지 마세요. 예시는 가상의 내용으로 만듭니다.

# 사용 예 (따라해 보기)
주간보고 써줘. 이번 주 메모:
- 로그인 API 응답속도 개선 (평균 1.2초 → 0.4초)
- 결제 모듈 리팩토링 60% 진행, 다음 주 목요일 완료 예정
- 신규 입사자 온보딩 자료 작성 완료
- 이슈: 테스트 서버 디스크 부족, 인프라팀 요청 필요

5 Claude Code 전용 기능 개발자

Claude Code의 스킬에는 슬래시 명령어처럼 쓰는 기능이 더 있습니다. 예전 커스텀 명령어(.claude/commands/)가 스킬로 합쳐졌기 때문입니다.

$ARGUMENTS

/스킬이름 뒤에 입력한 내용 전체가 들어갑니다. 첫 번째, 두 번째 값만 따로 쓰려면 $0 $1.

!`명령`

셸 명령 주입. Claude가 읽기 전에 명령을 실행해 그 결과를 본문에 끼워 넣습니다. 예: !`git diff HEAD`

${CLAUDE_SKILL_DIR}

스킬 폴더 경로. 스킬 안의 스크립트를 실행할 때 씁니다.

disable-model-invocation

true 면 Claude가 알아서 부르지 않고 내가 입력할 때만 실행. 릴리스·배포처럼 타이밍을 내가 정해야 하는 일에.

예제 — /release-note (.claude/skills/release-note/SKILL.md)

---
name: release-note
description: 최근 커밋으로 릴리스 노트 초안을 작성
disable-model-invocation: true
argument-hint: [버전]
allowed-tools: Bash(git log *)
---

# 릴리스 노트 작성

버전: $ARGUMENTS

## 최근 커밋
!`git log --oneline -20`

## 작성 규칙
1. 위 커밋을 "새 기능 / 개선 / 버그 수정"으로 분류한다.
2. 개발자 용어 대신 사용자가 이해할 수 있는 문장으로 쓴다.
3. 파일로 저장하지 말고 채팅에 마크다운으로 보여준다.

# 사용
/release-note v1.4.0

주의 : !`명령` 은 스킬이 불릴 때 실제로 실행됩니다. 조회용 명령(git log, git diff)만 쓰고, 파일을 지우거나 배포하는 명령은 넣지 마세요. allowed-tools 로 필요한 도구만 열어 두면 더 안전합니다.

6 설치하기 — claude.ai와 Claude Code 설치

같은 스킬 폴더를 두 곳에 모두 설치할 수 있습니다. 화면은 버전에 따라 다를 수 있습니다.

claude.ai · 데스크톱 앱 — ZIP 업로드

# ZIP 안에 "스킬 폴더"가 통째로 들어 있어야 합니다
tistory-guide-writer.zip
└── tistory-guide-writer/
    ├── SKILL.md
    └── references/
        └── sample.html

1. 압축

SKILL.md 파일들만 고르지 말고 폴더를 선택해서 압축합니다. (my-skill.zip/my-skill/SKILL.md 구조)

2. 업로드

Customize > Skills → "+" → "+ Create skill" → "Upload a skill" → ZIP 선택

3. 켜기 확인

목록에서 스킬이 켜져 있는지 확인하고, 새 대화에서 "블로그 글 써줘"로 시험합니다.

Claude Code — 폴더 복사

# 개인용: 내 모든 프로젝트에서 사용
cp -r tistory-guide-writer ~/.claude/skills/

# 프로젝트용: 이 저장소에서만 (팀 공유 가능)
mkdir -p .claude/skills
cp -r tistory-guide-writer .claude/skills/

# 확인: 세션에서 직접 호출
/tistory-guide-writer 심화 7단계 플러그인과 마켓플레이스

7 테스트와 개선 루프 · 팀 공유 다듬기

스킬은 한 번에 완성되지 않습니다. 새 직원 매뉴얼도 신입이 헤맨 지점을 보고 고쳐 나가듯, 써 보고 → 어긋난 곳을 찾고 → 고치는 과정을 몇 번 돌립니다.

증상: 안 불림

→ description 을 고칩니다. 내가 실제로 쓰는 단어("포스팅", "주간보고")를 넣고, "언제 쓰는지"를 분명하게.

증상: 너무 자주 불림

→ description의 범위를 좁힙니다. "모든 문서"가 아니라 "티스토리 HTML 글"처럼.

증상: 결과가 이상함

→ 본문 을 고칩니다. 틀린 부분을 규칙으로 추가하고, 좋은 예·나쁜 예를 넣습니다.

증상: 너무 김

→ 세부 자료는 reference 파일로 분리합니다. SKILL.md는 500줄 이하로 유지하는 것이 공식 권장입니다.

# 테스트 프롬프트 예 — 다양한 표현으로 불러 보기
티스토리에 올릴 "서브에이전트" 글 써줘
블로그 포스팅 하나 부탁해. 주제는 훅(Hook)
심화 8단계 튜토리얼 HTML 만들어줘

# 결과를 보고 고칠 때
방금 글에서 cc-toc 대신 ul 태그를 썼어.
tistory-guide-writer 스킬 본문에 이런 실수를 막는 규칙을 추가해줘.

팀 공유

.claude/skills/ 커밋

★ 프로젝트 스킬 폴더를 깃에 커밋하면 저장소를 받은 팀원 모두가 같은 스킬을 씁니다. 코드 리뷰처럼 스킬 수정도 PR로 관리하면 좋습니다.

claude.ai

ZIP 파일을 팀원에게 전달해 각자 업로드합니다. Team·Enterprise는 관리자가 조직 설정에서 스킬 사용을 허용해야 합니다.

플러그인 (예고)

스킬 여러 개와 MCP·명령어를 한 번에 설치하는 꾸러미로 배포하려면 플러그인으로 포장합니다. 다음 7단계에서 오늘 만든 스킬을 플러그인으로 만들어 봅니다.

8 정리 & 체크리스트

나만의 스킬은 "반복해서 설명하던 것을 한 번 적어 두는 일"입니다. 완벽하게 시작하지 말고, 쓰면서 다듬으세요.

☐ 재료 찾기

반복 · 규칙 · 양식 기준으로 스킬 후보를 하나 골랐다

☐ 방법①

skill-creator와 대화로 스킬을 하나 만들어 봤다

☐ 방법②

폴더와 SKILL.md를 직접 만들고, 참고 파일을 references에 분리했다

☐ description

무엇 + 언제 + 사용자가 쓰는 단어로, 200자 이내로 썼다

☐ 설치

claude.ai에 ZIP(폴더째 압축)으로 올리거나 Claude Code 스킬 폴더에 복사했다

☐ 개발자 기능

(선택) $ARGUMENTS · !`명령` · disable-model-invocation 으로 /release-note 같은 명령형 스킬을 만들었다

☐ 개선 루프

다른 표현으로 세 번 이상 테스트하고, 증상에 맞춰 description이나 본문을 고쳤다

☐ 공유

(팀이라면) .claude/skills/ 를 깃에 커밋해 공유했다

스킬은 만들어 둔 사람이 가장 큰 덕을 봅니다. 이 글 자체도 여기서 만든 tistory-guide-writer 스킬과 같은 규칙으로 쓰였습니다. 다음 7단계에서는 이 스킬을 플러그인으로 포장해 다른 사람에게 배포해 봅니다.

이전 글: 심화 5단계 스킬(Skill) 이해하기 · 다음 글: 심화 7단계 플러그인과 마켓플레이스
공식 문서: Claude Code 스킬 · 플러그인 · 커스텀 스킬 만들기
화면과 메뉴 이름은 버전에 따라 다를 수 있습니다(2026년 9월 기준).