our-claude-skills/docs/USER-GUIDE-KO.md

# OurDigital 커스텀 스킬 — 사용자 가이드

> **our-claude-skills** 컬렉션의 52개 커스텀 스킬에 대한 종합 가이드입니다.

---

## 목차

1. [소개](#1-소개)
2. [빠른 시작](#2-빠른-시작)
3. [스킬 카테고리 요약](#3-스킬-카테고리-요약)
4. [OurDigital 코어 (00-10)](#4-ourdigital-코어-00-10)
5. [SEO 도구 (11-34)](#5-seo-도구-11-34)
6. [제이미 클리닉 (40-45)](#6-제이미-클리닉-40-45)
7. [NotebookLM 도구 (50-53)](#7-notebooklm-도구-50-53)
8. [GTM / 애널리틱스 (60-62)](#8-gtm--애널리틱스-60-62)
9. [Notion 도구 (31-32)](#9-notion-도구-31-32)
10. [레퍼런스 큐레이터 (90)](#10-레퍼런스-큐레이터-90)
11. [멀티 에이전트 가이드 (91)](#11-멀티-에이전트-가이드-91)
12. [아키텍처 및 규칙](#12-아키텍처-및-규칙)
13. [새 스킬 만들기](#13-새-스킬-만들기)
14. [문제 해결](#14-문제-해결)

---

## 1. 소개

### 커스텀 스킬이란?

커스텀 스킬은 Claude의 기능을 확장하는 재사용 가능한 도메인별 지시서(directive)입니다. 각 스킬은 Claude에게 특정 작업을 수행하는 방법을 알려줍니다 — OurDigital 브랜드 톤으로 블로그를 작성하거나, SEO 감사를 실행하거나, GTM 컨테이너를 관리하거나, 레퍼런스 문서를 큐레이션하는 작업 등을 포함합니다.

### 두 가지 플랫폼, 하나의 컬렉션

모든 스킬은 **두 개의 독립적인 플랫폼**에서 작동하도록 설계되어 있습니다:

| 플랫폼 | 지시서 파일 | 실행 방식 | 적합한 사용자 |
|--------|-----------|----------|------------|
| **Claude Code** (CLI) | `code/CLAUDE.md` | Bash/Python 직접 실행, 슬래시 명령 | 개발자, 자동화, 스크립팅 |
| **Claude Desktop** (앱) | `desktop/SKILL.md` | MCP 도구만 사용, 대화형 | 비기술 사용자, 가이드 워크플로우 |

두 플랫폼을 모두 사용할 필요는 없습니다. 사용하는 플랫폼에 맞는 지시서를 따르면 됩니다.

### 스킬 호출 방법

**Claude Code** — CLI에서 슬래시 명령을 입력합니다:

```
/seo-technical https://ourdigital.org
/reference-curator "MCP 문서" --depth deep
/notebooklm-studio generate audio "AI 트렌드 요약"
```

**Claude Desktop** — 자연어 트리거를 사용합니다:

```
"ourdigital.org에 대해 기술 SEO 감사를 실행해줘"
"노트북에서 팟캐스트를 만들어줘"
"AI 마케팅에 대한 블로그 포스트를 작성해줘"
```

---

## 2. 빠른 시작

### 사전 요구사항

| 요구사항 | 사용 스킬 | 설치 |
|---------|----------|------|
| Python 3.10+ | SEO 스크립트, NotebookLM | `brew install python` |
| Node.js 18+ | GTM 스크립트, 크롤러 | `brew install node` |
| Firecrawl MCP | 레퍼런스 큐레이터, 크롤링 | Claude Code MCP 설정에서 구성 |
| Notion MCP | Notion 스킬 | Claude Code MCP 설정에서 구성 |
| Ahrefs MCP | SEO 스킬 (11-34) | Claude Code MCP 설정에서 구성 |
| notebooklm-py | NotebookLM 스킬 (50-53) | `pip install notebooklm-py && playwright install chromium` |

### 설치

```bash
# 저장소 복제
git clone https://github.com/ourdigital/our-claude-skills.git
cd our-claude-skills

# (선택) SEO 의존성 설치
pip install -r custom-skills/_ourdigital-shared/requirements/base.txt

# (선택) 레퍼런스 큐레이터 설치
cd custom-skills/90-reference-curator && ./install.sh

# (선택) NotebookLM 설정
pip install notebooklm-py
playwright install chromium
notebooklm login
```

### 슬래시 명령 확인

저장소를 복제하고 Claude Code에서 열면 `.claude/commands/`의 슬래시 명령이 자동으로 사용 가능합니다. Claude Code에서 `/`를 입력하면 전체 목록을 확인할 수 있습니다.

---

## 3. 스킬 카테고리 요약

| 범위 | 도메인 | 개수 | 설명 |
|------|--------|------|------|
| 00 | 설정 및 메타 | 1 | Claude Code 설정 최적화 |
| 01-10 | OurDigital 코어 | 10 | 브랜드, 콘텐츠, 디자인, 비즈니스 도구 |
| 11-34 | SEO | 24 | 기술 감사부터 경영진 리포트까지 |
| 40-45 | 제이미 클리닉 | 5 | 의료 브랜드 콘텐츠 및 소셜 미디어 |
| 50-53 | NotebookLM | 4 | AI 노트북 관리 및 콘텐츠 생성 |
| 60-62 | GTM / 애널리틱스 | 3 | 태그 관리 및 모니터링 |
| 31-32 | Notion | 2 | 워크스페이스 정리 및 콘텐츠 작성 |
| 90 | 레퍼런스 큐레이터 | 1 (6개 하위 스킬) | 문서 큐레이션 파이프라인 |
| 91 | 멀티 에이전트 | 1 | 에이전트 협업 프레임워크 |

**총 52개 스킬** (레퍼런스 큐레이터 하위 스킬 포함)

---

## 4. OurDigital 코어 (00-10)

### 개요

코어 스킬은 브랜드 아이덴티티, 다채널 콘텐츠 생성, 비주얼 디자인, 광고, 교육, 비즈니스 운영을 담당합니다.

### 00 — 설정 감사 (Settings Audit)

| | |
|---|---|
| **목적** | Claude Code 설정 최적화, 토큰 사용량 감사, MCP 오류 진단 |
| **명령** | `/settings-audit` |
| **트리거** | "settings audit", "exceed response limit", "MCP error" |
| **플랫폼** | Code + Desktop |

**기능:**
- `~/.claude/settings.json` 분석 및 최적화 기회 파악
- 토큰 사용 패턴 보고
- MCP 서버 연결 문제 진단
- 권한 및 훅 설정 권장사항 제공

### 01 — 브랜드 가이드

| | |
|---|---|
| **목적** | OurDigital 브랜드 기준, 글쓰기 스타일, 비주얼 아이덴티티 참조 |
| **명령** | `/ourdigital-brand-guide` |
| **트리거** | "brand guide", "writing style", "브랜드 가이드" |
| **플랫폼** | Desktop (슬래시 명령으로 적용) |

**기능:**
- OurDigital "디지털 클리닉" 브랜드 메타포 가이드라인 제공
- 채널별 톤 & 보이스 정의
- 컬러 팔레트, 타이포그래피 (Noto Sans KR, Inter) 규정
- 3대 브랜드 가치 적용: 데이터 중심, 실행 지향, 마케팅 과학

**브랜드 채널:**

| 채널 | 도메인 | 톤 |
|------|--------|-----|
| 메인 사이트 | ourdigital.org | 전문적, 데이터 중심 |
| 블로그 | blog.ourdigital.org | 분석적, 교육적 |
| 저널 | journal.ourdigital.org | 대화체, 시적 |
| 아워스토리 | ourstory.day | 친밀한, 진정성 |
| 기업 | dintelligence.co.kr | 전문적, B2B |

### 02 — 블로그 작성기

| | |
|---|---|
| **목적** | blog.ourdigital.org (Ghost)용 한국어 블로그 작성 |
| **트리거** | "write blog post", "블로그 작성" |
| **플랫폼** | Desktop |

**기능:**
- OurDigital 편집 기준에 따른 한국어 블로그 포스트 작성
- 적절한 제목, 소제목, CTA로 콘텐츠 구조화
- "디지털 클리닉" 분석적 톤 적용
- 게시물당 800-1,200단어 목표

### 03 — 저널 작성기

| | |
|---|---|
| **목적** | journal.ourdigital.org (Ghost)용 영문 에세이/아티클 작성 |
| **트리거** | "write essay", "journal article" |
| **플랫폼** | Desktop |

**기능:**
- 영문 에세이 및 장문 기사 작성
- 저널 채널에 정의된 대화체, 시적 톤 적용
- 개인 서사 및 문화 비평 지원

### 04 — 리서치

| | |
|---|---|
| **목적** | 리서치 → 블로그 워크플로우 |
| **명령** | `/ourdigital-research` |
| **트리거** | "research this", "블로그 리서치" |
| **플랫폼** | Code + Desktop |

**기능:**
- 주어진 주제에 대한 웹 리서치 수행
- 결과를 구조화된 아웃라인으로 정리
- 해당 스킬을 통해 블로그/저널 작성으로 전환 가능

### 05 — 문서/프레젠테이션

| | |
|---|---|
| **목적** | Notion → 프레젠테이션 워크플로우 |
| **명령** | `/ourdigital-presentation` |
| **트리거** | "create document", "프레젠테이션 만들기" |
| **플랫폼** | Code + Desktop |

**기능:**
- Notion 콘텐츠를 프레젠테이션 형식으로 내보내기
- OurDigital 브랜드 비주얼 아이덴티티로 슬라이드 구성
- 한국어/영문 이중 언어 콘텐츠 지원

### 06 — 디자이너

| | |
|---|---|
| **목적** | 비주얼 스토리텔링 및 이미지 프롬프트 생성 |
| **명령** | `/ourdigital-designer` |
| **트리거** | "create image prompt", "비주얼 디자인" |
| **플랫폼** | Code + Desktop |

**기능:**
- AI 이미지 생성기용 상세 이미지 프롬프트 생성
- OurDigital 비주얼 브랜드 가이드라인 준수 (컬러 팔레트, 타이포그래피)
- 블로그 및 소셜 미디어용 비주얼 스토리텔링 컨셉 제작

### 07 — 광고 매니저

| | |
|---|---|
| **목적** | 광고 카피라이팅 및 키워드 리서치 |
| **트리거** | "ad copy", "keyword research", "광고 카피" |
| **플랫폼** | Desktop |

**기능:**
- Google Ads, Meta Ads, Naver Ads용 광고 카피 작성
- 유료 캠페인용 키워드 리서치 수행
- A/B 테스트 변형 생성
- 한국어/영문 광고 카피 지원

### 08 — 트레이너

| | |
|---|---|
| **목적** | 교육 자료 생성 |
| **트리거** | "create training", "교육 자료" |
| **플랫폼** | Desktop |

**기능:**
- 구조화된 교육 자료 및 커리큘럼 생성
- 퀴즈, 연습문제, 평가 기준표 생성
- 한국어/영문 이중 언어 교육 콘텐츠 지원

### 09 — 백오피스

| | |
|---|---|
| **목적** | 비즈니스 문서 생성 |
| **트리거** | "create proposal", "견적서", "invoice" |
| **플랫폼** | Desktop |

**기능:**
- 비즈니스 문서 생성: 제안서, 견적서, 계약서
- OurDigital 기업 브랜딩 적용
- 한국어 비즈니스 문서 규격 지원

### 10 — 스킬 크리에이터

| | |
|---|---|
| **목적** | 새 스킬을 만드는 메타 스킬 |
| **트리거** | "create skill", "init skill" |
| **플랫폼** | Desktop |

**기능:**
- 새 스킬 디렉토리 구조 자동 생성
- `CLAUDE.md` 및 `SKILL.md` 보일러플레이트 생성
- 듀얼 플랫폼 규칙 자동 적용
- 다음 사용 가능한 스킬 번호 자동 할당

**예시:**
```bash
python example-skills/skills-main/skill-creator/scripts/init_skill.py my-new-skill --path custom-skills/
```

---

## 5. SEO 도구 (11-34)

### 개요

SEO 스위트는 가장 큰 스킬 그룹으로, 기술적 크롤 가능성부터 경영진 대시보드까지 모든 것을 다룹니다. 스킬 11-18은 사이트 수준 감사, 19-28은 전략 및 인텔리전스, 29-34는 특수 운영 및 리포팅에 중점을 둡니다.

모든 SEO 스킬은 다음과 통합됩니다:
- **Ahrefs MCP** — 도메인 메트릭, 백링크, 키워드 데이터
- **Notion** — SEO 감사 로그 데이터베이스에 영구 기록
- **Python 스크립트** — 공유 `base_client.py` 패턴 (RateLimiter, ConfigManager, BaseAsyncClient)

### 감사 및 기술 (11-18)

#### 11 — 종합 감사

| | |
|---|---|
| **목적** | 통합 6단계 SEO 감사 오케스트레이터 |
| **트리거** | "comprehensive SEO", "종합 SEO 감사" |

스킬 12-18을 단일 종합 감사로 오케스트레이션합니다. 기술, 온페이지, Core Web Vitals, Search Console, 스키마, 로컬 감사를 순차적으로 실행하여 통합 보고서를 생성합니다.

#### 12 — 기술 감사

| | |
|---|---|
| **목적** | Robots.txt, 사이트맵, 크롤 가능성 분석 |
| **명령** | `/seo-technical` |
| **트리거** | "technical SEO", "크롤 가능성" |

**기능:**
- robots.txt 디렉티브 유효성 검사
- XML 사이트맵 완전성 및 구조 확인
- 크롤 오류 및 리다이렉트 체인 분석
- HTTPS 설정 및 캐노니컬 태그 테스트

#### 13 — 온페이지 감사

| | |
|---|---|
| **목적** | 메타 태그, 헤딩, 내부 링크 분석 |
| **명령** | `/seo-on-page` |
| **트리거** | "on-page SEO", "메타 태그" |

**기능:**
- 타이틀 태그, 메타 디스크립션, 헤딩 계층 구조 분석
- 내부 링크 구조 및 앵커 텍스트 확인
- Open Graph 및 Twitter Card 태그 유효성 검사
- 콘텐츠 품질 신호 검토

#### 14 — Core Web Vitals

| | |
|---|---|
| **목적** | LCP, CLS, FID, INP 성능 지표 |
| **명령** | `/seo-vitals` |
| **트리거** | "Core Web Vitals", "페이지 속도" |

**기능:**
- Largest Contentful Paint (LCP) 측정
- Cumulative Layout Shift (CLS) 측정
- First Input Delay (FID) / Interaction to Next Paint (INP) 측정
- 실행 가능한 최적화 권장사항 제공

#### 15 — Search Console

| | |
|---|---|
| **목적** | Google Search Console 데이터 분석 |
| **명령** | `/seo-gsc` |
| **트리거** | "Search Console", "GSC", "순위" |

**기능:**
- 검색 성능 데이터 분석 (클릭, 노출, CTR, 순위)
- 키워드 기회 및 하락 페이지 식별
- 색인 범위 문제 보고
- 시간에 따른 순위 변화 추적

#### 16 — 스키마 검증기

| | |
|---|---|
| **목적** | 구조화된 데이터 유효성 검사 |
| **명령** | `/seo-schema-validator` |
| **트리거** | "validate schema", "JSON-LD 확인" |

**기능:**
- 기존 JSON-LD, Microdata, RDFa 마크업 유효성 검사
- Google 리치 결과 요구사항 대비 확인
- 누락된 필수 및 권장 속성 보고
- Schema.org 어휘 대비 테스트

#### 17 — 스키마 생성기

| | |
|---|---|
| **목적** | 구조화된 데이터 마크업 생성 |
| **명령** | `/seo-schema-generator` |
| **트리거** | "generate schema", "JSON-LD 생성" |

**기능:**
- 다양한 스키마 타입용 JSON-LD 마크업 생성
- 지원: Article, LocalBusiness, Product, FAQ, HowTo, Organization, BreadcrumbList
- 출력 유효성 검증 후 전달
- 구현 가이드 제공

#### 18 — 로컬 감사

| | |
|---|---|
| **목적** | 로컬 SEO: NAP 일관성, GBP, 인용 |
| **명령** | `/seo-local` |
| **트리거** | "local SEO", "Google Business Profile" |

**기능:**
- 웹 전반에 걸친 NAP (이름-주소-전화번호) 일관성 확인
- Google 비즈니스 프로필 완전성 감사
- 로컬 인용 소스 분석
- 로컬 키워드 타겟팅 검토

### 전략 및 인텔리전스 (19-28)

#### 19 — 키워드 전략

| | |
|---|---|
| **목적** | 키워드 확장, 검색 의도 분류, 클러스터링, 갭 분석 |
| **명령** | `/seo-keyword-strategy` |
| **트리거** | "keyword research", "키워드 전략" |

**기능:**
- Ahrefs 데이터를 활용한 시드 키워드 확장
- 검색 의도 분류 (정보형, 탐색형, 상업적, 거래형)
- 토픽 및 SERP 유사성 기반 키워드 클러스터링
- 경쟁사 대비 콘텐츠 갭 식별

**예시:**
```
/seo-keyword-strategy "디지털 마케팅 서울" --competitors competitor1.com,competitor2.com
```

#### 20 — SERP 분석

| | |
|---|---|
| **목적** | Google/Naver SERP 피처 감지 및 경쟁사 포지션 분석 |
| **명령** | `/seo-serp-analysis` |
| **트리거** | "SERP analysis", "SERP 분석" |

**기능:**
- SERP 피처 감지 (추천 스니펫, PAA, 지식 패널, 로컬 팩)
- 타겟 키워드별 경쟁사 포지셔닝 분석
- Google 및 Naver (네이버) 동시 지원
- SERP 피처 기회 식별

#### 21 — 순위 추적

| | |
|---|---|
| **목적** | 키워드 순위 모니터링, 가시성 점수, 알림 |
| **명령** | `/seo-position-tracking` |
| **트리거** | "rank tracking", "순위 모니터링" |

**기능:**
- 시간에 따른 키워드 순위 모니터링
- 가시성 점수 및 검색 점유율(SOV) 계산
- 순위 변동 시 알림 생성
- 경쟁사 움직임 추적

#### 22 — 링크 빌딩

| | |
|---|---|
| **목적** | 백링크 감사, 유해 링크 감지, 링크 갭 분석 |
| **명령** | `/seo-link-building` |
| **트리거** | "backlink audit", "링크 빌딩" |

**기능:**
- Ahrefs 데이터를 활용한 기존 백링크 프로필 감사
- 디스어보우(disavow)할 유해/스팸 링크 식별
- 경쟁사 대비 링크 갭 기회 발견
- 아웃리치 대상 및 링크 유치 콘텐츠 제안

#### 23 — 콘텐츠 전략

| | |
|---|---|
| **목적** | 콘텐츠 감사, 하락 감지, 콘텐츠 브리프, 토픽 클러스터 |
| **명령** | `/seo-content-strategy` |
| **트리거** | "content strategy", "콘텐츠 전략" |

**기능:**
- 기존 콘텐츠 인벤토리 및 성과 감사
- 콘텐츠 하락(트래픽/순위 감소) 감지
- 키워드 타겟이 포함된 콘텐츠 브리프 생성
- 토픽 클러스터 및 내부 링크 전략 매핑

#### 24 — 이커머스 SEO

| | |
|---|---|
| **목적** | 상품 페이지 감사, Product 스키마 유효성 검사 |
| **명령** | `/seo-ecommerce` |
| **트리거** | "e-commerce SEO", "상품 SEO" |

**기능:**
- 상품 페이지 SEO 요소 감사 (타이틀, 설명, 이미지)
- Product 스키마 마크업 유효성 검사
- 카테고리 페이지 최적화 확인
- 패싯 네비게이션 및 크롤 효율성 검토

#### 25 — KPI 프레임워크

| | |
|---|---|
| **목적** | 통합 SEO KPI, 헬스 스코어, ROI 계산 |
| **명령** | `/seo-kpi-framework` |
| **트리거** | "SEO KPI", "SEO 성과" |

**기능:**
- 모든 감사 차원에 걸친 통합 SEO KPI 정의 및 추적
- 복합 헬스 스코어 계산
- 트래픽 및 전환 데이터 기반 SEO ROI 추정
- 이해관계자 보고용 KPI 대시보드 생성

#### 26 — 국제 SEO

| | |
|---|---|
| **목적** | Hreflang 유효성 검사, 콘텐츠 동등성, 다국어 분석 |
| **명령** | `/seo-international` |
| **트리거** | "international SEO", "hreflang" |

**기능:**
- hreflang 태그 구현 유효성 검사
- 언어 버전 간 콘텐츠 동등성 확인
- 국제 URL 구조 분석 (서브도메인 vs. 서브디렉토리 vs. ccTLD)
- 지역 타겟팅 설정 검토

#### 27 — AI 가시성

| | |
|---|---|
| **목적** | AI 검색 인용, 브랜드 레이더, AI 내 검색 점유율 |
| **명령** | `/seo-ai-visibility` |
| **트리거** | "AI visibility", "AI 검색" |

**기능:**
- AI 생성 검색 결과에서 브랜드 언급 모니터링
- AI 검색(ChatGPT, Perplexity, Google AI Overview)에서의 검색 점유율 추적
- 인용 패턴 및 인용 도메인 분석
- AI 노출 이력 및 트렌드 측정

#### 28 — 지식 그래프

| | |
|---|---|
| **목적** | 엔티티 SEO, 지식 패널 최적화, PAA 분석 |
| **명령** | `/seo-knowledge-graph` |
| **트리거** | "knowledge graph", "엔티티 SEO" |

**기능:**
- Google 지식 그래프에서의 엔티티 존재감 감사
- 지식 패널 노출 최적화
- "사용자가 함께 묻는 질문(PAA)" 기회 분석
- 엔티티 동음이의어 해소 및 구조화된 데이터 연결 검토

### 특수 운영 (29-34)

#### 29 — 게이트웨이 아키텍트

| | |
|---|---|
| **목적** | 게이트웨이 페이지 전략 및 아키텍처 설계 |
| **명령** | `/seo-gateway-architect` |
| **트리거** | "SEO strategy", "게이트웨이 페이지" |

**기능:**
- 타겟 키워드 클러스터에 대한 게이트웨이 페이지 아키텍처 설계
- URL 구조 및 내부 링크 매핑
- 콘텐츠 계층 구조 및 필러-클러스터 관계 계획

#### 30 — 게이트웨이 빌더

| | |
|---|---|
| **목적** | 게이트웨이 페이지 콘텐츠 생성 |
| **명령** | `/seo-gateway-builder` |
| **트리거** | "build gateway page" |

**기능:**
- 아키텍트 블루프린트 기반 최적화된 게이트웨이 페이지 콘텐츠 생성
- 메타 태그, 헤딩, 본문, 내부 링크 포함
- 콘텐츠 구조에 대한 SEO 베스트 프랙티스 준수

#### 31 — 경쟁사 인텔리전스

| | |
|---|---|
| **목적** | 경쟁사 프로파일링, 벤치마킹, 위협 분석 |
| **명령** | `/seo-competitor-intel` |
| **트리거** | "competitor analysis", "경쟁사 분석" |

**기능:**
- Ahrefs 데이터를 활용한 경쟁사 SEO 전략 프로파일링
- 도메인 권한, 트래픽, 키워드 중복도 벤치마킹
- 경쟁 위협 및 기회 식별
- 비교 보고서 생성

#### 32 — 크롤 예산

| | |
|---|---|
| **목적** | 서버 로그 분석, 봇 프로파일링, 크롤 낭비 식별 |
| **명령** | `/seo-crawl-budget` |
| **트리거** | "crawl budget", "로그 분석" |

**기능:**
- 봇 크롤 패턴에 대한 서버 접근 로그 분석
- Googlebot, Bingbot 및 기타 크롤러 행동 프로파일링
- 크롤 낭비 식별 (중복 콘텐츠, Soft 404, 파라미터 URL)
- 크롤 예산 최적화 전략 제안

#### 33 — 마이그레이션 플래너

| | |
|---|---|
| **목적** | 사이트 이전 계획, 리다이렉트 매핑, 리스크 평가 |
| **명령** | `/seo-migration-planner` |
| **트리거** | "site migration", "사이트 이전", "도메인 이전" |

**기능:**
- 이전 전 기준선 스냅샷 생성
- 리다이렉트 매핑 생성 (이전 URL → 새 URL)
- 이전 리스크 요인 평가
- 이전 후 모니터링 체크포인트 계획
- 도메인 이전, CMS 이전, HTTPS 전환, URL 재구성 지원

#### 34 — 리포팅 대시보드

| | |
|---|---|
| **목적** | 경영진 보고서, HTML 대시보드, 데이터 집계 |
| **명령** | `/seo-reporting-dashboard` |
| **트리거** | "SEO report", "SEO 대시보드", "보고서" |

**기능:**
- 모든 SEO 스킬의 데이터를 통합 보고서로 집계
- 핵심 지표 및 트렌드가 포함된 경영진 요약 생성
- 인터랙티브 HTML 대시보드 생성
- 한국어 보고서 요약 지원
- 다양한 형식으로 내보내기 (Markdown, HTML, PDF 준비)

---

## 6. 제이미 클리닉 (40-45)

### 개요

제이미 성형외과 클리닉의 디지털 프레즌스를 위한 스킬입니다. 모든 콘텐츠는 엄격한 의료 브랜드 규정을 준수해야 하며 한국어 콘텐츠를 지원합니다.

#### 40 — 브랜드 에디터

| | |
|---|---|
| **목적** | 제이미 클리닉 브랜드 콘텐츠 생성 |
| **명령** | `/jamie-editor` |
| **트리거** | "Jamie 블로그 작성", "Jamie content" |

**기능:**
- 제이미 브랜드 보이스에 맞는 블로그 및 마케팅 콘텐츠 생성
- 의료 콘텐츠 규정 준수 가이드라인 적용
- 일관된 톤 유지: 전문적이면서도 친근한
- 한국어/영문 콘텐츠 지원

#### 41 — 브랜드 감사

| | |
|---|---|
| **목적** | 콘텐츠 리뷰 및 브랜드 규정 준수 확인 |
| **명령** | `/jamie-audit` |
| **트리거** | "review content", "브랜드 감사" |

**기능:**
- 기존 콘텐츠의 브랜드 일관성 리뷰
- 의료 주장의 규정 준수 여부 확인
- 톤, 용어, 비주얼 브랜드 준수 유효성 검사
- 구체적인 수정 제안이 포함된 규정 준수 보고서 생성

#### 43 — YouTube 매니저

| | |
|---|---|
| **목적** | YouTube 채널 SEO 감사 및 콘텐츠 최적화 |
| **트리거** | "YouTube SEO", "YT 최적화" |

**기능:**
- YouTube 채널 및 동영상 SEO 감사
- 타이틀, 설명, 태그, 썸네일 최적화
- 경쟁사 YouTube 채널 분석
- 비디오 SEO 콘텐츠 전략 제안

#### 44 — 자막 검사기

| | |
|---|---|
| **목적** | YouTube 자막 파일(SBV) 유효성 검사 및 오타 수정 |
| **트리거** | "자막 확인", "subtitle QA" |

**기능:**
- SBV 자막 파일 형식 및 타이밍 유효성 검사
- 한국어/영문 오타 감지 및 수정
- 자막 동기화 확인
- 접근성 규정 준수 확인

#### 45 — Instagram 매니저

| | |
|---|---|
| **목적** | Instagram 계정 관리 및 전략 |
| **트리거** | "Instagram 관리", "IG 전략" |

**기능:**
- Instagram 콘텐츠 캘린더 계획
- 캡션 카피 및 해시태그 전략 생성
- 참여도 지표 분석
- 플랫폼에서의 브랜드 비주얼 일관성 유지

---

## 7. NotebookLM 도구 (50-53)

### 개요

Google NotebookLM 플랫폼을 위한 4가지 전문 스킬로, `notebooklm-py` CLI로 구동됩니다.

**사전 요구사항 (모든 스킬):**
```bash
pip install notebooklm-py
playwright install chromium
notebooklm login    # 브라우저 기반 Google OAuth
```

#### 50 — 에이전트

| | |
|---|---|
| **목적** | Gemini 기반 인용이 포함된 노트북 Q&A |
| **명령** | `/notebooklm-agent` |
| **트리거** | "ask NotebookLM", "노트북 질문" |

**기능:**
- 자연어 질문으로 NotebookLM 노트북 쿼리
- 출처 인용이 포함된 답변 반환
- 프로그래밍 사용을 위한 JSON 출력 지원
- 이름 또는 ID로 특정 노트북 지정 가능

**예시:**
```bash
notebooklm ask "AI 도입에 대한 핵심 발견사항은?" --json
```

#### 51 — 자동화

| | |
|---|---|
| **목적** | 노트북, 소스, 아티팩트의 프로그래밍 방식 관리 |
| **명령** | `/notebooklm-automation` |
| **트리거** | "create notebook", "노트북 관리" |

**기능:**
- 프로그래밍 방식으로 노트북 생성 및 관리
- 노트북에 소스 (URL, 문서, 텍스트) 추가
- 기존 노트북 및 소스 목록 조회 및 관리
- 배치 작업 처리

**예시:**
```bash
notebooklm create "리서치 프로젝트 알파"
notebooklm source add "https://example.com/paper.pdf"
notebooklm list --json
```

#### 52 — 스튜디오

| | |
|---|---|
| **목적** | 콘텐츠 생성: 오디오, 비디오, 퀴즈, 플래시카드, 슬라이드, 마인드맵 |
| **명령** | `/notebooklm-studio` |
| **트리거** | "팟캐스트 만들기", "비디오 생성", "퀴즈 만들기" |

**기능:**
- 오디오 팟캐스트 생성 (deep-dive, brief, critique, debate 형식)
- 비디오 생성 (classic, whiteboard, kawaii, anime, pixel 등 다양한 스타일)
- 노트북 콘텐츠로부터 퀴즈 및 플래시카드 생성
- 슬라이드 덱, 인포그래픽, 마인드맵 생성

**생성 소요 시간:**

| 콘텐츠 유형 | 대략적 소요 시간 |
|-----------|--------------|
| 마인드맵 | 즉시 |
| 퀴즈/플래시카드 | 5-15분 |
| 오디오 팟캐스트 | 10-20분 |
| 비디오 | 15-45분 |

**예시:**
```bash
notebooklm generate audio "AI 윤리에 대한 토론 만들기" --format debate
notebooklm generate video --style whiteboard
notebooklm download audio ./podcast.mp3
```

#### 53 — 리서치

| | |
|---|---|
| **목적** | 웹 및 Google Drive 리서치, 소스 발견 |
| **명령** | `/notebooklm-research` |
| **트리거** | "research topic", "리서치" |

**기능:**
- 웹 리서치 수행 및 결과를 노트북에 자동 임포트
- 관련 문서에 대한 Google Drive 검색
- 빠른 모드 (5-10개 소스, 수 초) 및 심층 모드 (20개 이상 소스, 2-5분) 지원
- 논블로킹 작업 및 상태 폴링

**예시:**
```bash
# 빠른 웹 리서치
notebooklm source add-research "머신러닝 트렌드"

# 심층 리서치 및 자동 임포트
notebooklm source add-research "AI 규제" --mode deep --import-all

# Drive 리서치
notebooklm source add-research "분기 보고서" --from drive
```

---

## 8. GTM / 애널리틱스 (60-62)

### 개요

태그 구현의 감사, 관리, 모니터링을 위한 Google Tag Manager 스킬입니다.

#### 60 — GTM 감사

| | |
|---|---|
| **목적** | GTM 컨테이너 감사 및 분석 |
| **명령** | `/gtm-audit` |
| **트리거** | "audit GTM", "GTM 분석" |

**기능:**
- GTM 컨테이너 설정 감사
- 미사용 또는 손상된 태그 식별
- 트리거 설정 및 실행 규칙 확인
- 변수 정의 및 데이터 레이어 사용 검토
- 권장사항이 포함된 감사 보고서 생성

#### 61 — GTM 매니저

| | |
|---|---|
| **목적** | GTM 관리 및 dataLayer 운영 |
| **명령** | `/gtm-manager` |
| **트리거** | "GTM manager", "dataLayer" |

**기능:**
- GTM 태그, 트리거, 변수 관리
- dataLayer push 이벤트 설정
- GTM 워크스페이스 설정 생성 및 수정
- 배치 태그 작업 지원

#### 62 — GTM 가디언

| | |
|---|---|
| **목적** | 실시간 태그 모니터링 및 유효성 검사 |
| **트리거** | "monitor GTM", "태그 검증" |

**기능:**
- 실시간 태그 발화 모니터링
- 베스트 프랙티스 대비 태그 설정 유효성 검사
- 태그 오류, 지연 발화, 누락 데이터 알림
- GTM 관련 질문에 대한 지식 도우미 역할

---

## 9. Notion 도구 (31-32)

### 개요

Notion 워크스페이스에서 콘텐츠를 관리하고 작성하기 위한 스킬입니다. Notion MCP 통합이 필요합니다.

#### 31 — Notion 오거나이저

| | |
|---|---|
| **목적** | Notion 워크스페이스 관리 및 정리 |
| **명령** | `/notion-organizer` |
| **트리거** | "organize Notion", "워크스페이스 정리" |

**기능:**
- Notion 페이지 및 데이터베이스 정리
- 워크스페이스 구조 정리
- 페이지 속성 및 관계 관리
- Notion 콘텐츠에 대한 배치 작업 지원

#### 32 — Notion 라이터

| | |
|---|---|
| **목적** | 마크다운 콘텐츠를 Notion 페이지 또는 데이터베이스에 푸시 |
| **명령** | `/notion-writer` |
| **트리거** | "Notion에 작성", "Notion으로 내보내기" |

**기능:**
- 마크다운 콘텐츠를 Notion 블록으로 변환
- 지정된 데이터베이스에 새 페이지 생성
- 기존 페이지 콘텐츠 업데이트
- 서식, 헤딩, 코드 블록, 목록 보존

---

## 10. 레퍼런스 큐레이터 (90)

### 개요

웹에서 레퍼런스 문서를 큐레이션, 처리, 내보내기하는 모듈형 파이프라인입니다. 단일 파이프라인 명령으로 오케스트레이션되는 6개의 하위 스킬로 구성됩니다.

### 파이프라인 명령

| | |
|---|---|
| **명령** | `/reference-curator` |
| **목적** | 전체 파이프라인: 발견 → 크롤링 → 저장 → 정제 → 검토 → 내보내기 |

### 입력 모드

| 모드 | 예시 | 파이프라인 시작 |
|------|------|--------------|
| **주제** | `"Claude 시스템 프롬프트"` | 발견 (1단계) |
| **URL** | `https://docs.anthropic.com/...` | 크롤러 (2단계, 발견 건너뜀) |
| **매니페스트** | `./manifest.json` | 크롤러 (재개) |

### 주요 인자

| 인자 | 기본값 | 설명 |
|------|-------|------|
| `--depth` | `standard` | 크롤 깊이: `light`, `standard`, `deep`, `full` |
| `--output` | `~/Documents/reference-library/` | 출력 디렉토리 (생성 시 권한 요청) |
| `--max-sources` | `100` | 발견할 최대 소스 수 |
| `--max-pages` | 깊이에 따라 변동 | 소스당 최대 페이지 수 |
| `--auto-approve` | 꺼짐 | 임계값 이상의 문서 자동 승인 |
| `--threshold` | `0.85` | QA 승인 임계값 |
| `--export-format` | `project_files` | 출력 형식: `project_files`, `fine_tuning`, `jsonl` |

### 깊이 레벨

```
light       ████░░░░░░░░░░░░  ~20 페이지   메인 콘텐츠만         가장 빠름
standard    ████████░░░░░░░░  ~50 페이지   메인 + 링크           빠름
deep        ████████████░░░░  ~150 페이지  전체 페이지 + HTML    보통
full        ████████████████  ~500 페이지  모든 것 + 원본 HTML   느림
```

### 파이프라인 단계

```
1. reference-discovery     권위 있는 소스 검색 및 검증
2. web-crawler             Firecrawl로 페이지 크롤링 (깊이 제어)
3. content-repository      버전 추적과 함께 문서 저장
4. content-distiller       요약 및 핵심 개념 추출
        ↕ QA 루프
5. quality-reviewer        점수 매기기, 승인, 리팩터, 또는 거부
6. markdown-exporter       최종 형식으로 내보내기
```

### 출력 구조

```
~/Documents/reference-library/
├── {토픽-슬러그}/
│   ├── README.md                   # 목차가 있는 인덱스
│   ├── 00-page-name.md             # 개별 페이지 파일
│   ├── 01-page-name.md
│   ├── {토픽-슬러그}-complete.md    # 통합 번들
│   └── manifest.json               # 크롤 메타데이터
├── pipeline_state/                 # 재개 상태
└── exports/                        # 파인튜닝 / JSONL 내보내기
```

### 예시

```bash
# 단일 문서 페이지 빠른 스캔
/reference-curator https://docs.example.com/api --depth light

# 표준 문서 크롤링
/reference-curator "Glossary for WordPress" --max-sources 5

# 전체 페이지 콘텐츠 포함 심층 크롤링
/reference-curator https://docs.codeat.co/glossary/ --depth deep

# 전체 아카이빙 크롤링
/reference-curator https://docs.anthropic.com --depth full --max-pages 300

# 자동 승인 및 파인튜닝 내보내기
/reference-curator "MCP servers" --depth deep --auto-approve --export-format fine_tuning
```

### 하위 스킬 (개별 사용)

| 하위 스킬 | 명령 | 목적 |
|----------|------|------|
| reference-discovery | `/reference-discovery` | 소스 검색 및 검증 |
| web-crawler | `/web-crawler` | 멀티 백엔드 크롤링 |
| content-repository | `/content-repository` | 버전 관리가 있는 MySQL 저장소 |
| content-distiller | `/content-distiller` | 요약 및 추출 |
| quality-reviewer | `/quality-reviewer` | QA 루프 라우팅 |
| markdown-exporter | `/markdown-exporter` | 마크다운/JSONL 내보내기 |

---

## 11. 멀티 에이전트 가이드 (91)

### 개요

Claude Code, Gemini, Codex, 인간 리뷰어가 함께 작업하는 프로젝트를 위한 멀티 에이전트 협업 프레임워크를 설정합니다.

| | |
|---|---|
| **명령** | `/multi-agent-guide` |
| **트리거** | "set up multi-agent", "에이전트 가드레일" |

### 에이전트 계층 구조

```
            ┌─────────────────┐
            │   Claude Code   │
            │   (리드 에이전트)  │
            └────────┬────────┘
                     │
      ┌──────────────┼──────────────┐
      v              v              v
┌──────────┐  ┌──────────┐  ┌──────────┐
│  Gemini  │  │  Codex   │  │   인간   │
│ (리서치)  │  │  (속도)  │  │ (리뷰)  │
└──────────┘  └──────────┘  └──────────┘
```

### 생성되는 파일

```
your-project/
├── .agent-state/
│   ├── tasks.yaml          # 작업 레지스트리
│   └── locks.yaml          # 잠금 레지스트리
├── tools/
│   └── check-ownership.py  # 소유권 검증
├── MULTI_AGENT_FRAMEWORK.md  # 통합 규칙
├── GEMINI.md               # Gemini 에이전트 지시서
└── CODEX.md                # Codex 에이전트 지시서
```

### 커밋 규칙

```
[에이전트] 유형(범위): 설명

[Claude] feat(core): 인증 기능 구현
[Gemini] docs(api): API 문서 업데이트
[Codex] test(models): 단위 테스트 추가
```

---

## 12. 아키텍처 및 규칙

### 듀얼 플랫폼 구조

모든 스킬은 일관된 디렉토리 구조를 따릅니다:

```
XX-skill-name/
├── code/                    # Claude Code 버전
│   ├── CLAUDE.md            # 액션 중심 지시서
│   ├── scripts/             # 실행 가능한 Python/Bash
│   └── docs/                # 문서
│
├── desktop/                 # Claude Desktop 버전
│   ├── SKILL.md             # YAML 프론트매터가 있는 스킬 지시서
│   ├── skill.yaml           # 확장 메타데이터 (선택)
│   └── tools/               # MCP 도구 문서
│
├── shared/                  # 공유 리소스 (선택)
│   ├── references/          # 브랜드 가이드라인, 데이터 파일
│   ├── templates/           # 출력 템플릿
│   └── scripts/             # 공유 스크립트
│
└── README.md                # 스킬 개요
```

### 플랫폼 차이점

| 항목 | `code/` (Claude Code) | `desktop/` (Claude Desktop) |
|------|----------------------|----------------------------|
| 지시서 | CLAUDE.md | SKILL.md (YAML 프론트매터) |
| 실행 | 직접 Bash/Python | MCP 도구만 |
| 스크립트 | 자동화에 필수 | 참조용 |
| 슬래시 명령 | `.claude/commands/*.md` | 해당 없음 |

### 공유 설정

모든 스킬은 다음의 공통 설정을 공유합니다:
```
custom-skills/_ourdigital-shared/
├── config/
│   └── ourdigital.yaml      # 브랜드, 채널, 색상, Notion, 내보내기
├── requirements/
│   └── base.txt             # Python 의존성
└── installer/               # 공유 설정 스크립트
```

### 스킬 번호 규칙

| 범위 | 도메인 | 상태 |
|------|--------|------|
| 00 | 설정 및 메타 | 활성 |
| 01-09 | OurDigital 코어 | 활성 |
| 10 | 스킬 크리에이터 | 활성 |
| 11-34 | SEO 도구 | 활성 |
| 35-39 | SEO (예약) | 사용 가능 |
| 40-49 | 제이미 클리닉 | 활성 (40-45) |
| 50-59 | NotebookLM | 활성 (50-53) |
| 60-69 | GTM/애널리틱스 | 활성 (60-62) |
| 70-89 | 미지정 | 사용 가능 |
| 90-99 | 인프라스트럭처 | 활성 (90-91) |

### 설계 원칙

1. **한 가지를 잘 수행** — 각 스킬은 단일 기능에 집중
2. **지시서 1,500단어 이하** — 간결하고 실행 가능하게
3. **자기 완결성** — 각 플랫폼 버전은 완전히 독립적
4. **코드 우선** — Claude Code 버전을 먼저 만들고, 이후 Desktop
5. **순차적 번호** — 도메인별 논리적 그룹핑

---

## 13. 새 스킬 만들기

### 스킬 크리에이터 사용

```bash
python example-skills/skills-main/skill-creator/scripts/init_skill.py my-new-skill --path custom-skills/
```

### 수동 생성

1. **번호 선택** — 위의 번호 규칙에서 사용 가능한 범위 확인
2. **디렉토리 구조 생성:**
   ```bash
   mkdir -p custom-skills/XX-my-skill/{code,desktop,shared}
   ```
3. **`code/CLAUDE.md` 작성** — Claude Code용 액션 중심 지시서
4. **`desktop/SKILL.md` 작성** — YAML 프론트매터가 있는 대화형 지시서
5. **필요시 스크립트 추가** — `code/scripts/`에 배치
6. **슬래시 명령 생성** — `.claude/commands/my-skill.md`
7. **`CLAUDE.md` 업데이트** — 저장소 루트의 요약 테이블에 스킬 추가

### SKILL.md 프론트매터 형식

```markdown
---
name: my-skill-name
description: |
  스킬이 하는 일에 대한 간단한 설명.
  Triggers: keyword1, keyword2, 한국어 트리거.
---

# 스킬 제목

지시서 내용 시작...
```

### 슬래시 명령 형식

```markdown
---
description: 명령 목록에 표시되는 짧은 설명
argument-hint: <필수-인자> [--선택적 플래그]
allowed-tools: Read, Write, Bash, WebSearch, WebFetch
---

# 스킬 제목

이 명령이 호출될 때 Claude Code에 대한 지침...
```

---

## 14. 문제 해결

### 일반적인 문제

**슬래시 명령이 표시되지 않을 때:**
- Claude Code에서 저장소가 작업 디렉토리로 열려 있는지 확인
- `.claude/commands/*.md` 파일에 유효한 YAML 프론트매터가 있는지 확인
- 명령이 최근에 추가되었다면 Claude Code를 재시작

**MCP 도구 오류:**
- `/settings-audit`를 실행하여 MCP 연결 문제 진단
- Claude Code 설정에서 MCP 서버가 구성되어 있는지 확인
- 환경 변수에 API 키가 설정되어 있는지 확인

**NotebookLM 인증:**
```bash
notebooklm login    # 세션이 만료된 경우 재인증
```

**SEO 스킬 Python 오류:**
```bash
pip install -r custom-skills/_ourdigital-shared/requirements/base.txt
```

**레퍼런스 큐레이터 출력 디렉토리:**
- 기본 출력: `~/Documents/reference-library/`
- 파이프라인은 새 디렉토리 생성 전 권한을 요청합니다
- 스킬 관련 디렉토리에는 출력을 저장하지 않습니다

### 도움 받기

- 저장소: https://github.com/ourdigital/our-claude-skills
- 이슈: https://github.com/ourdigital/our-claude-skills/issues
- 자가 진단: `/settings-audit` 실행

---

*최종 업데이트: 2026-02-24*