docs: Update CLAUDE.md with comprehensive skill documentation

- Add GitHub repository URL - Add custom skills summary table with triggers - Clarify Jamie skills role separation (editor vs guardian) - Add version field to YAML frontmatter requirements - Update directory layout with annotations - Add allowed-tools field example 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 18:01:16 +09:00
parent 341d5f5a5b
commit aedfa316ba
1 changed files with 51 additions and 35 deletions
--- 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 <skill-name> --path <output-directory>
+python claude-skills-examples/skills-main/skill-creator/scripts/init_skill.py <skill-name> --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