# 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/claude-skills-factory

This is a Claude Skills collection repository containing:
- **custom-skills/**: 22 custom skills for OurDigital workflows, SEO, GTM, and Jamie Brand
- **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

### General Automation (01-09)

| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 01 | notion-organizer | Notion workspace management | "organize Notion", "노션 정리" |
| 02 | notion-data-migration | Database migration tools | "migrate Notion data" |

### SEO Tools (10-19)

| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 10 | seo-technical-audit | Robots.txt, sitemap, crawlability | "crawlability", "robots.txt", "sitemap" |
| 11 | seo-on-page-audit | Meta tags, headings, links | "on-page SEO", "meta tags" |
| 12 | seo-local-audit | NAP, GBP, citations | "local SEO", "Google Business Profile" |
| 13 | seo-schema-validator | Structured data validation | "validate schema", "JSON-LD" |
| 14 | seo-schema-generator | Schema markup creation | "generate schema", "create JSON-LD" |
| 15 | seo-core-web-vitals | LCP, CLS, FID, INP metrics | "Core Web Vitals", "page speed" |
| 16 | seo-search-console | GSC data analysis | "Search Console", "rankings" |
| 17 | seo-gateway-architect | Gateway page strategy | "SEO strategy", "게이트웨이 전략" |
| 18 | seo-gateway-builder | Gateway page content | "build gateway page" |

### GTM/GA Tools (20-29)

| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 20 | gtm-audit | GTM container audit | "audit GTM", "GTM 검사" |
| 21 | gtm-manager | GTM management + dataLayer | "GTM manager", "dataLayer" |

### OurDigital Channel (30-39)

| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 30 | ourdigital-designer | Visual storytelling, image prompts | "create image prompt", "블로그 이미지" |
| 31 | ourdigital-research | Research → Blog workflow | "research this", "블로그 작성" |
| 32 | ourdigital-presentation | Notion → PPT/Figma | "create presentation" |

### Jamie Clinic (40-49)

| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 40 | jamie-brand-editor | Content **generation** | "write Jamie blog", "제이미 콘텐츠" |
| 41 | jamie-brand-audit | Content **review/evaluation** | "review content", "브랜드 검토" |
| 42 | jamie-instagram-manager | Instagram account management | "Instagram 관리", "인스타 계획" |
| 43 | jamie-youtube-manager | YouTube SEO audit & management | "YouTube SEO", "유튜브 검토" |

## 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
│   └── references/          # Documentation
│
├── desktop/                 # Claude Desktop version
│   ├── SKILL.md             # MCP-focused directive (YAML frontmatter)
│   ├── references/          # Guidance docs
│   └── examples/            # Usage examples
│
└── README.md                # Overview (optional)
```

### Platform Differences

| Aspect | `code/` | `desktop/` |
|--------|---------|------------|
| Directive | CLAUDE.md | SKILL.md (YAML) |
| Execution | Direct Bash/Python | MCP tools only |
| Scripts | Required | Reference only |

### Development Workflow

1. **Build Claude Code version first** - Full automation with scripts
2. **Refactor to Desktop** - Extract guidance, use MCP tools

## 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

## Directory Layout

```
claude-skills-factory/
├── custom-skills/
│   ├── 01-notion-organizer/
│   ├── 02-notion-data-migration/
│   │
│   ├── 10-seo-technical-audit/
│   ├── 11-seo-on-page-audit/
│   ├── 12-seo-local-audit/
│   ├── 13-seo-schema-validator/
│   ├── 14-seo-schema-generator/
│   ├── 15-seo-core-web-vitals/
│   ├── 16-seo-search-console/
│   ├── 17-seo-gateway-architect/
│   ├── 18-seo-gateway-builder/
│   │
│   ├── 20-gtm-audit/
│   ├── 21-gtm-manager/
│   │
│   ├── 30-ourdigital-designer/
│   ├── 31-ourdigital-research/
│   ├── 32-ourdigital-presentation/
│   │
│   ├── 40-jamie-brand-editor/
│   ├── 41-jamie-brand-audit/
│   ├── 42-jamie-instagram-manager/
│   ├── 43-jamie-youtube-manager/
│   │
│   └── _archive/
│
├── example-skills/skills-main/
├── official-skills/
└── reference/
```

## Creating New Skills

Use the skill creator initialization script:
```bash
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
