our-claude-skills/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

GitHub: https://github.com/ourdigital/our-claude-skills

This is a Claude Skills collection repository containing:

• custom-skills/: 62 custom skills for OurDigital workflows, SEO, GTM, Jamie Brand, NotebookLM, Notion, D.intelligence Agent Corps, Reference Curation, Mac Optimizer, TUI Designer, and Multi-Agent Collaboration
• example-skills/: Reference examples from Anthropic's official skills repository
• official-skills/: Notion integration skills (3rd party)
• reference/: Skill format requirements documentation

Custom Skills Summary

OurDigital Core (01-10)

#	Skill	Purpose	Trigger
01	ourdigital-brand-guide	Brand standards & writing style reference	"brand guide", "writing style"
02	ourdigital-blog	Korean blog creation (blog.ourdigital.org)	"write blog post", "블로그 작성"
03	ourdigital-journal	English essay/article (journal.ourdigital.org)	"write essay", "journal article"
04	ourdigital-research	Research → Blog workflow	"research this", "blog post"
05	ourdigital-document	Notion → Presentation workflow	"create document", "Notion export"
06	ourdigital-designer	Visual storytelling, image prompts	"create image prompt", "visual design"
07	ourdigital-ad-manager	Ad copywriting & keyword research	"ad copy", "keyword research"
08	ourdigital-trainer	Training material creation	"create training", "교육 자료"
09	ourdigital-backoffice	Business document creation	"create proposal", "견적서"
10	ourdigital-skill-creator	Meta skill for creating skills	"create skill", "init skill"

SEO Tools (11-34)

#	Skill	Purpose	Trigger
11	seo-comprehensive-audit	Unified 6-stage SEO audit orchestrator	"comprehensive SEO", "full SEO audit"
12	seo-technical-audit	Robots.txt, sitemap, crawlability	"technical SEO", "crawlability"
13	seo-on-page-audit	Meta tags, headings, links	"on-page SEO", "meta tags"
14	seo-core-web-vitals	LCP, CLS, FID, INP metrics	"Core Web Vitals", "page speed"
15	seo-search-console	GSC data analysis	"Search Console", "rankings"
16	seo-schema-validator	Structured data validation	"validate schema", "JSON-LD"
17	seo-schema-generator	Schema markup creation	"generate schema", "create JSON-LD"
18	seo-local-audit	NAP, GBP, citations	"local SEO", "Google Business Profile"
19	seo-keyword-strategy	Keyword expansion, intent, clustering, gaps	"keyword research", "keyword strategy"
20	seo-serp-analysis	Google/Naver SERP features, competitor positions	"SERP analysis", "SERP features"
21	seo-position-tracking	Rank monitoring, visibility scores, alerts	"rank tracking", "position monitoring"
22	seo-link-building	Backlink audit, toxic links, link gaps	"backlink audit", "link building"
23	seo-content-strategy	Content audit, decay, briefs, clusters	"content strategy", "content audit"
24	seo-ecommerce	Product page audit, product schema	"e-commerce SEO", "product SEO"
25	seo-kpi-framework	Unified KPIs, health scores, ROI	"SEO KPI", "SEO performance"
26	seo-international	Hreflang, content parity, multi-language	"international SEO", "hreflang"
27	seo-ai-visibility	AI search citations, brand radar, SOV	"AI visibility", "AI search"
28	seo-knowledge-graph	Entity SEO, Knowledge Panel, PAA	"knowledge graph", "entity SEO"
29	seo-gateway-architect	Gateway page strategy	"SEO strategy", "gateway pages"
30	seo-gateway-builder	Gateway page content	"build gateway page"
31	seo-competitor-intel	Competitor profiling, benchmarking, threats	"competitor analysis", "competitive intel"
32	seo-crawl-budget	Log analysis, bot profiling, crawl waste	"crawl budget", "log analysis"
33	seo-migration-planner	Site migration planning, redirect mapping	"site migration", "domain move", "사이트 이전"
34	seo-reporting-dashboard	Executive reports, HTML dashboards, aggregation	"SEO report", "SEO dashboard", "보고서"

Notion Tools (31-39)

#	Skill	Purpose	Trigger
31	notion-organizer	Notion workspace management	"organize Notion", "workspace cleanup"
32	notion-writer	Content writing to Notion	"write to Notion", "export to Notion"

Jamie Clinic (40-49)

#	Skill	Purpose	Trigger
40	jamie-brand-editor	Branded content generation	"write Jamie blog", "Jamie content"
41	jamie-brand-audit	Content review/compliance	"review content", "brand audit"
43	jamie-youtube-manager	YouTube SEO audit & management	"YouTube SEO", "YT optimization"
44	jamie-youtube-subtitle-checker	YouTube subtitle validation	"check subtitles", "subtitle QA"
45	jamie-instagram-manager	Instagram account management	"Instagram management", "IG strategy"
46	jamie-journal-editor	Journal/blog content for journal.jamie.clinic	"Jamie journal", "제이미 저널", "진료실 이야기"
47	jamie-marketing-editor	Multi-channel marketing content & ad copy	"Jamie marketing", "제이미 마케팅", "광고 카피"

NotebookLM Tools (50-59)

#	Skill	Purpose	Trigger
50	notebooklm-agent	Q&A from notebooks with citations	"ask NotebookLM", "query notebook", "노트북 질문"
51	notebooklm-automation	Notebook/source/artifact management	"create notebook", "add sources", "노트북 관리"
52	notebooklm-studio	Content generation (podcasts, videos, quizzes)	"create podcast", "generate video", "make quiz", "팟캐스트 만들기"
53	notebooklm-research	Web/Drive research and source discovery	"research topic", "find sources", "리서치"

Prerequisites: pip install notebooklm-py && playwright install chromium && notebooklm login

GTM/GA Tools (60-69)

#	Skill	Purpose	Trigger
60	gtm-audit	GTM audit — page scan, site audit, gap analysis, tag design	"GTM audit", "scan page", "tracking coverage", "gap analysis"
61	gtm-editor	GTM tag/trigger/variable creation via API, ES5 Custom HTML, dataLayer	"create GTM tag", "generate dataLayer", "modify trigger", "manage GTM"
62	gtm-validator	GTM QA — tag firing, trigger testing, naming conventions, cross-platform	"validate tags", "QA GTM", "debug GTM", "naming conventions"

D.intelligence Agent Corps (70-79)

#	Skill	Purpose	Autonomy	Trigger
70	dintel-brand-guardian	Brand compliance review (100pt checklist)	Auto	"brand check", "브랜드 검수"
71	dintel-brand-editor	Brand-compliant copywriting & style evaluation	Auto + Ask	"write copy", "카피 작성"
72	dintel-doc-secretary	Document formatting, meeting notes, reports	Draft & Wait	"format document", "회의록"
73	dintel-quotation-mgr	Quotation generation (4 sub-agents)	Draft & Wait	"견적서", "quotation"
74	dintel-service-architect	Service scope design & module recommendation	Inquiry-driven	"서비스 설계", "service design"
75	dintel-marketing-mgr	Content pipeline (Magazine D., newsletter, LinkedIn)	Draft & Wait	"콘텐츠 발행", "newsletter"
76	dintel-backoffice-mgr	Invoicing, contracts, NDA, HR operations	Draft & Wait	"계약서", "인보이스"
77	dintel-account-mgr	Client relationship management & monitoring	Mixed	"client status", "미팅 준비"
79	dintel-skill-update	Cross-skill consistency management (meta-agent)	Triggered	"skill sync", "스킬 업데이트"

Shared infrastructure: _dintel-shared/ (Python package + reference docs)

Install: cd custom-skills/_dintel-shared && ./install.sh --all

User Guide: custom-skills/_dintel-shared/USER-GUIDE.md

Reference Curator & Multi-Agent (90-91)

#	Skill	Purpose	Trigger
90	reference-curator	Modular skill suite for reference documentation	See sub-skills below
91	multi-agent-guide	Multi-agent collaboration setup	"set up multi-agent", "agent guardrails"

Pipeline Orchestrator (Recommended):

Command	Purpose
/reference-curator	Full pipeline orchestration with QA loop handling

# Full pipeline from topic
/reference-curator "Claude Code best practices" --max-sources 5

# From URLs (skip discovery)
/reference-curator https://docs.anthropic.com/en/docs/prompt-caching

# With auto-approve and fine-tuning output
/reference-curator "MCP servers" --auto-approve --export-format fine_tuning

Individual Sub-skills:

Skill	Command	Purpose
reference-discovery	/reference-discovery	Search & validate authoritative sources
web-crawler	/web-crawler	Multi-backend crawling (Firecrawl/Node/aiohttp/Scrapy)
content-repository	/content-repository	MySQL storage with version tracking
content-distiller	/content-distiller	Summarization & key concept extraction
quality-reviewer	/quality-reviewer	QA loop with approve/refactor/research routing
markdown-exporter	/markdown-exporter	Export to markdown or JSONL for fine-tuning

System & Utility Tools (80-82)

#	Skill	Purpose	Trigger
80	claude-settings-optimizer	Claude settings optimization & token audit	"settings audit", "exceed response limit", "MCP error"
81	mac-optimizer	macOS system health audit & optimization (Claude Code only)	"audit my mac", "system health", "clean up caches", "check security", "update packages"
82	tui-design-template	TUI wizard interface design (Norton Commander / Gopher style, Rich)	"build TUI", "CLI wizard", "terminal UI", "Rich TUI"

Dual-Platform Skill Structure

Each skill has two independent versions:

XX-skill-name/
├── code/                    # Claude Code version
│   ├── CLAUDE.md            # Action-oriented directive
│   ├── scripts/             # Executable Python/Bash
│   └── docs/                # Documentation
│
├── desktop/                 # Claude Desktop version
│   ├── SKILL.md             # Skill directive with YAML frontmatter
│   ├── skill.yaml           # Extended metadata (optional)
│   └── tools/               # MCP tool documentation
│
├── shared/                  # Shared resources (optional)
└── README.md                # Overview

Platform Differences

Aspect	code/	desktop/
Directive	CLAUDE.md	SKILL.md (with YAML frontmatter)
Metadata	In CLAUDE.md	skill.yaml (optional)
Tool docs	N/A	tools/ directory
Execution	Direct Bash/Python	MCP tools only
Scripts	Required	Reference only

SKILL.md Format (Desktop)

---
name: skill-name-kebab-case
description: |
  Brief description of what the skill does.
  Triggers: keyword1, keyword2, 한국어 트리거.
---

# Skill Title

Content starts here...

Directory Layout

our-claude-skills/
├── custom-skills/
│   ├── _ourdigital-shared/         # Shared config, installer, dependencies
│   ├── _dintel-shared/             # D.intelligence shared infra (Python pkg, refs, installer)
│   │
│   ├── 01-ourdigital-brand-guide/
│   ├── 02-ourdigital-blog/
│   ├── 03-ourdigital-journal/
│   ├── 04-ourdigital-research/
│   ├── 05-ourdigital-document/
│   ├── 06-ourdigital-designer/
│   ├── 07-ourdigital-ad-manager/
│   ├── 08-ourdigital-trainer/
│   ├── 09-ourdigital-backoffice/
│   ├── 10-ourdigital-skill-creator/
│   │
│   ├── 11-seo-comprehensive-audit/
│   ├── ...                          # 12-34 (SEO tools)
│   ├── 34-seo-reporting-dashboard/
│   │
│   ├── 31-notion-organizer/
│   ├── 32-notion-writer/
│   │
│   ├── 40-jamie-brand-editor/
│   ├── 41-jamie-brand-audit/
│   ├── 43-jamie-youtube-manager/
│   ├── 44-jamie-youtube-subtitle-checker/
│   ├── 45-jamie-instagram-manager/
│   ├── 46-jamie-journal-editor/
│   ├── 47-jamie-marketing-editor/
│   │
│   ├── 50-notebooklm-agent/
│   ├── 51-notebooklm-automation/
│   ├── 52-notebooklm-studio/
│   ├── 53-notebooklm-research/
│   │
│   ├── 60-gtm-audit/
│   ├── 61-gtm-editor/
│   ├── 62-gtm-validator/
│   │
│   ├── 70-dintel-brand-guardian/
│   ├── 71-dintel-brand-editor/
│   ├── 72-dintel-doc-secretary/
│   ├── 73-dintel-quotation-mgr/
│   ├── 74-dintel-service-architect/
│   ├── 75-dintel-marketing-mgr/
│   ├── 76-dintel-backoffice-mgr/
│   ├── 77-dintel-account-mgr/
│   ├── 79-dintel-skill-update/
│   │
│   ├── 80-claude-settings-optimizer/
│   ├── 81-mac-optimizer/
│   ├── 82-tui-design-template/
│   │
│   ├── 90-reference-curator/       # Modular reference documentation suite
│   │   ├── 01-reference-discovery/
│   │   ├── 02-web-crawler-orchestrator/
│   │   ├── 03-content-repository/
│   │   ├── 04-content-distiller/
│   │   ├── 05-quality-reviewer/
│   │   ├── 06-markdown-exporter/
│   │   ├── 07-pipeline-orchestrator/
│   │   ├── commands/
│   │   ├── shared/
│   │   └── install.sh
│   │
│   └── 91-multi-agent-guide/
│
├── example-skills/skills-main/
├── official-skills/
└── reference/

Skill Design Principles

1. One thing done well - Each skill focuses on a single capability
2. Directives under 1,500 words - Concise, actionable
3. Self-contained - Each platform version is fully independent
4. Code-first development - Build Claude Code version first
5. Progressive numbering - Logical grouping by domain

Creating New Skills

# Use the skill creator
python example-skills/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path custom-skills/

Key Reference Files

• reference/SKILL-FORMAT-REQUIREMENTS.md - Format specification
• example-skills/skills-main/skill-creator/SKILL.md - Skill creation guide
• AGENTS.md - Agent routing guide for Task tool