발표 스크립트 - Chapter 5: 업무 자동화 바이브코딩하는 Agent Skill
Clip 1: Claude Skills의 프롬프트와 코드를 동시에 사용하는 자동화 살펴보기
오프닝 (30초)
안녕하세요! 오늘은 Claude Skills에 대해 알아보겠습니다.
여러분은 Claude에게 복잡한 작업을 시킬 때마다 긴 프롬프트를 반복해서 작성한 경험 있으신가요? "우리 회사 브랜드 가이드에 맞춰서, 폰트는 이렇게 쓰고, 컬러는 저렇게 쓰고..." 이런 식으로요.
Claude Skills는 바로 이런 문제를 해결합니다.
본론 1: Skills 개념 (2분)
[슬라이드: Skills 정의]
Claude Skills는 지침, 코드, 참고 자료를 담은 모듈식 패키지입니다. 마치 스마트폰에 앱을 설치하듯이, Claude에게 전문 기능을 추가하는 거죠.
[슬라이드: 기존 vs Skills 비교 다이어그램]
기존 방식은 매번 긴 프롬프트를 작성해야 했습니다. 하지만 Skills를 사용하면 "Q4 보고서 만들어줘"라고만 말하면, Claude가 알아서 필요한 Skills를 로드해서 작업합니다.
[슬라이드: 4가지 특징]
Skills의 4가지 핵심 특징을 볼까요?
첫째, 조합 가능합니다. 여러 Skills가 동시에 작동해요. 둘째, 이식 가능합니다. Claude.ai, Claude Code, API 어디서나 써요. 셋째, 효율적입니다. 필요할 때만 로드해서 토큰을 아껴요. 넷째, 강력합니다. 실행 가능한 코드를 포함해서 신뢰성이 높아요.
본론 2: 점진적 공개 설계 (2분 30초)
[슬라이드: 3단계 로딩 Mermaid 다이어그램]
Skills의 핵심은 점진적 공개 설계입니다.
Level 1: 메타데이터 Claude는 먼저 Skills의 이름과 설명만 봅니다. 약 100 토큰만 쓰죠. "이 작업에 이 Skill이 필요한가?" 판단합니다.
Level 2: 지침 필요하다고 판단되면 상세 지침을 로드합니다. 약 5,000 토큰 정도요. "어떻게 작업할 것인가"를 배웁니다.
Level 3: 코드와 리소스 마지막으로 실제 실행 코드나 템플릿을 가져옵니다. 필요할 때만요.
[슬라이드: Python 코드 예시]
예를 들어 PowerPoint를 만드는 Skill이라면, Level 3에서 이런 Python 스크립트를 실행합니다. 슬라이드를 추가하고, 텍스트를 넣고, 레이아웃을 조정하는 코드죠.
이렇게 프롬프트와 코드가 결합되면서 두 가지 장점을 얻습니다. 프롬프트는 유연성을, 코드는 정확성을 제공하죠.
본론 3: 실제 활용 사례 (2분)
[슬라이드: 실제 활용 사례]
실제로 어떻게 쓰이는지 볼까요?
창의성 분야:algorithmic-art Skill은 p5.js로 생성 미술을 만듭니다. "흐름장을 사용한 추상화 그려줘"라고만 하면 자동으로 코드 실행해서 작품이 나와요.
개발 분야:mcp-builder Skill은 외부 API를 Claude에 연결하는 MCP 서버를 만들어줍니다. "날씨 API를 Claude에 연결해줘"라고 하면 전체 서버 코드를 생성해줘요.
엔터프라이즈 분야:internal-comms Skill은 회사 내부 문서를 작성합니다. 상태 보고서, 뉴스레터, FAQ 등 형식에 맞춰 자동 생성하죠.
[슬라이드: 도입 기업 통계]
실제 도입 사례를 보면, Box는 스프레드시트 처리 시간을 80% 단축했고, Canva는 생산성을 3배 향상시켰습니다.
클로징 (30초)
[슬라이드: 바이브코딩 시나리오]
바이브코딩에서는 이렇게 활용할 수 있습니다. "Q4 실적 보고서 만들어줘"라고만 입력하면, Claude가 알아서 필요한 Skills를 조합해서 완성된 프레젠테이션을 만들어주는 거죠.
다음 클립에서는 이런 Skills를 직접 만들고 Claude.ai에 추가하는 방법을 실습해보겠습니다!
Clip 2: Skill 만들고 Claude.ai에 추가하기
오프닝 (20초)
이번 시간에는 커스텀 Skill을 직접 만들어보겠습니다.
실습 예제로 "회의록 자동 정리 Skill"을 만들 건데요, 회의 내용을 입력하면 참석자, 안건, 결정 사항, 액션 아이템으로 자동 분류해주는 Skill입니다.
본론 1: Skill 구조 (2분)
[슬라이드: 폴더 구조]
모든 Skill은 최소한 SKILL.md 파일이 필요합니다.
실제 프로젝트에서는 이렇게 구성하죠:
- SKILL.md: 메인 지침
- REFERENCE.md: 참고 자료
- templates 폴더: 템플릿 파일들
- scripts 폴더: 실행 스크립트들
[슬라이드: SKILL.md 구조]
SKILL.md는 두 부분으로 나뉩니다.
첫째, YAML 프론트매터 (필수)
- name: Skill의 고유 이름 (최대 64자)
- description: Claude가 이 Skill을 언제 쓸지 판단하는 설명 (최대 1024자)
- version, dependencies: 선택사항
둘째, 마크다운 본문
- 사용 시기
- 작업 프로세스
- 예제
본론 2: Description 작성 전략 (1분 30초)
[슬라이드: 좋은 예 vs 나쁜 예]
Description 작성이 정말 중요합니다.
나쁜 예: "보고서를 만드는 Skill" → 너무 모호해서 Claude가 언제 써야 할지 몰라요.
좋은 예: "회사 분기 실적 보고서를 자동으로 생성하는 Skill. 매출 데이터 분석, 차트 생성, PDF 변환 작업에 사용. CSV 파일을 입력받아 시각화된 보고서를 출력함." → 구체적이죠? 입력/출력 형식, 주요 기능을 명시했어요.
[슬라이드: Description 체크리스트]
Description 작성할 때는:
- ✅ 구체적인 용도 명시
- ✅ 입력/출력 형식 언급
- ✅ 주요 기능 나열
- ❌ 모호하거나 추상적인 설명은 피하세요
본론 3: 실습 - 회의록 Skill 만들기 (3분)
[화면 공유: 터미널]
이제 직접 만들어볼게요.
STEP 1: 폴더 생성
mkdir meeting-notes-skill
cd meeting-notes-skillSTEP 2: SKILL.md 작성
[화면: 에디터]
YAML 프론트매터부터 작성합니다.
---
name: meeting-notes-skill
description: 회의록을 구조화된 형식으로 자동 정리하는 Skill.
회의 내용을 입력받아 참석자, 안건, 결정 사항, 액션 아이템으로 분류.
version: 1.0.0
---description을 보세요. 정확히 뭘 하는지, 어떻게 분류하는지 명시했죠?
[화면: 마크다운 본문 작성]
이제 본문을 작성합니다.
## 사용 시기
- 회의록 정리가 필요할 때
- 녹취록이나 메모를 구조화하고 싶을 때
## 출력 형식
회의록은 5개 섹션으로 구성됩니다:
1. 회의 정보 (날짜, 참석자, 장소)
2. 안건
3. 주요 논의 내용
4. 결정 사항
5. 액션 아이템 (담당자, 작업, 마감일 표)
## 예제
(입력/출력 예시 작성)본론 4: 패키징과 업로드 (2분)
[슬라이드: ZIP 구조 비교]
패키징할 때 주의할 점!
잘못된 구조:
skill.zip
├── SKILL.md # ❌ 폴더 없이 바로 파일올바른 구조:
skill.zip
└── meeting-notes-skill/ # ✅ 폴더가 루트
└── SKILL.md[화면: 터미널]
터미널에서 ZIP 생성:
zip -r meeting-notes-skill.zip meeting-notes-skill/구조 확인:
unzip -l meeting-notes-skill.zip첫 줄에 폴더가 나와야 해요!
[화면: Claude.ai]
이제 업로드해봅시다.
- Claude.ai 우측 상단 > Settings
- 좌측 메뉴 > Skills
- "+ Upload Custom Skill" 버튼
- ZIP 파일 선택
- 자동 검증 → 활성화!
본론 5: 테스트 & 트러블슈팅 (1분 30초)
[화면: Claude.ai 채팅]
테스트해볼까요?
오늘 제품 개발 회의를 했어요.
강팀장, 송개발자, 정디자이너가 참석했고,
새로운 기능 추가를 결정했습니다.
강팀장은 다음주 월요일까지 기획서를 작성하기로 했어요.[결과 확인]
보세요! Claude가 자동으로 구조화된 회의록을 만들었어요. 참석자, 결정 사항, 액션 아이템이 표로 정리되었죠.
[슬라이드: 트러블슈팅]
흔한 오류 3가지:
- "Invalid YAML" → 콜론(😃 누락 확인
- Skill이 로드 안 됨 → description을 더 구체적으로
- ZIP 구조 오류 →
unzip -l로 구조 확인
클로징 (30초)
[슬라이드: 고급 팁]
더 고급 기능도 있습니다.
skill-creator Skill을 쓰면 대화형으로 Skill을 만들 수 있고, 여러 Skills를 조합해서 복잡한 워크플로우도 구축할 수 있어요.
이제 여러분도 업무에 필요한 커스텀 Skill을 만들어보세요! 회의록 정리, 보고서 생성, 데이터 분석 등 반복 작업을 자동화할 수 있습니다.
발표 팁
Clip 1 발표 시
- 다이어그램 활용: 3단계 로딩 구조는 화면에 띄워두고 손으로 가리키며 설명
- 실제 사례 강조: Box 80% 단축, Canva 3배 향상 같은 구체적 수치 언급
- 속도 조절: "점진적 공개" 개념은 천천히, 명확하게
Clip 2 발표 시
- 화면 공유 필수: 터미널과 에디터를 실제로 보여주며 라이브 코딩
- 실수 포함 가능: ZIP 구조 오류를 일부러 보여주고 고치는 과정도 좋음
- 인터랙티브: "여러분도 따라해보세요" 식으로 참여 유도
공통 팁
- 시간 배분: Clip 1은 7분, Clip 2는 10분 내외
- 질문 준비: "다른 Skills와 어떻게 조합하나요?" 같은 질문 예상
- 리소스 공유: GitHub 링크, 공식 문서 링크를 채팅창에 공유