핸드아웃-1page.md# Claude Code Skill·Agent 실전 활용 — 핵심 정리 ## 오늘 배운 것 (3줄 요약) 1. Skill·Agent·Plugin 3층 구조와 호출 트리거 3종. 2. 5대 라이브러리 출처에서 안전 설치 3기준 적용. 3. 마켓 설치 → GitHub clone → skill-creator 자작. ## 핵심 개념 용어집 | 용어 | 한 줄 정의 | | Skill | 폴더 단위, SKILL.md로 특정 작업 자동화 | | Agent | 단일 .md 파일, 다단계 위임받는 서브 | | Plugin | Skill·Agent·MCP 묶음, 마켓 배포 단위 | ...
## 5블록 시간표 (총 360분) 1. (60분) Hello, Claude Code — 설치 + 한글 인코딩 경고 2. (60분) 3층 구조와 첫 명령 3. (60분) 스터디장님 5종 시연 + 직접 호출 (점심 60분) 4. (90분) 라이브러리 탐색 + 설치 미션 5. (90분) skill-creator로 본인 스킬 자작 ## 슬라이드 6장 1. 왜 Claude Code인가 → 자판기 비유 2. 설치와 첫 실행 3. 3층 구조 한 장 4. 스터디장님 5종 라이브 시연 5. 5출처 보물지도 6. 내 스킬 자작 + 체크리스트
핸드아웃-퀴즈.md[OX-1] Skill은 단일 .md 파일, Agent는 폴더 단위로 구성된다. → X [OX-3] SKILL.md frontmatter의 description은 자연어 자동 호출 트리거다. → O [객관-1] Claude Code에서 마켓플레이스를 여는 슬래시 명령은? ③ /plugin [객관-2] 다음 중 "설치 전 안전 3기준"에 해당하지 않는 것은? ④ 다운로드 수 1000회 이상 [빈칸-1] Skill은 (___) 단위로 구성되고 SKILL.md와 부속 파일이 들어간다. 정답: 폴더
--- (8번 메타 농담 자동 삽입) --- 장태민 부원장님 환영합니다 반갑습니다, 장태민 부원장님. 매주 30명 환영 메시지를 손으로 쓰고 계신다고 적어주셨네요. 오늘 이 메시지가 바로 그 welcome-bulk로 생성된 것입니다 — 워크숍에서 동작 흐름까지 손에 쥐고 가실 수 있도록 준비했습니다. --- (31번 본인 페르소나) --- 도시아재님, 잘 오셨습니다 안녕하세요, 도시아재님. 본인 중개 업무의 반복 문서와 동료 공인중개사 대상 강의 자료 두 가지를 한꺼번에 다루고 계신다고 적어주셨죠. 이번 워크숍에서는 본인 업무를 줄여주는 스킬과 강의에서 그대로 시연할 수 있는 부동산 도메인 자산, 두 가지를 동시에 손에 쥐고 가실 수 있도록 준비했습니다. 총 31건 완료
후기분석.md평점 분포: 5점 15건(60%) · 4점 6건 · 3점 3건 · 2점 1건 평균: 4.4 / 5.0 광고 카피 ① "3시간이 3분이 되는 워크숍." 30명 환영 메시지가 한 줄 명령으로 끝납니다. 광고 카피 ② "내일 바로 쓸 스킬 1개, 손에 쥐고 가는 워크숍." 개선 제안 (3점 이하 4건 기반): 🔴 사전 환경 준비 부족 (A005, A011) 🔴 시간 배분 빠듯 (4건) 🟠 초보자 친화도 — 3층 구조 자체가 벽 (A015) → 3점 이하 후기의 75%가 "환경/시간" 카테고리. 콘텐츠 자체엔 불만 없음.
페르소나분석.md페인포인트 Top 5 1. 반복적 1:N 개인화 문서 작성 (11명) 2. 피드백·코멘트 1차 초안 자동화 (8명) 3. 강의안·교재 갱신 반복 (7명) 4. 후기·사례·메모 → 구조화 (6명) 5. A4 한 장 정리본 배포 (5명) 페르소나 군집 5개 (최대 군집: 1:1 개인화 코칭형 8명) 본인(도시아재) 특이성 • 이중 정체성 (실무자 + 강사) — 유일 • 도메인 케이스 자산화 압력 — 부동산 변형판 필요 → ROI가 다른 30명 대비 2배
강의안검토.md약점 Top 3 1. 시간 배분 미명시 — 즉시 25/50/10/50/40/5 분단위로 박을 것 2. 블록 4 워크북 실체 부재 — 빈칸 3단 템플릿 + 체크리스트 3항목 3. 블록 3 히스토그램 진입장벽 — bin 회피 + 막대그래프 대비 강점 Top 3 1. "무엇을 숨기는지" 도입 후킹 — 일상어로 통계량 한계 표현 2. 준비물에 "본인 보고서 1개" 포함 — 적용률 ↑ 3. 학습 목표 1·2의 행동 동사 명확성 한 줄 총평 골격은 탄탄. 시간 배분 표 + 블록 4 워크북 + 블록 3 도입 슬라이드, 세 가지만 추가하면 v0.3 → v1.0 출시 가능 수준.
스킬빌더회고.md인터뷰 3단계 1. 의도 발견 — 반복 업무인지 확인 (one-off는 스킬화하지 않음) 2. 입출력 명세 — 고정 입력 / 기대 출력 / 가변 옵션 3. 규칙·톤·예외 — "이렇게 하지 마라"가 긍정 규칙보다 강력 3대 인사이트 • 톤 가이드가 가장 어려운 입력 — 실제 사례글 분석으로 역추출 • 도메인 비유는 자연스러울 때만 — 억지로 끼우지 말 것 • 스킬 = 사용자 글쓰기 자아의 외부화 한 줄 평 입출력보다 톤·규칙이 더 어려운 입력임을 깨닫게 해주는 에이전트.
gpters 22기 강의자동화 클래스 워크숍("Claude Code Skill·Agent 실전 활용")에 참석했습니다. 핵심 미션은 "본인 도메인 스킬 1개를 skill-creator로 자작해서 가져가기"였는데요, 도로시J 스터디장님께서 미리 깔아두신 5종 스킬(welcome-bulk / handout-1page / lecture-outline / quiz-3jong / feedback-digest)을 테스트해보고 마지막에 본인 스킬 하나를 만들면 워크숍이 완성되는 구조였습니다.
저는 공인중개사이자 동료 공인중개사들을 대상으로 기초 AI 강의도 하고 있는데, 항상 이런 워크숍을 듣고 나면 "이걸 내 강의에 어떻게 박을지" 고민하면서 사례글을 매번 새로 쓰는 게 가장 큰 반복 업무였습니다. 그래서 미션 3의 자작 스킬을 부동산 도메인이 아니라 gpters-case-post — gpters 사례글 작성기로 만들기로 했습니다. 그게 지금 이 글을 쓴 도구입니다. 🙂
전체 흐름은 5단계로 정리됐어요: 🔷 스터디장님 5종 스킬 테스트 → 🔷 미션 3에서 gpters-case-post 자작 → 🔷 에이전트 3종 테스트 → 🔷 8개 결과를 자작 스킬에 입력해 사례글 생성(= 지금 이 글) → 🔷 인터랙티브 HTML 시각화.
핵심 프롬프트 — skill-creator에게 던진 한 문장
"지피터스 사례글 4섹션 포맷에 맞춰서 마크다운 초안을 자동 생성하는 스킬을 만들어줘. 톤은 겸손하고 친절하지만 전문가답게 전체 숲을 보는 시각으로, 의도-과정-인사이트 흐름이고 가끔 가벼운 유머도. 도시아재 글쓰기 보이스로."
이 한 문장으로 시작했지만, 실제로는 인터뷰 3단계를 거쳐 SKILL.md가 완성됐습니다. 실제 gpters 사례글 2건을 WebFetch로 분석해서 톤(존댓말·이모지 박스·분량 1500~3500자)을 역추출해 규칙에 박는 과정이 가장 중요했어요.
✅ 결과 — 12.5시간 → 5분 (▼99%)
💡 배운 점 — 자작 스킬의 진짜 가치는 "한 번 만들고 평생 쓰는 자산"이라는 점입니다. 다음 기수 들을 때도 이 스킬로 사례글 쓸 거고, 다른 강의 듣고 사례글 쓸 때도 같은 스킬. 마치 매물 한 번 잘 등록해두면 여러 플랫폼에서 계속 노출되는 것과 비슷한 느낌이었어요. 🏠
⚠️ 시행착오 3개:
1. 다른 폴더(workspace_test)에서 명령을 쳤다가 30분 헤맸습니다 → 모든 PowerShell 블록 첫 줄에 cd c:\Users\admin\gpters22_workspace 박는 습관.
2. cat으로 한글 SKILL.md를 열었더니 깨짐 (PS 5.1 CP949) → Get-Content -Encoding UTF8 파일명 또는 notepad 파일명.
3. 스터디장님 5종이 이미 깔려 있어 미션 1·2가 처음엔 혼란 → 미션 1·2는 "처음부터 설치"가 아니라 "이미 있는 5종 + 1개 더 추가". 미션 3(자작)이 진짜 본 게임.
🔷 앞으로의 계획 — 다음 강의 사례글에 한 번 더 사용해 안정화 + 미뤄둔 realtor-listing-bulk는 다음 달 본업용으로 / 동료 공인중개사 대상 강의에서 오늘 만든 스킬 그대로 시연.
도로시J 스터디장님 OT 핸드아웃 + 지피터스 AI 스터디 사례글 게시판의 사례글들이 톤 분석의 주된 자료였습니다.
| 작업 | BEFORE (수동) | AFTER (스킬) | 단축 |
|---|---|---|---|
| 환영 메시지 31명 | ≈ 3시간 | 1분◌ 추정 | ▼ 99% |
| 후기 25건 분석 + 카피 | ≈ 2시간 | 1분◌ 추정 | ▼ 99% |
| 핸드아웃 → A4 1장 요약 | ≈ 1시간 | 30초◌ 추정 | ▼ 99% |
| 강의안 퀴즈 13문항 | ≈ 1.5시간 | 30초◌ 추정 | ▼ 99% |
| 6시간 강의 설계안 | ≈ 2시간 | 1분◌ 추정 | ▼ 99% |
| 신청자 31명 페르소나 분석 | ≈ 2시간 | 70.9초✓ 실측 | ▼ 99% |
| 강의안 다단계 검토 | ≈ 1시간 | 63.9초✓ 실측 | ▼ 98% |
| 사례글 4섹션 초안 | ≈ 1시간 | 1분◌ 추정 | ▼ 99% |
duration_ms 기록값 (예: applicant-profiler 70864ms = 70.9초, lecture-reviewer 63872ms = 63.9초).data/reviews.csv 25건 후기 中 유사 작업 언급 시간 (예: 장태민 "주 30명 환영 메시지", 류세아 "주 3시간 카피 작성") (3) 업계 일반 통념. 작업별 분 단위 분해는 시간단축근거.md 참조.
| 항목 | 표시값 (마케팅) | 현실값 (검토 포함) |
|---|---|---|
| 환영 메시지 31명 | 99% (3h → 1min) | 90% (3h → 18min, 검토 17분 포함) |
| 후기 분석 + 카피 | 99% (2h → 1min) | 85% (2h → 18min, 카피 다듬기 17분) |
| 페르소나 분석 | 99% (2h → 70초) | 88% (2h → 15min, 군집 재해석 14분) |
시간단축근거.md에 작업 8개의 분 단위 추정 근거 + BEFORE 데이터 소스 + 검증 방법(누구나 본인 데이터로 재현 가능) 정리.