diff --git a/CLAUDE.md b/CLAUDE.md index d3be8db..0d4d316 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,11 +4,31 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## Repository Overview +**GitHub**: https://github.com/ourdigital/claude-skills-factory + This is a Claude Skills collection repository containing: -- **ourdigital-custom-skills/**: Organization-specific skills (OurDigital workflows, Jamie Brand, SEO tools) +- **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-skills-collection/**: Notion integration skills and other 3rd party examples -- **reference/**: Format requirements documentation +- **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 @@ -29,12 +49,10 @@ All SKILL.md files MUST start with YAML frontmatter: ```yaml --- name: skill-name-here # lowercase with hyphens, required -version: 1.0.0 # semantic versioning +version: 1.0.0 # semantic versioning, required description: Description # when Claude should use this skill, required -author: Author Name -tags: - - tag1 - - tag2 +license: MIT # or "Internal-use Only" +allowed-tools: Tool1, Tool2 # optional, restrict tool access --- ``` @@ -42,7 +60,7 @@ tags: Use the skill creator initialization script: ```bash -python claude-skills-examples/skills-main/skill-creator/scripts/init_skill.py --path +python claude-skills-examples/skills-main/skill-creator/scripts/init_skill.py --path ourdigital-custom-skills/ ``` Package a skill for distribution: @@ -60,39 +78,37 @@ python claude-skills-examples/skills-main/skill-creator/scripts/package_skill.py 2. **Writing Style**: Use imperative/infinitive form (verb-first), not second person. Write for AI consumption. 3. **Resource Organization**: - - `scripts/` - For repeatedly rewritten or deterministic code - - `references/` - For documentation Claude reads while working (keep >10k word files searchable via grep patterns) - - `assets/` - For output resources (templates, images) not loaded into context + - `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 ``` -ourdigital-custom-skills/ # Production custom skills -├── 00-ourdigital-visual-storytelling/ # Blog featured image prompts -├── 01-ourdigital-research-publisher/ # Research-to-publication workflow -├── 02-notion-organizer/ # Notion workspace management -├── 03-research-to-presentation/ # Research to slides (legacy format) -├── 04-seo-gateway-strategist/ # SEO gateway page planning -├── 05-gateway-page-content-builder/ # Gateway page content generation -├── 20-jamie-brand-editor/ # Jamie Clinic content editor -└── 21-jamie-brand-guardian/ # Jamie Clinic brand compliance - -claude-skills-examples/skills-main/ # Anthropic reference examples -├── skill-creator/ # Meta skill for creating skills -├── document-skills/ # docx, pdf, pptx, xlsx manipulation -├── algorithmic-art/ # p5.js generative art -├── mcp-builder/ # MCP server creation guide -└── webapp-testing/ # Playwright testing - -official-skills-collection/ # 3rd party skills -├── notion-meeting-intelligence/ -├── notion-research-documentation/ -├── notion-knowledge-capture/ -└── notion-spec-to-implementation/ +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` - Comprehensive skill creation guide +- `claude-skills-examples/skills-main/skill-creator/SKILL.md` - Skill creation guide - `claude-skills-examples/skills-main/README.md` - Official skills documentation