From aedfa316baf760e403222b6938539538a9cca3b9 Mon Sep 17 00:00:00 2001 From: Andrew Yim Date: Wed, 10 Dec 2025 18:01:16 +0900 Subject: [PATCH] docs: Update CLAUDE.md with comprehensive skill documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- CLAUDE.md | 86 +++++++++++++++++++++++++++++++++---------------------- 1 file changed, 51 insertions(+), 35 deletions(-) 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