# 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:
- **ourdigital-custom-skills/**: 8 custom skills for OurDigital workflows, Jamie Brand, SEO tools
- **claude-skills-examples/**: Reference examples from Anthropic's official skills repository
- **official-skils-collection/**: Notion integration skills (3rd party)
- **reference/**: Skill format requirements documentation
- **_jamie-reference-raw-data/**: Source materials for Jamie skills (not part of skills)

## Custom Skills Summary

| # | Skill | Purpose | Trigger |
|---|-------|---------|---------|
| 00 | ourdigital-visual-storytelling | Blog featured image prompts | "create image prompt", "블로그 이미지" |
| 01 | ourdigital-research-publisher | Research → Blog workflow | "research this", "블로그 작성" |
| 02 | notion-organizer | Notion workspace management | "organize Notion", "노션 정리" |
| 03 | research-to-presentation | Notion → PPT/Figma | "create presentation from Notion" |
| 04 | seo-gateway-strategist | SEO gateway page strategy | "SEO strategy", "게이트웨이 전략" |
| 05 | gateway-page-content-builder | Gateway page content generation | "build gateway page" |
| 20 | jamie-brand-editor | Jamie content **generation** | "write Jamie blog", "제이미 콘텐츠 생성" |
| 21 | jamie-brand-guardian | Jamie content **review/evaluation** | "review content", "브랜드 검토" |

### Jamie Skills Role Separation
- **jamie-brand-editor (20)**: Creates NEW branded content from scratch
- **jamie-brand-guardian (21)**: Reviews, corrects, and evaluates EXISTING content

## Skill Structure

Every skill must follow this structure:
```
skill-name/
├── SKILL.md (required)     # YAML frontmatter + instructions
├── scripts/                # Executable code (Python/Bash)
├── references/             # Documentation loaded as needed
├── assets/                 # Templates, images, fonts
├── templates/              # Output templates (HTML, MD)
└── examples/               # Usage examples
```

### SKILL.md Format Requirements

All SKILL.md files MUST start with YAML frontmatter:
```yaml
---
name: skill-name-here      # lowercase with hyphens, required
version: 1.0.0             # semantic versioning, required
description: Description   # when Claude should use this skill, required
license: MIT               # or "Internal-use Only"
allowed-tools: Tool1, Tool2  # optional, restrict tool access
---
```

## Creating New Skills

Use the skill creator initialization script:
```bash
python claude-skills-examples/skills-main/skill-creator/scripts/init_skill.py <skill-name> --path ourdigital-custom-skills/
```

Package a skill for distribution:
```bash
python claude-skills-examples/skills-main/skill-creator/scripts/package_skill.py <path/to/skill-folder>
```

## Skill Design Principles

1. **Progressive Disclosure**: Skills use three-level loading:
   - Metadata (name + description) - always in context (~100 words)
   - SKILL.md body - when skill triggers (<5k words)
   - Bundled resources - as needed by Claude

2. **Writing Style**: Use imperative/infinitive form (verb-first), not second person. Write for AI consumption.

3. **Resource Organization**:
   - `scripts/` - Executable code (Python/Bash/JS)
   - `references/` - Documentation Claude reads while working
   - `templates/` - Output templates (HTML, MD, CSS)
   - `assets/` - Resources (images, fonts) not loaded into context
   - `examples/` - Usage examples and sample outputs

## Directory Layout

```
claude-skills-factory/
├── ourdigital-custom-skills/        # 8 custom skills
│   ├── 00-ourdigital-visual-storytelling/
│   ├── 01-ourdigital-research-publisher/
│   ├── 02-notion-organizer/
│   ├── 03-research-to-presentation/
│   ├── 04-seo-gateway-strategist/
│   ├── 05-gateway-page-content-builder/
│   ├── 20-jamie-brand-editor/       # Content GENERATION
│   └── 21-jamie-brand-guardian/     # Content REVIEW
├── claude-skills-examples/skills-main/  # Anthropic examples
│   ├── skill-creator/
│   ├── document-skills/
│   ├── algorithmic-art/
│   └── ...
├── official-skils-collection/       # 3rd party Notion skills
├── reference/                       # Format documentation
└── _jamie-reference-raw-data/       # Jamie source materials
```

## Key Reference Files

- `reference/SKILL-FORMAT-REQUIREMENTS.md` - Format specification
- `claude-skills-examples/skills-main/skill-creator/SKILL.md` - Skill creation guide
- `claude-skills-examples/skills-main/README.md` - Official skills documentation