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

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

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

---

목차

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

설치

# 저장소 복제
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 보일러플레이트 생성
• 듀얼 플랫폼 규칙 자동 적용
• 다음 사용 가능한 스킬 번호 자동 할당

예시:

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로 구동됩니다.

사전 요구사항 (모든 스킬):

pip install notebooklm-py
playwright install chromium
notebooklm login    # 브라우저 기반 Google OAuth

50 — 에이전트

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

기능:

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

예시:

notebooklm ask "AI 도입에 대한 핵심 발견사항은?" --json

51 — 자동화

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

기능:

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

예시:

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분

예시:

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분) 지원
• 논블로킹 작업 및 상태 폴링

예시:

# 빠른 웹 리서치
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 내보내기

예시

# 단일 문서 페이지 빠른 스캔
/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. 새 스킬 만들기

스킬 크리에이터 사용

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

수동 생성

1. 번호 선택 — 위의 번호 규칙에서 사용 가능한 범위 확인
2. 디렉토리 구조 생성:

   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 프론트매터 형식

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

# 스킬 제목

지시서 내용 시작...

슬래시 명령 형식

---
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 인증:

notebooklm login    # 세션이 만료된 경우 재인증

SEO 스킬 Python 오류:

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