diff --git a/CLAUDE.md b/CLAUDE.md index ce1ff96..532c06e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -7,32 +7,38 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co **GitHub**: https://github.com/ourdigital/our-claude-skills This is a Claude Skills collection repository containing: -- **custom-skills/**: 34 custom skills for OurDigital workflows, SEO, GTM, Jamie Brand, NotebookLM, Reference Curation, and Multi-Agent Collaboration +- **custom-skills/**: 37 custom skills for OurDigital workflows, SEO, GTM, Jamie Brand, NotebookLM, Notion, Reference Curation, and Multi-Agent Collaboration - **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 -### Claude Settings Audit (00) +### Settings & Meta Tools (00) | # | Skill | Purpose | Trigger | |---|-------|---------|---------| -| 00 | our-settings-audit | Error diagnosis & token optimization (8 categories) | "settings audit", "exceed response limit", "MCP error" | +| 00 | our-settings-audit | Claude settings optimization & token audit | "settings audit", "exceed response limit", "MCP error" | -### OurDigital Core Workflows (01-09) +### OurDigital Core (01-10) | # | Skill | Purpose | Trigger | |---|-------|---------|---------| -| 01 | ourdigital-research | Research → Blog workflow | "research this", "blog post" | -| 02 | ourdigital-designer | Visual storytelling, image prompts | "create image prompt", "visual design" | -| 03 | ourdigital-presentation | Notion → PPT/Figma | "create presentation" | +| 01 | ourdigital-brand-guide | Brand standards & writing style reference | "brand guide", "writing style" | +| 02 | ourdigital-blog | Korean blog creation (blog.ourdigital.org) | "write blog post", "블로그 작성" | +| 03 | ourdigital-journal | English essay/article (journal.ourdigital.org) | "write essay", "journal article" | +| 04 | ourdigital-research | Research → Blog workflow | "research this", "blog post" | +| 05 | ourdigital-document | Notion → Presentation workflow | "create document", "Notion export" | +| 06 | ourdigital-designer | Visual storytelling, image prompts | "create image prompt", "visual design" | +| 07 | ourdigital-ad-manager | Ad copywriting & keyword research | "ad copy", "keyword research" | +| 08 | ourdigital-trainer | Training material creation | "create training", "교육 자료" | +| 09 | ourdigital-backoffice | Business document creation | "create proposal", "견적서" | +| 10 | ourdigital-skill-creator | Meta skill for creating skills | "create skill", "init skill" | -### SEO Tools (10-19) +### SEO Tools (11-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" | @@ -41,6 +47,7 @@ This is a Claude Skills collection repository containing: | 16 | seo-search-console | GSC data analysis | "Search Console", "rankings" | | 17 | seo-gateway-architect | Gateway page strategy | "SEO strategy", "gateway pages" | | 18 | seo-gateway-builder | Gateway page content | "build gateway page" | +| 19 | seo-technical-audit | Robots.txt, sitemap, crawlability | "technical SEO", "crawlability" | ### GTM/GA Tools (20-29) @@ -61,11 +68,12 @@ This is a Claude Skills collection repository containing: | # | Skill | Purpose | Trigger | |---|-------|---------|---------| -| 40 | jamie-brand-editor | Content **generation** | "write Jamie blog", "Jamie content" | -| 41 | jamie-brand-audit | Content **review/evaluation** | "review content", "brand audit" | -| 42 | jamie-instagram-manager | Instagram account management | "Instagram management", "IG strategy" | +| 40 | jamie-brand-editor | Branded content generation | "write Jamie blog", "Jamie content" | +| 41 | jamie-brand-audit | Content review/compliance | "review content", "brand audit" | +| 42 | jamie-journal-editor | Clinic journal editing | "Jamie journal", "진료 일지" | | 43 | jamie-youtube-manager | YouTube SEO audit & management | "YouTube SEO", "YT optimization" | | 44 | jamie-youtube-subtitle-checker | YouTube subtitle validation | "check subtitles", "subtitle QA" | +| 45 | jamie-instagram-manager | Instagram account management | "Instagram management", "IG strategy" | ### NotebookLM Tools (50-59) @@ -91,7 +99,7 @@ This is a Claude Skills collection repository containing: |---------|---------| | `/reference-curator-pipeline` | Full pipeline orchestration with QA loop handling | -``` +```bash # Full pipeline from topic /reference-curator-pipeline "Claude Code best practices" --max-sources 5 @@ -102,7 +110,7 @@ This is a Claude Skills collection repository containing: /reference-curator-pipeline "MCP servers" --auto-approve --export-format fine_tuning ``` -**Individual Sub-skills (installed via `./install.sh`):** +**Individual Sub-skills:** | Skill | Command | Purpose | |-------|---------|---------| @@ -112,7 +120,6 @@ This is a Claude Skills collection repository containing: | content-distiller | `/content-distiller` | Summarization & key concept extraction | | quality-reviewer | `/quality-reviewer` | QA loop with approve/refactor/research routing | | markdown-exporter | `/markdown-exporter` | Export to markdown or JSONL for fine-tuning | -| pipeline-orchestrator | `/reference-curator-pipeline` | Full 6-skill workflow orchestration | ## Dual-Platform Skill Structure @@ -123,71 +130,62 @@ XX-skill-name/ ├── code/ # Claude Code version │ ├── CLAUDE.md # Action-oriented directive │ ├── scripts/ # Executable Python/Bash -│ └── references/ # Documentation +│ └── docs/ # Documentation │ ├── desktop/ # Claude Desktop version -│ ├── skill.yaml # Metadata (name, description, allowed-tools, license) -│ ├── SKILL.md # MCP-focused directive (content only, no frontmatter) -│ ├── tools/ # MCP tool documentation & configs -│ │ ├── {tool-name}.md # Tool usage docs (e.g., firecrawl.md) -│ │ └── {tool-name}.yaml # Tool config (optional) -│ ├── references/ # Guidance docs -│ └── examples/ # Usage examples +│ ├── SKILL.md # Skill directive with YAML frontmatter +│ ├── skill.yaml # Extended metadata (optional) +│ └── tools/ # MCP tool documentation │ -└── README.md # Overview (optional) +├── shared/ # Shared resources (optional) +└── README.md # Overview ``` ### Platform Differences | Aspect | `code/` | `desktop/` | |--------|---------|------------| -| Directive | CLAUDE.md | SKILL.md (content) | -| Metadata | In CLAUDE.md | skill.yaml | +| Directive | CLAUDE.md | SKILL.md (with YAML frontmatter) | +| Metadata | In CLAUDE.md | skill.yaml (optional) | | Tool docs | N/A | tools/ directory | | Execution | Direct Bash/Python | MCP tools only | | Scripts | Required | Reference only | -### skill.yaml Schema +### SKILL.md Format (Desktop) -```yaml -# Required fields -name: string # Skill identifier -description: string # Trigger description (can be multi-line with |) +```markdown +--- +name: skill-name-kebab-case +description: | + Brief description of what the skill does. + Triggers: keyword1, keyword2, 한국어 트리거. +--- -# Optional fields -allowed-tools: # List of permitted MCP/Claude tools - - mcp__firecrawl__* - - Read - - Write -license: string # MIT, Internal-use Only, etc. -triggers: [] # Explicit trigger keywords +# Skill Title + +Content starts here... ``` -### 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 ``` our-claude-skills/ ├── custom-skills/ +│ ├── _ourdigital-shared/ # Shared config, installer, dependencies +│ │ │ ├── 00-our-settings-audit/ │ │ -│ ├── 01-ourdigital-research/ -│ ├── 02-ourdigital-designer/ -│ ├── 03-ourdigital-presentation/ +│ ├── 01-ourdigital-brand-guide/ +│ ├── 02-ourdigital-blog/ +│ ├── 03-ourdigital-journal/ +│ ├── 04-ourdigital-research/ +│ ├── 05-ourdigital-document/ +│ ├── 06-ourdigital-designer/ +│ ├── 07-ourdigital-ad-manager/ +│ ├── 08-ourdigital-trainer/ +│ ├── 09-ourdigital-backoffice/ +│ ├── 10-ourdigital-skill-creator/ │ │ -│ ├── 10-seo-technical-audit/ │ ├── 11-seo-on-page-audit/ │ ├── 12-seo-local-audit/ │ ├── 13-seo-schema-validator/ @@ -196,6 +194,7 @@ our-claude-skills/ │ ├── 16-seo-search-console/ │ ├── 17-seo-gateway-architect/ │ ├── 18-seo-gateway-builder/ +│ ├── 19-seo-technical-audit/ │ │ │ ├── 20-gtm-audit/ │ ├── 21-gtm-manager/ @@ -206,32 +205,29 @@ our-claude-skills/ │ │ │ ├── 40-jamie-brand-editor/ │ ├── 41-jamie-brand-audit/ -│ ├── 42-jamie-instagram-manager/ +│ ├── 42-jamie-journal-editor/ │ ├── 43-jamie-youtube-manager/ │ ├── 44-jamie-youtube-subtitle-checker/ +│ ├── 45-jamie-instagram-manager/ │ │ -│ ├── 50-notebooklm-agent/ # Q&A with citations -│ ├── 51-notebooklm-automation/ # Notebook management -│ ├── 52-notebooklm-studio/ # Content generation -│ ├── 53-notebooklm-research/ # Research workflows +│ ├── 50-notebooklm-agent/ +│ ├── 51-notebooklm-automation/ +│ ├── 52-notebooklm-studio/ +│ ├── 53-notebooklm-research/ │ │ │ ├── 90-reference-curator/ # Modular reference documentation suite -│ │ ├── commands/ # Claude Code slash commands │ │ ├── 01-reference-discovery/ │ │ ├── 02-web-crawler-orchestrator/ │ │ ├── 03-content-repository/ │ │ ├── 04-content-distiller/ │ │ ├── 05-quality-reviewer/ │ │ ├── 06-markdown-exporter/ -│ │ ├── 07-pipeline-orchestrator/ # Full pipeline coordination -│ │ ├── shared/ # Config templates & MySQL schema -│ │ └── install.sh # Cross-machine installer +│ │ ├── 07-pipeline-orchestrator/ +│ │ ├── commands/ +│ │ ├── shared/ +│ │ └── install.sh │ │ -│ ├── 91-multi-agent-guide/ # Multi-agent collaboration setup -│ │ ├── SKILL.md # Main skill directive -│ │ ├── templates/ # AGENTS.md, Claude/Gemini/Codex configs -│ │ ├── scripts/ # Ownership validation -│ │ └── examples/ # Minimal setup example +│ ├── 91-multi-agent-guide/ │ │ │ └── 99_archive/ │ @@ -240,10 +236,18 @@ our-claude-skills/ └── reference/ ``` +## 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 + ## Creating New Skills -Use the skill creator initialization script: ```bash +# Use the skill creator python example-skills/skills-main/skill-creator/scripts/init_skill.py --path custom-skills/ ``` @@ -251,5 +255,4 @@ python example-skills/skills-main/skill-creator/scripts/init_skill.py **Internal R&D Repository** - This repository is restricted for internal use only. -A collection of 34 custom Claude Skills for OurDigital workflows, Jamie Plastic Surgery Clinic brand management, SEO/GTM tools, NotebookLM automation, Notion integrations, reference documentation curation, and multi-agent collaboration. +A collection of **37 custom Claude Skills** for OurDigital workflows, Jamie Plastic Surgery Clinic brand management, SEO/GTM tools, NotebookLM automation, Notion integrations, reference documentation curation, and multi-agent collaboration. -## Custom Skills (34 skills) +## Quick Install -### Claude Code Settings (00) +```bash +git clone https://github.com/ourdigital/our-claude-skills.git +cd our-claude-skills/custom-skills/_ourdigital-shared +./install.sh +``` + +## Custom Skills Overview + +### Settings & Meta Tools (00) | # | Skill | Purpose | |---|-------|---------| -| 00 | `claude-code-setting` | Settings optimization & token audit | +| 00 | `our-settings-audit` | Claude settings optimization & token efficiency audit | -### OurDigital Core (01-09) +### OurDigital Core (01-10) | # | Skill | Purpose | |---|-------|---------| -| 01 | `ourdigital-research` | Research → Blog workflow | -| 02 | `ourdigital-designer` | Visual storytelling, image prompts | -| 03 | `ourdigital-presentation` | Notion → PPT/Figma | +| 01 | `ourdigital-brand-guide` | Brand standards, writing style, visual identity reference | +| 02 | `ourdigital-blog` | Korean blog draft creation for blog.ourdigital.org | +| 03 | `ourdigital-journal` | English essay/article creation for journal.ourdigital.org | +| 04 | `ourdigital-research` | Research → Blog workflow | +| 05 | `ourdigital-document` | Notion → Presentation workflow | +| 06 | `ourdigital-designer` | Visual storytelling, image prompts | +| 07 | `ourdigital-ad-manager` | Ad copywriting & keyword research | +| 08 | `ourdigital-trainer` | Training material creation | +| 09 | `ourdigital-backoffice` | Business document creation | +| 10 | `ourdigital-skill-creator` | Meta skill for creating/managing skills | -### SEO Tools (10-19) +### SEO Tools (11-19) | # | Skill | Purpose | |---|-------|---------| -| 10 | `seo-technical-audit` | Robots.txt, sitemap, crawlability | -| 11 | `seo-on-page-audit` | Meta tags, headings, links | -| 12 | `seo-local-audit` | NAP, GBP, citations | +| 11 | `seo-on-page-audit` | Meta tags, headings, links analysis | +| 12 | `seo-local-audit` | NAP consistency, GBP, citations | | 13 | `seo-schema-validator` | Structured data validation | | 14 | `seo-schema-generator` | Schema markup creation | | 15 | `seo-core-web-vitals` | LCP, CLS, FID, INP metrics | | 16 | `seo-search-console` | GSC data analysis | -| 17 | `seo-gateway-architect` | Gateway page strategy | -| 18 | `seo-gateway-builder` | Gateway page content | +| 17 | `seo-gateway-architect` | Gateway page strategy (Naver/Google) | +| 18 | `seo-gateway-builder` | Gateway page content generation | +| 19 | `seo-technical-audit` | Robots.txt, sitemap, crawlability | ### GTM/GA Tools (20-29) | # | Skill | Purpose | |---|-------|---------| -| 20 | `gtm-audit` | GTM container audit | -| 21 | `gtm-manager` | GTM management + dataLayer | +| 20 | `gtm-audit` | GTM container audit with Chrome DevTools | +| 21 | `gtm-manager` | GTM management + dataLayer generation | | 22 | `gtm-guardian` | Live tag monitoring & validation | ### Notion Tools (31-39) @@ -53,20 +68,21 @@ A collection of 34 custom Claude Skills for OurDigital workflows, Jamie Plastic | # | Skill | Purpose | |---|-------|---------| -| 40 | `jamie-brand-editor` | Content generation | -| 41 | `jamie-brand-audit` | Content review/evaluation | -| 42 | `jamie-instagram-manager` | Instagram account management | +| 40 | `jamie-brand-editor` | Branded content generation | +| 41 | `jamie-brand-audit` | Content review/compliance | +| 42 | `jamie-journal-editor` | Clinic journal editing | | 43 | `jamie-youtube-manager` | YouTube SEO audit & management | | 44 | `jamie-youtube-subtitle-checker` | YouTube subtitle validation | +| 45 | `jamie-instagram-manager` | Instagram account management | ### NotebookLM Tools (50-59) | # | Skill | Purpose | |---|-------|---------| -| 50 | `notebooklm-agent` | Q&A agent with source citations | -| 51 | `notebooklm-automation` | Notebook/source management | +| 50 | `notebooklm-agent` | Q&A from notebooks with source citations | +| 51 | `notebooklm-automation` | Notebook/source/artifact management | | 52 | `notebooklm-studio` | Content generation (podcasts, videos, quizzes) | -| 53 | `notebooklm-research` | Web/Drive research workflows | +| 53 | `notebooklm-research` | Web/Drive research & source discovery | **Prerequisites:** `pip install notebooklm-py && playwright install chromium && notebooklm login` @@ -74,12 +90,21 @@ A collection of 34 custom Claude Skills for OurDigital workflows, Jamie Plastic | # | Skill | Purpose | |---|-------|---------| -| 90 | `reference-curator` | Modular skill suite (6 sub-skills) | -| 91 | `multi-agent-guide` | Multi-agent collaboration setup | +| 90 | `reference-curator` | Modular reference documentation suite (6 sub-skills) | +| 91 | `multi-agent-guide` | Multi-agent collaboration setup & guardrails | -**Reference Curator Sub-skills:** `reference-discovery`, `web-crawler-orchestrator`, `content-repository`, `content-distiller`, `quality-reviewer`, `markdown-exporter` +**Reference Curator Sub-skills:** -**Installation:** `cd custom-skills/90-reference-curator && ./install.sh` +| Sub-skill | Purpose | +|-----------|---------| +| `reference-discovery` | Search & validate authoritative sources | +| `web-crawler-orchestrator` | Multi-backend crawling (Firecrawl/Node/aiohttp/Scrapy) | +| `content-repository` | MySQL storage with version tracking | +| `content-distiller` | Summarization & key concept extraction | +| `quality-reviewer` | QA loop with approve/refactor/research routing | +| `markdown-exporter` | Export to markdown or JSONL for fine-tuning | + +**Pipeline Command:** `/reference-curator-pipeline "topic" --max-sources 5` ## Dual-Platform Architecture @@ -90,13 +115,14 @@ XX-skill-name/ ├── code/ # Claude Code version │ ├── CLAUDE.md # Action-oriented directive │ ├── scripts/ # Executable Python/Bash -│ └── references/ # Documentation +│ └── docs/ # Documentation │ ├── desktop/ # Claude Desktop version -│ ├── SKILL.md # MCP-focused directive -│ ├── references/ # Guidance docs -│ └── examples/ # Usage examples +│ ├── SKILL.md # Skill directive with YAML frontmatter +│ ├── skill.yaml # Extended metadata (optional) +│ └── tools/ # MCP tool documentation │ +├── shared/ # Shared resources (optional) └── README.md # Overview ``` @@ -104,34 +130,72 @@ XX-skill-name/ ``` our-claude-skills/ -├── custom-skills/ # 30 custom skills for production use -│ ├── 00-claude-code-setting/ -│ ├── 01-ourdigital-research/ -│ ├── 02-ourdigital-designer/ -│ ├── 03-ourdigital-presentation/ -│ ├── 10-19 (SEO tools) +├── custom-skills/ +│ ├── _ourdigital-shared/ # Shared config, installer, dependencies +│ │ +│ ├── 00-our-settings-audit/ +│ ├── 01-10 (OurDigital core) +│ ├── 11-19 (SEO tools) │ ├── 20-22 (GTM/GA tools) │ ├── 31-32 (Notion tools) -│ ├── 40-44 (Jamie clinic) +│ ├── 40-45 (Jamie clinic) │ ├── 50-53 (NotebookLM tools) -│ ├── 90-reference-curator/ # Reference documentation suite -│ ├── 91-multi-agent-guide/ # Multi-agent collaboration setup +│ ├── 90-reference-curator/ +│ ├── 91-multi-agent-guide/ │ └── 99_archive/ -├── example-skills/ # Anthropic reference examples -├── official-skills/ # 3rd party Notion skills -├── reference/ # Skill format documentation -├── .claude/ # Claude Code commands -│ └── commands/ # Slash command definitions -├── CLAUDE.md # Development guidelines -├── AGENTS.md # Agent routing guide -└── README.md # This file +│ +├── example-skills/ # Anthropic reference examples +├── official-skills/ # 3rd party skills (Notion) +├── reference/ # Skill format documentation +├── .claude/commands/ # Slash command definitions +├── CLAUDE.md # Development guidelines +├── AGENTS.md # Agent routing guide +└── README.md # This file ``` +## Shared Environment + +The `_ourdigital-shared/` directory provides: + +- **install.sh** - Cross-machine installer +- **.env.ourdigital.template** - Environment variables template +- **requirements/** - Python dependencies (base, code) +- **scripts/** - Validation utilities + +### Required Credentials + +| Service | Variable | Purpose | +|---------|----------|---------| +| Notion | `NOTION_API_TOKEN` | Notion API access | +| Ghost Blog | `GHOST_BLOG_ADMIN_KEY` | blog.ourdigital.org | +| Ghost Journal | `GHOST_JOURNAL_ADMIN_KEY` | journal.ourdigital.org | +| Figma | `FIGMA_ACCESS_TOKEN` | Design integration | + ## Usage -Skills are installed in Claude Code or Claude Desktop by adding the skill folder path to settings. +### Claude Code -See `CLAUDE.md` for detailed documentation on skill structure and development guidelines. +Skills are auto-detected via symlinks in `~/.claude/skills/`: + +```bash +# Install skill symlink +ln -sf /path/to/skill/desktop ~/.claude/skills/skill-name +``` + +### Claude Desktop + +Copy the `desktop/SKILL.md` file to your Claude Desktop skills folder. + +## Development + +See `CLAUDE.md` for detailed skill development guidelines and `AGENTS.md` for agent routing recommendations. + +### Creating New Skills + +```bash +# Use the skill creator +python example-skills/skills-main/skill-creator/scripts/init_skill.py --path custom-skills/ +``` ---