diff --git a/.claude/commands/gtm-audit.md b/.claude/commands/gtm-audit.md index bd74326..4bc903a 100644 --- a/.claude/commands/gtm-audit.md +++ b/.claude/commands/gtm-audit.md @@ -20,11 +20,11 @@ Lightweight Google Tag Manager audit tool. ```bash # Audit GTM container -python custom-skills/20-gtm-audit/code/scripts/gtm_audit.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/20-gtm-audit/code/scripts/gtm_audit.py \ --url https://example.com # With detailed dataLayer check -python custom-skills/20-gtm-audit/code/scripts/gtm_audit.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/20-gtm-audit/code/scripts/gtm_audit.py \ --url https://example.com --check-datalayer --output report.json ``` diff --git a/.claude/commands/gtm-manager.md b/.claude/commands/gtm-manager.md index d6ded28..f2c4dcc 100644 --- a/.claude/commands/gtm-manager.md +++ b/.claude/commands/gtm-manager.md @@ -20,15 +20,15 @@ Full GTM management with dataLayer injection and tag generation. ```bash # Full GTM management -python custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \ --url https://example.com --full-audit # Generate dataLayer tag -python custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \ --generate-tag purchase --output purchase_tag.html # Export to Notion -python custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \ --url https://example.com --notion-export --database DATABASE_ID ``` diff --git a/.claude/commands/jamie-editor.md b/.claude/commands/jamie-editor.md index 0f7623a..4d616b2 100644 --- a/.claude/commands/jamie-editor.md +++ b/.claude/commands/jamie-editor.md @@ -21,15 +21,15 @@ Jamie Clinic content **generation** toolkit. ```bash # Check content compliance -python custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \ --input draft.md # With detailed report -python custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \ --input draft.md --verbose --output report.json # Batch check -python custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \ --dir ./drafts --output compliance_report.json ``` diff --git a/.claude/commands/multi-agent-guide.md b/.claude/commands/multi-agent-guide.md index 3fbe61a..440468f 100644 --- a/.claude/commands/multi-agent-guide.md +++ b/.claude/commands/multi-agent-guide.md @@ -67,5 +67,5 @@ Examples: 3. Install pre-commit hooks: `pre-commit install` (optional) ## Source -Full details: `custom-skills/91-multi-agent-guide/README.md` -Related commands: `custom-skills/91-multi-agent-guide/commands/` +Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/91-multi-agent-guide/README.md` +Related commands: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/91-multi-agent-guide/commands/` diff --git a/.claude/commands/notebooklm-agent.md b/.claude/commands/notebooklm-agent.md index 13a8f6e..6afe046 100644 --- a/.claude/commands/notebooklm-agent.md +++ b/.claude/commands/notebooklm-agent.md @@ -59,4 +59,4 @@ notebooklm ask "Compare" -s source1 -s source2 | Auth error | `notebooklm login` | ## Source -Full details: `custom-skills/50-notebooklm-agent/code/CLAUDE.md` +Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/50-notebooklm-agent/code/CLAUDE.md` diff --git a/.claude/commands/notebooklm-automation.md b/.claude/commands/notebooklm-automation.md index 6a75731..713d5c3 100644 --- a/.claude/commands/notebooklm-automation.md +++ b/.claude/commands/notebooklm-automation.md @@ -54,4 +54,4 @@ notebooklm artifact delete **Ask first:** `delete`, `rename` ## Source -Full details: `custom-skills/51-notebooklm-automation/code/CLAUDE.md` +Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/51-notebooklm-automation/code/CLAUDE.md` diff --git a/.claude/commands/notebooklm-research.md b/.claude/commands/notebooklm-research.md index eb93111..7885f4a 100644 --- a/.claude/commands/notebooklm-research.md +++ b/.claude/commands/notebooklm-research.md @@ -63,4 +63,4 @@ Task( **Ask first:** `source add-research`, `research wait --import-all` ## Source -Full details: `custom-skills/53-notebooklm-research/code/CLAUDE.md` +Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/53-notebooklm-research/code/CLAUDE.md` diff --git a/.claude/commands/notebooklm-studio.md b/.claude/commands/notebooklm-studio.md index 287845b..439f775 100644 --- a/.claude/commands/notebooklm-studio.md +++ b/.claude/commands/notebooklm-studio.md @@ -70,4 +70,4 @@ notebooklm download mind-map ./mindmap.json **Ask first:** `generate *`, `download *` ## Source -Full details: `custom-skills/52-notebooklm-studio/code/CLAUDE.md` +Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/52-notebooklm-studio/code/CLAUDE.md` diff --git a/.claude/commands/notion-organizer.md b/.claude/commands/notion-organizer.md index 59e51bc..6f4cac5 100644 --- a/.claude/commands/notion-organizer.md +++ b/.claude/commands/notion-organizer.md @@ -20,15 +20,15 @@ Notion workspace management agent for organizing, restructuring, and maintaining ```bash # Analyze database schema -python custom-skills/01-notion-organizer/code/scripts/schema_migrator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/01-notion-organizer/code/scripts/schema_migrator.py \ --source-db DATABASE_ID --analyze # Migrate with mapping -python custom-skills/01-notion-organizer/code/scripts/schema_migrator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/01-notion-organizer/code/scripts/schema_migrator.py \ --source-db SOURCE_ID --target-db TARGET_ID --mapping mapping.json # Async bulk operations -python custom-skills/01-notion-organizer/code/scripts/async_organizer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/01-notion-organizer/code/scripts/async_organizer.py \ --database DATABASE_ID --operation archive --filter "Status=Done" ``` diff --git a/.claude/commands/notion-writer.md b/.claude/commands/notion-writer.md index f8af2bd..d4ed1aa 100644 --- a/.claude/commands/notion-writer.md +++ b/.claude/commands/notion-writer.md @@ -60,4 +60,4 @@ Headings, bulleted/numbered lists, to-do items, quotes, code blocks (with langua The script automatically batches large content. ## Source -Full details: `custom-skills/32-notion-writer/code/CLAUDE.md` +Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/32-notion-writer/code/CLAUDE.md` diff --git a/.claude/commands/ourdigital-brand-guide.md b/.claude/commands/ourdigital-brand-guide.md index a69b60a..5139248 100644 --- a/.claude/commands/ourdigital-brand-guide.md +++ b/.claude/commands/ourdigital-brand-guide.md @@ -66,4 +66,4 @@ Reference skill for OurDigital brand standards, writing style, and visual identi 5. **Visual Consistency**: Uses approved color palette? ## Source -Full details: `custom-skills/01-ourdigital-brand-guide/desktop/SKILL.md` +Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/01-ourdigital-brand-guide/desktop/SKILL.md` diff --git a/.claude/commands/ourdigital-designer.md b/.claude/commands/ourdigital-designer.md index 5a02caa..95d99c2 100644 --- a/.claude/commands/ourdigital-designer.md +++ b/.claude/commands/ourdigital-designer.md @@ -20,15 +20,15 @@ Visual storytelling toolkit for blog featured images. ```bash # Generate image prompt -python custom-skills/30-ourdigital-designer/code/scripts/generate_prompt.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/30-ourdigital-designer/code/scripts/generate_prompt.py \ --topic "AI identity" --mood "contemplative" # From essay text -python custom-skills/30-ourdigital-designer/code/scripts/generate_prompt.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/30-ourdigital-designer/code/scripts/generate_prompt.py \ --input essay.txt --auto-extract # Calibrate mood -python custom-skills/30-ourdigital-designer/code/scripts/mood_calibrator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/30-ourdigital-designer/code/scripts/mood_calibrator.py \ --input "essay excerpt" --style "minimalist" ``` diff --git a/.claude/commands/ourdigital-presentation.md b/.claude/commands/ourdigital-presentation.md index 5009417..3f2a3ef 100644 --- a/.claude/commands/ourdigital-presentation.md +++ b/.claude/commands/ourdigital-presentation.md @@ -20,13 +20,13 @@ Notion-to-presentation workflow for branded slides. ```bash # Full automated workflow -python custom-skills/32-ourdigital-presentation/code/scripts/run_workflow.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-ourdigital-presentation/code/scripts/run_workflow.py \ --notion-url [NOTION_URL] --output presentation.pptx # Step-by-step -python custom-skills/32-ourdigital-presentation/code/scripts/extract_notion.py [URL] > research.json -python custom-skills/32-ourdigital-presentation/code/scripts/synthesize_content.py research.json > synthesis.json -python custom-skills/32-ourdigital-presentation/code/scripts/apply_brand.py synthesis.json --output presentation.pptx +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-ourdigital-presentation/code/scripts/extract_notion.py [URL] > research.json +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-ourdigital-presentation/code/scripts/synthesize_content.py research.json > synthesis.json +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-ourdigital-presentation/code/scripts/apply_brand.py synthesis.json --output presentation.pptx ``` ## Pipeline diff --git a/.claude/commands/ourdigital-research.md b/.claude/commands/ourdigital-research.md index 446b603..80580df 100644 --- a/.claude/commands/ourdigital-research.md +++ b/.claude/commands/ourdigital-research.md @@ -20,17 +20,17 @@ Research-to-publication workflow for OurDigital blogs. ```bash # Export to Ulysses -python custom-skills/31-ourdigital-research/code/scripts/export_to_ulysses.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/31-ourdigital-research/code/scripts/export_to_ulysses.py \ --input research.md --group "Blog Drafts" # With tags -python custom-skills/31-ourdigital-research/code/scripts/export_to_ulysses.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/31-ourdigital-research/code/scripts/export_to_ulysses.py \ --input research.md \ --group "Blog Drafts" \ --tags "AI,research,draft" # From Notion export -python custom-skills/31-ourdigital-research/code/scripts/export_to_ulysses.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/31-ourdigital-research/code/scripts/export_to_ulysses.py \ --notion-export notion_export.zip \ --group "From Notion" ``` diff --git a/.claude/commands/reference-curator.md b/.claude/commands/reference-curator.md index 7563838..1ed744e 100644 --- a/.claude/commands/reference-curator.md +++ b/.claude/commands/reference-curator.md @@ -225,9 +225,9 @@ firecrawl_crawl: ## Related Sub-commands -Individual stages available at: `custom-skills/90-reference-curator/commands/` +Individual stages available at: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/90-reference-curator/commands/` - `/reference-discovery`, `/web-crawler`, `/content-repository` - `/content-distiller`, `/quality-reviewer`, `/markdown-exporter` ## Source -Full details: `custom-skills/90-reference-curator/README.md` +Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/90-reference-curator/README.md` diff --git a/.claude/commands/seo-ai-visibility.md b/.claude/commands/seo-ai-visibility.md index f18298b..c1c32cb 100644 --- a/.claude/commands/seo-ai-visibility.md +++ b/.claude/commands/seo-ai-visibility.md @@ -22,35 +22,35 @@ Track brand visibility in AI-generated search answers with citation analysis and ```bash # AI visibility overview -python custom-skills/27-seo-ai-visibility/code/scripts/ai_visibility_tracker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/27-seo-ai-visibility/code/scripts/ai_visibility_tracker.py \ --target example.com --json # With competitor comparison -python custom-skills/27-seo-ai-visibility/code/scripts/ai_visibility_tracker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/27-seo-ai-visibility/code/scripts/ai_visibility_tracker.py \ --target example.com --competitor comp1.com --competitor comp2.com --json # Historical trend (impressions/mentions) -python custom-skills/27-seo-ai-visibility/code/scripts/ai_visibility_tracker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/27-seo-ai-visibility/code/scripts/ai_visibility_tracker.py \ --target example.com --history --json # Share of voice analysis -python custom-skills/27-seo-ai-visibility/code/scripts/ai_visibility_tracker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/27-seo-ai-visibility/code/scripts/ai_visibility_tracker.py \ --target example.com --sov --json # AI citation analysis -python custom-skills/27-seo-ai-visibility/code/scripts/ai_citation_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/27-seo-ai-visibility/code/scripts/ai_citation_analyzer.py \ --target example.com --json # Cited domains analysis -python custom-skills/27-seo-ai-visibility/code/scripts/ai_citation_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/27-seo-ai-visibility/code/scripts/ai_citation_analyzer.py \ --target example.com --cited-domains --json # Cited pages analysis -python custom-skills/27-seo-ai-visibility/code/scripts/ai_citation_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/27-seo-ai-visibility/code/scripts/ai_citation_analyzer.py \ --target example.com --cited-pages --json # AI response content analysis -python custom-skills/27-seo-ai-visibility/code/scripts/ai_citation_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/27-seo-ai-visibility/code/scripts/ai_citation_analyzer.py \ --target example.com --responses --json ``` diff --git a/.claude/commands/seo-competitor-intel.md b/.claude/commands/seo-competitor-intel.md index 5009b69..ad4c17f 100644 --- a/.claude/commands/seo-competitor-intel.md +++ b/.claude/commands/seo-competitor-intel.md @@ -23,23 +23,23 @@ Competitor profiling, benchmarking, and threat scoring for comprehensive SEO com ```bash # Auto-discover and profile competitors -python custom-skills/31-seo-competitor-intel/code/scripts/competitor_profiler.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/31-seo-competitor-intel/code/scripts/competitor_profiler.py \ --target https://example.com --json # Specify competitors manually -python custom-skills/31-seo-competitor-intel/code/scripts/competitor_profiler.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/31-seo-competitor-intel/code/scripts/competitor_profiler.py \ --target https://example.com --competitor https://comp1.com --competitor https://comp2.com --json # Include Korean market analysis -python custom-skills/31-seo-competitor-intel/code/scripts/competitor_profiler.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/31-seo-competitor-intel/code/scripts/competitor_profiler.py \ --target https://example.com --korean-market --json # 30-day competitive monitoring -python custom-skills/31-seo-competitor-intel/code/scripts/competitive_monitor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/31-seo-competitor-intel/code/scripts/competitive_monitor.py \ --target https://example.com --period 30 --json # Traffic trend comparison (90 days) -python custom-skills/31-seo-competitor-intel/code/scripts/competitive_monitor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/31-seo-competitor-intel/code/scripts/competitive_monitor.py \ --target https://example.com --scope traffic --period 90 --json ``` diff --git a/.claude/commands/seo-content-strategy.md b/.claude/commands/seo-content-strategy.md index 3ae372a..1f9e8df 100644 --- a/.claude/commands/seo-content-strategy.md +++ b/.claude/commands/seo-content-strategy.md @@ -23,27 +23,27 @@ Content inventory, performance scoring, decay detection, topic gap analysis, clu ```bash # Full content audit -python custom-skills/23-seo-content-strategy/code/scripts/content_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/23-seo-content-strategy/code/scripts/content_auditor.py \ --url https://example.com --json # Detect decaying content -python custom-skills/23-seo-content-strategy/code/scripts/content_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/23-seo-content-strategy/code/scripts/content_auditor.py \ --url https://example.com --decay --json # Filter by content type -python custom-skills/23-seo-content-strategy/code/scripts/content_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/23-seo-content-strategy/code/scripts/content_auditor.py \ --url https://example.com --type blog --json # Content gap analysis with topic clusters -python custom-skills/23-seo-content-strategy/code/scripts/content_gap_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/23-seo-content-strategy/code/scripts/content_gap_analyzer.py \ --target https://example.com --competitor https://comp1.com --clusters --json # Generate content brief for keyword -python custom-skills/23-seo-content-strategy/code/scripts/content_brief_generator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/23-seo-content-strategy/code/scripts/content_brief_generator.py \ --keyword "치과 임플란트 비용" --url https://example.com --json # Brief with competitor analysis -python custom-skills/23-seo-content-strategy/code/scripts/content_brief_generator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/23-seo-content-strategy/code/scripts/content_brief_generator.py \ --keyword "dental implant cost" --url https://example.com --competitors 5 --json ``` diff --git a/.claude/commands/seo-crawl-budget.md b/.claude/commands/seo-crawl-budget.md index a64ad0f..b4d9daa 100644 --- a/.claude/commands/seo-crawl-budget.md +++ b/.claude/commands/seo-crawl-budget.md @@ -22,27 +22,27 @@ Server access log analysis, bot profiling, and crawl budget waste identification ```bash # Parse Nginx access log -python custom-skills/32-seo-crawl-budget/code/scripts/log_parser.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-seo-crawl-budget/code/scripts/log_parser.py \ --log-file /var/log/nginx/access.log --json # Parse Apache log, filter by Googlebot -python custom-skills/32-seo-crawl-budget/code/scripts/log_parser.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-seo-crawl-budget/code/scripts/log_parser.py \ --log-file /var/log/apache2/access.log --format apache --bot googlebot --json # Parse gzipped log in streaming mode -python custom-skills/32-seo-crawl-budget/code/scripts/log_parser.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-seo-crawl-budget/code/scripts/log_parser.py \ --log-file access.log.gz --streaming --json # Full crawl budget analysis with sitemap comparison -python custom-skills/32-seo-crawl-budget/code/scripts/crawl_budget_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-seo-crawl-budget/code/scripts/crawl_budget_analyzer.py \ --log-file access.log --sitemap https://example.com/sitemap.xml --json # Waste identification only -python custom-skills/32-seo-crawl-budget/code/scripts/crawl_budget_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-seo-crawl-budget/code/scripts/crawl_budget_analyzer.py \ --log-file access.log --scope waste --json # Orphan page detection -python custom-skills/32-seo-crawl-budget/code/scripts/crawl_budget_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/32-seo-crawl-budget/code/scripts/crawl_budget_analyzer.py \ --log-file access.log --sitemap https://example.com/sitemap.xml --scope orphans --json ``` diff --git a/.claude/commands/seo-ecommerce.md b/.claude/commands/seo-ecommerce.md index 37528b8..5e2f5b5 100644 --- a/.claude/commands/seo-ecommerce.md +++ b/.claude/commands/seo-ecommerce.md @@ -23,27 +23,27 @@ Product page SEO audit, product schema validation, category taxonomy analysis, a ```bash # Full e-commerce SEO audit -python custom-skills/24-seo-ecommerce/code/scripts/ecommerce_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/24-seo-ecommerce/code/scripts/ecommerce_auditor.py \ --url https://example.com --json # Product page audit only -python custom-skills/24-seo-ecommerce/code/scripts/ecommerce_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/24-seo-ecommerce/code/scripts/ecommerce_auditor.py \ --url https://example.com --scope products --json # Category taxonomy analysis -python custom-skills/24-seo-ecommerce/code/scripts/ecommerce_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/24-seo-ecommerce/code/scripts/ecommerce_auditor.py \ --url https://example.com --scope categories --json # Korean marketplace presence check -python custom-skills/24-seo-ecommerce/code/scripts/ecommerce_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/24-seo-ecommerce/code/scripts/ecommerce_auditor.py \ --url https://example.com --korean-marketplaces --json # Validate product schema on single page -python custom-skills/24-seo-ecommerce/code/scripts/product_schema_checker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/24-seo-ecommerce/code/scripts/product_schema_checker.py \ --url https://example.com/product/123 --json # Batch validate from sitemap (sample 50 pages) -python custom-skills/24-seo-ecommerce/code/scripts/product_schema_checker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/24-seo-ecommerce/code/scripts/product_schema_checker.py \ --sitemap https://example.com/product-sitemap.xml --sample 50 --json ``` diff --git a/.claude/commands/seo-gateway-architect.md b/.claude/commands/seo-gateway-architect.md index bc8817c..f06b080 100644 --- a/.claude/commands/seo-gateway-architect.md +++ b/.claude/commands/seo-gateway-architect.md @@ -20,11 +20,11 @@ Keyword strategy and content architecture for gateway pages. ```bash # Analyze keyword -python custom-skills/29-seo-gateway-architect/code/scripts/keyword_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/29-seo-gateway-architect/code/scripts/keyword_analyzer.py \ --topic "눈 성형" # With location targeting -python custom-skills/29-seo-gateway-architect/code/scripts/keyword_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/29-seo-gateway-architect/code/scripts/keyword_analyzer.py \ --topic "눈 성형" --market "강남" --output strategy.json ``` diff --git a/.claude/commands/seo-gateway-builder.md b/.claude/commands/seo-gateway-builder.md index 855948d..c8d7605 100644 --- a/.claude/commands/seo-gateway-builder.md +++ b/.claude/commands/seo-gateway-builder.md @@ -20,10 +20,10 @@ Generate SEO-optimized gateway pages from templates. ```bash # Generate with sample data -python custom-skills/30-seo-gateway-builder/code/scripts/generate_pages.py +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/30-seo-gateway-builder/code/scripts/generate_pages.py # Custom configuration -python custom-skills/30-seo-gateway-builder/code/scripts/generate_pages.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/30-seo-gateway-builder/code/scripts/generate_pages.py \ --config config/services.json \ --locations config/locations.json \ --output ./pages diff --git a/.claude/commands/seo-gsc.md b/.claude/commands/seo-gsc.md index 817b69b..cb4e1c8 100644 --- a/.claude/commands/seo-gsc.md +++ b/.claude/commands/seo-gsc.md @@ -20,15 +20,15 @@ Google Search Console data retrieval and analysis. ```bash # Get search performance -python custom-skills/15-seo-search-console/code/scripts/gsc_client.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/15-seo-search-console/code/scripts/gsc_client.py \ --site https://example.com --days 28 # Query analysis -python custom-skills/15-seo-search-console/code/scripts/gsc_client.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/15-seo-search-console/code/scripts/gsc_client.py \ --site https://example.com --report queries --limit 100 # Page performance -python custom-skills/15-seo-search-console/code/scripts/gsc_client.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/15-seo-search-console/code/scripts/gsc_client.py \ --site https://example.com --report pages --output pages_report.json ``` diff --git a/.claude/commands/seo-international.md b/.claude/commands/seo-international.md index 48c7e4f..1aea478 100644 --- a/.claude/commands/seo-international.md +++ b/.claude/commands/seo-international.md @@ -22,31 +22,31 @@ Multi-language and multi-region SEO audit with hreflang validation and content p ```bash # Hreflang validation -python custom-skills/26-seo-international/code/scripts/hreflang_validator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/26-seo-international/code/scripts/hreflang_validator.py \ --url https://example.com --json # With sitemap-based discovery -python custom-skills/26-seo-international/code/scripts/hreflang_validator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/26-seo-international/code/scripts/hreflang_validator.py \ --url https://example.com --sitemap https://example.com/sitemap.xml --json # Check specific pages from file -python custom-skills/26-seo-international/code/scripts/hreflang_validator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/26-seo-international/code/scripts/hreflang_validator.py \ --urls-file pages.txt --json # Full international audit -python custom-skills/26-seo-international/code/scripts/international_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/26-seo-international/code/scripts/international_auditor.py \ --url https://example.com --json # URL structure analysis only -python custom-skills/26-seo-international/code/scripts/international_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/26-seo-international/code/scripts/international_auditor.py \ --url https://example.com --scope structure --json # Content parity check only -python custom-skills/26-seo-international/code/scripts/international_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/26-seo-international/code/scripts/international_auditor.py \ --url https://example.com --scope parity --json # Korean expansion focus -python custom-skills/26-seo-international/code/scripts/international_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/26-seo-international/code/scripts/international_auditor.py \ --url https://example.com --korean-expansion --json ``` diff --git a/.claude/commands/seo-keyword-strategy.md b/.claude/commands/seo-keyword-strategy.md index c3f7f4d..45bbadd 100644 --- a/.claude/commands/seo-keyword-strategy.md +++ b/.claude/commands/seo-keyword-strategy.md @@ -22,23 +22,23 @@ Keyword expansion, intent classification, clustering, and competitor gap analysi ```bash # Basic keyword research -python custom-skills/19-seo-keyword-strategy/code/scripts/keyword_researcher.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/19-seo-keyword-strategy/code/scripts/keyword_researcher.py \ --keyword "치과 임플란트" --country kr --json # Korean market with suffix expansion -python custom-skills/19-seo-keyword-strategy/code/scripts/keyword_researcher.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/19-seo-keyword-strategy/code/scripts/keyword_researcher.py \ --keyword "치과 임플란트" --country kr --korean-suffixes --json # Volume comparison Korea vs global -python custom-skills/19-seo-keyword-strategy/code/scripts/keyword_researcher.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/19-seo-keyword-strategy/code/scripts/keyword_researcher.py \ --keyword "dental implant" --country kr --compare-global --json # Keyword gap vs competitor -python custom-skills/19-seo-keyword-strategy/code/scripts/keyword_gap_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/19-seo-keyword-strategy/code/scripts/keyword_gap_analyzer.py \ --target https://example.com --competitor https://competitor.com --json # Multiple competitors with minimum volume filter -python custom-skills/19-seo-keyword-strategy/code/scripts/keyword_gap_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/19-seo-keyword-strategy/code/scripts/keyword_gap_analyzer.py \ --target https://example.com --competitor https://comp1.com \ --competitor https://comp2.com --min-volume 100 --json ``` diff --git a/.claude/commands/seo-knowledge-graph.md b/.claude/commands/seo-knowledge-graph.md index a995698..47878dc 100644 --- a/.claude/commands/seo-knowledge-graph.md +++ b/.claude/commands/seo-knowledge-graph.md @@ -23,27 +23,27 @@ Entity SEO analysis for Knowledge Panel presence, People Also Ask monitoring, an ```bash # Knowledge Graph analysis -python custom-skills/28-seo-knowledge-graph/code/scripts/knowledge_graph_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/28-seo-knowledge-graph/code/scripts/knowledge_graph_analyzer.py \ --entity "Samsung Electronics" --json # Korean entity check -python custom-skills/28-seo-knowledge-graph/code/scripts/knowledge_graph_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/28-seo-knowledge-graph/code/scripts/knowledge_graph_analyzer.py \ --entity "삼성전자" --language ko --json # Include Wikipedia/Wikidata check -python custom-skills/28-seo-knowledge-graph/code/scripts/knowledge_graph_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/28-seo-knowledge-graph/code/scripts/knowledge_graph_analyzer.py \ --entity "Samsung" --wiki --json # Full entity SEO audit -python custom-skills/28-seo-knowledge-graph/code/scripts/entity_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/28-seo-knowledge-graph/code/scripts/entity_auditor.py \ --url https://example.com --entity "Brand Name" --json # PAA monitoring -python custom-skills/28-seo-knowledge-graph/code/scripts/entity_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/28-seo-knowledge-graph/code/scripts/entity_auditor.py \ --url https://example.com --entity "Brand Name" --paa --json # FAQ rich result tracking -python custom-skills/28-seo-knowledge-graph/code/scripts/entity_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/28-seo-knowledge-graph/code/scripts/entity_auditor.py \ --url https://example.com --entity "Brand Name" --faq --json ``` diff --git a/.claude/commands/seo-kpi-framework.md b/.claude/commands/seo-kpi-framework.md index 0d07b2b..83c8439 100644 --- a/.claude/commands/seo-kpi-framework.md +++ b/.claude/commands/seo-kpi-framework.md @@ -22,35 +22,35 @@ Unified KPI aggregation across all SEO dimensions with health scores, baselines, ```bash # Aggregate KPIs -python custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \ --url https://example.com --json # Set baseline -python custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \ --url https://example.com --set-baseline --json # Compare against baseline -python custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \ --url https://example.com --baseline baseline.json --json # With ROI estimation -python custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/kpi_aggregator.py \ --url https://example.com --roi --json # Monthly performance report -python custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \ --url https://example.com --period monthly --json # Quarterly report -python custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \ --url https://example.com --period quarterly --json # Custom date range -python custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \ --url https://example.com --from 2025-01-01 --to 2025-03-31 --json # Executive summary only -python custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/25-seo-kpi-framework/code/scripts/performance_reporter.py \ --url https://example.com --period monthly --executive --json ``` diff --git a/.claude/commands/seo-link-building.md b/.claude/commands/seo-link-building.md index 50df54e..485a734 100644 --- a/.claude/commands/seo-link-building.md +++ b/.claude/commands/seo-link-building.md @@ -23,27 +23,27 @@ Backlink profile analysis, toxic link detection, competitor link gap identificat ```bash # Full backlink audit -python custom-skills/22-seo-link-building/code/scripts/backlink_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/22-seo-link-building/code/scripts/backlink_auditor.py \ --url https://example.com --json # Check link velocity -python custom-skills/22-seo-link-building/code/scripts/backlink_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/22-seo-link-building/code/scripts/backlink_auditor.py \ --url https://example.com --velocity --json # Find broken backlinks for recovery -python custom-skills/22-seo-link-building/code/scripts/backlink_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/22-seo-link-building/code/scripts/backlink_auditor.py \ --url https://example.com --broken --json # Korean platform link analysis -python custom-skills/22-seo-link-building/code/scripts/backlink_auditor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/22-seo-link-building/code/scripts/backlink_auditor.py \ --url https://example.com --korean-platforms --json # Link gap vs competitor -python custom-skills/22-seo-link-building/code/scripts/link_gap_finder.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/22-seo-link-building/code/scripts/link_gap_finder.py \ --target https://example.com --competitor https://comp1.com --json # Multiple competitors with minimum DR filter -python custom-skills/22-seo-link-building/code/scripts/link_gap_finder.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/22-seo-link-building/code/scripts/link_gap_finder.py \ --target https://example.com --competitor https://comp1.com \ --competitor https://comp2.com --min-dr 30 --json ``` diff --git a/.claude/commands/seo-migration-planner.md b/.claude/commands/seo-migration-planner.md index 9f96600..d5fed35 100644 --- a/.claude/commands/seo-migration-planner.md +++ b/.claude/commands/seo-migration-planner.md @@ -23,27 +23,27 @@ Pre-migration risk assessment, redirect mapping, and post-migration traffic/inde ```bash # Domain move planning -python custom-skills/33-seo-migration-planner/code/scripts/migration_planner.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/33-seo-migration-planner/code/scripts/migration_planner.py \ --domain https://example.com --type domain-move --new-domain https://new-example.com --json # Platform migration (e.g., WordPress to headless) -python custom-skills/33-seo-migration-planner/code/scripts/migration_planner.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/33-seo-migration-planner/code/scripts/migration_planner.py \ --domain https://example.com --type platform --json # URL restructuring -python custom-skills/33-seo-migration-planner/code/scripts/migration_planner.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/33-seo-migration-planner/code/scripts/migration_planner.py \ --domain https://example.com --type url-restructure --json # HTTPS migration -python custom-skills/33-seo-migration-planner/code/scripts/migration_planner.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/33-seo-migration-planner/code/scripts/migration_planner.py \ --domain http://example.com --type https --json # Post-launch traffic comparison -python custom-skills/33-seo-migration-planner/code/scripts/migration_monitor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/33-seo-migration-planner/code/scripts/migration_monitor.py \ --domain https://new-example.com --migration-date 2025-01-15 --baseline baseline.json --json # Quick redirect health check -python custom-skills/33-seo-migration-planner/code/scripts/migration_monitor.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/33-seo-migration-planner/code/scripts/migration_monitor.py \ --domain https://new-example.com --migration-date 2025-01-15 --json ``` diff --git a/.claude/commands/seo-on-page.md b/.claude/commands/seo-on-page.md index 7efedd7..c82a92c 100644 --- a/.claude/commands/seo-on-page.md +++ b/.claude/commands/seo-on-page.md @@ -20,11 +20,11 @@ On-page SEO analysis for meta tags, headings, content, and links. ```bash # Full page analysis -python custom-skills/13-seo-on-page-audit/code/scripts/page_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/13-seo-on-page-audit/code/scripts/page_analyzer.py \ --url https://example.com/page # Multiple pages -python custom-skills/13-seo-on-page-audit/code/scripts/page_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/13-seo-on-page-audit/code/scripts/page_analyzer.py \ --urls urls.txt --output report.json ``` diff --git a/.claude/commands/seo-position-tracking.md b/.claude/commands/seo-position-tracking.md index c4953e9..3e4b224 100644 --- a/.claude/commands/seo-position-tracking.md +++ b/.claude/commands/seo-position-tracking.md @@ -22,27 +22,27 @@ Monitor keyword rankings, detect position changes with threshold alerts, and cal ```bash # Get current positions -python custom-skills/21-seo-position-tracking/code/scripts/position_tracker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-seo-position-tracking/code/scripts/position_tracker.py \ --target https://example.com --json # With change threshold alerts (flag moves of +-5 or more) -python custom-skills/21-seo-position-tracking/code/scripts/position_tracker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-seo-position-tracking/code/scripts/position_tracker.py \ --target https://example.com --threshold 5 --json # Filter by brand segment -python custom-skills/21-seo-position-tracking/code/scripts/position_tracker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-seo-position-tracking/code/scripts/position_tracker.py \ --target https://example.com --segment brand --json # Compare with competitor -python custom-skills/21-seo-position-tracking/code/scripts/position_tracker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-seo-position-tracking/code/scripts/position_tracker.py \ --target https://example.com --competitor https://comp1.com --json # 30-day ranking report -python custom-skills/21-seo-position-tracking/code/scripts/ranking_reporter.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-seo-position-tracking/code/scripts/ranking_reporter.py \ --target https://example.com --period 30 --json # Quarterly report with competitor comparison -python custom-skills/21-seo-position-tracking/code/scripts/ranking_reporter.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/21-seo-position-tracking/code/scripts/ranking_reporter.py \ --target https://example.com --competitor https://comp1.com --period 90 --json ``` diff --git a/.claude/commands/seo-reporting-dashboard.md b/.claude/commands/seo-reporting-dashboard.md index f6d628a..3a38b61 100644 --- a/.claude/commands/seo-reporting-dashboard.md +++ b/.claude/commands/seo-reporting-dashboard.md @@ -22,27 +22,27 @@ Aggregate all SEO skill outputs into executive reports and interactive HTML dash ```bash # Aggregate all skill outputs for a domain -python custom-skills/34-seo-reporting-dashboard/code/scripts/report_aggregator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/34-seo-reporting-dashboard/code/scripts/report_aggregator.py \ --domain https://example.com --json # Aggregate with date range filter -python custom-skills/34-seo-reporting-dashboard/code/scripts/report_aggregator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/34-seo-reporting-dashboard/code/scripts/report_aggregator.py \ --domain https://example.com --from 2025-01-01 --to 2025-03-31 --json # Generate HTML dashboard -python custom-skills/34-seo-reporting-dashboard/code/scripts/dashboard_generator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/34-seo-reporting-dashboard/code/scripts/dashboard_generator.py \ --report aggregated_report.json --output dashboard.html # C-level executive summary (Korean) -python custom-skills/34-seo-reporting-dashboard/code/scripts/executive_report.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/34-seo-reporting-dashboard/code/scripts/executive_report.py \ --report aggregated_report.json --audience c-level --output report.md # Marketing team report -python custom-skills/34-seo-reporting-dashboard/code/scripts/executive_report.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/34-seo-reporting-dashboard/code/scripts/executive_report.py \ --report aggregated_report.json --audience marketing --output report.md # Technical team report -python custom-skills/34-seo-reporting-dashboard/code/scripts/executive_report.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/34-seo-reporting-dashboard/code/scripts/executive_report.py \ --report aggregated_report.json --audience technical --output report.md ``` diff --git a/.claude/commands/seo-schema-generator.md b/.claude/commands/seo-schema-generator.md index c85b719..f0e8075 100644 --- a/.claude/commands/seo-schema-generator.md +++ b/.claude/commands/seo-schema-generator.md @@ -19,11 +19,11 @@ Generate JSON-LD structured data markup from templates. ```bash # Generate from template -python custom-skills/17-seo-schema-generator/code/scripts/schema_generator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/17-seo-schema-generator/code/scripts/schema_generator.py \ --type LocalBusiness --output schema.json # With custom data -python custom-skills/17-seo-schema-generator/code/scripts/schema_generator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/17-seo-schema-generator/code/scripts/schema_generator.py \ --type Article \ --data '{"headline": "My Article", "author": "John Doe"}' \ --output article-schema.json diff --git a/.claude/commands/seo-schema-validator.md b/.claude/commands/seo-schema-validator.md index f251b65..737104f 100644 --- a/.claude/commands/seo-schema-validator.md +++ b/.claude/commands/seo-schema-validator.md @@ -20,15 +20,15 @@ JSON-LD structured data validation and analysis. ```bash # Validate page schema -python custom-skills/16-seo-schema-validator/code/scripts/schema_validator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/16-seo-schema-validator/code/scripts/schema_validator.py \ --url https://example.com # Validate local file -python custom-skills/16-seo-schema-validator/code/scripts/schema_validator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/16-seo-schema-validator/code/scripts/schema_validator.py \ --file schema.json # Batch validation -python custom-skills/16-seo-schema-validator/code/scripts/schema_validator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/16-seo-schema-validator/code/scripts/schema_validator.py \ --urls urls.txt --output validation_report.json ``` diff --git a/.claude/commands/seo-serp-analysis.md b/.claude/commands/seo-serp-analysis.md index fb9a0a7..24c9a90 100644 --- a/.claude/commands/seo-serp-analysis.md +++ b/.claude/commands/seo-serp-analysis.md @@ -22,19 +22,19 @@ Detect SERP features, map competitor positions, and score feature opportunities ```bash # Google SERP analysis -python custom-skills/20-seo-serp-analysis/code/scripts/serp_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/20-seo-serp-analysis/code/scripts/serp_analyzer.py \ --keyword "치과 임플란트" --country kr --json # Multiple keywords from file -python custom-skills/20-seo-serp-analysis/code/scripts/serp_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/20-seo-serp-analysis/code/scripts/serp_analyzer.py \ --keywords-file keywords.txt --country kr --json # Naver SERP analysis -python custom-skills/20-seo-serp-analysis/code/scripts/naver_serp_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/20-seo-serp-analysis/code/scripts/naver_serp_analyzer.py \ --keyword "치과 임플란트" --json # Naver multiple keywords -python custom-skills/20-seo-serp-analysis/code/scripts/naver_serp_analyzer.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/20-seo-serp-analysis/code/scripts/naver_serp_analyzer.py \ --keywords-file keywords.txt --json ``` diff --git a/.claude/commands/seo-technical.md b/.claude/commands/seo-technical.md index 6bb8568..180899d 100644 --- a/.claude/commands/seo-technical.md +++ b/.claude/commands/seo-technical.md @@ -19,15 +19,15 @@ Technical SEO audit for robots.txt and sitemap validation. ```bash # Check robots.txt -python custom-skills/12-seo-technical-audit/code/scripts/robots_checker.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/12-seo-technical-audit/code/scripts/robots_checker.py \ --url https://example.com # Validate sitemap -python custom-skills/12-seo-technical-audit/code/scripts/sitemap_validator.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/12-seo-technical-audit/code/scripts/sitemap_validator.py \ --url https://example.com/sitemap.xml # Crawl sitemap URLs -python custom-skills/12-seo-technical-audit/code/scripts/sitemap_crawler.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/12-seo-technical-audit/code/scripts/sitemap_crawler.py \ --sitemap https://example.com/sitemap.xml --output report.json ``` diff --git a/.claude/commands/seo-vitals.md b/.claude/commands/seo-vitals.md index 041c9b0..7c2db4d 100644 --- a/.claude/commands/seo-vitals.md +++ b/.claude/commands/seo-vitals.md @@ -20,15 +20,15 @@ Google PageSpeed Insights and Core Web Vitals analysis. ```bash # Analyze single URL -python custom-skills/14-seo-core-web-vitals/code/scripts/pagespeed_client.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/14-seo-core-web-vitals/code/scripts/pagespeed_client.py \ --url https://example.com # Mobile and desktop -python custom-skills/14-seo-core-web-vitals/code/scripts/pagespeed_client.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/14-seo-core-web-vitals/code/scripts/pagespeed_client.py \ --url https://example.com --strategy both # Batch analysis -python custom-skills/14-seo-core-web-vitals/code/scripts/pagespeed_client.py \ +python /Users/ourdigital/Projects/our-claude-skills/custom-skills/14-seo-core-web-vitals/code/scripts/pagespeed_client.py \ --urls urls.txt --output vitals_report.json ``` diff --git a/custom-skills/_ourdigital-shared/README.md b/custom-skills/_ourdigital-shared/README.md index fd5cbca..ec3c42e 100644 --- a/custom-skills/_ourdigital-shared/README.md +++ b/custom-skills/_ourdigital-shared/README.md @@ -20,6 +20,7 @@ cd our-claude-skills/custom-skills/_ourdigital-shared ./install.sh --update # Update existing installation ./install.sh --uninstall # Remove installation ./install.sh --validate # Check installation status +./install.sh --commands # Only install/update global slash commands ./install.sh --skip-creds # Skip credentials setup ./install.sh --skip-venv # Skip virtual environment ./install.sh --help # Show all options @@ -29,20 +30,59 @@ cd our-claude-skills/custom-skills/_ourdigital-shared | Component | Location | Description | |-----------|----------|-------------| +| Global slash commands | `~/.claude/commands/` | Symlinks to repo commands (work from any project) | | Environment file | `~/.env.ourdigital` | API keys and secrets | | Config directory | `~/.ourdigital/` | Configuration and credentials | | Virtual environment | `.venv-ourdigital/` | Python dependencies | +## Global Slash Commands + +All custom skills are installed as **global slash commands** via symlinks. This means you can use them from any project directory in Claude Code: + +```bash +# These work from ANY project, not just our-claude-skills/ +/seo-technical https://example.com +/reference-curator "Claude Code best practices" +/ourdigital-research "topic" +/notebooklm-agent +/gtm-audit https://example.com +``` + +### How It Works + +The installer symlinks all `.md` files from `.claude/commands/` in the repo to `~/.claude/commands/`: + +``` +~/.claude/commands/ +├── lint.md # Original global command +├── test.md # Original global command +├── seo-technical.md -> /path/to/our-claude-skills/.claude/commands/seo-technical.md +├── seo-keyword-strategy.md -> ... +├── reference-curator.md -> ... +└── ... # ~40 symlinked commands +``` + +Since they're symlinks, pulling repo updates automatically refreshes the commands. + +### Updating Commands + +After pulling new changes or adding new commands: + +```bash +./install.sh --commands # Re-scan and symlink any new commands +``` + ## Directory Structure ``` +~/.claude/commands/ # Global slash commands (symlinks) ~/.ourdigital/ -├── config.yaml # Global configuration -├── credentials/ # Service account JSONs +├── config.yaml # Global configuration +├── credentials/ # Service account JSONs │ └── *.json -└── logs/ # Installation logs +└── logs/ # Installation logs -~/.env.ourdigital # Environment variables (chmod 600) +~/.env.ourdigital # Environment variables (chmod 600) ``` ## Manual Setup @@ -53,21 +93,27 @@ If you prefer manual setup: ```bash mkdir -p ~/.ourdigital/credentials chmod 700 ~/.ourdigital ~/.ourdigital/credentials +mkdir -p ~/.claude/commands ``` -### 2. Copy environment template +### 2. Symlink global commands +```bash +ln -s /path/to/our-claude-skills/.claude/commands/*.md ~/.claude/commands/ +``` + +### 3. Copy environment template ```bash cp .env.ourdigital.template ~/.env.ourdigital chmod 600 ~/.env.ourdigital ``` -### 3. Edit credentials +### 4. Edit credentials ```bash nano ~/.env.ourdigital # Add your API keys ``` -### 4. Create virtual environment +### 5. Create virtual environment ```bash python3 -m venv .venv-ourdigital source .venv-ourdigital/bin/activate @@ -79,8 +125,8 @@ pip install -r requirements/base.txt | Service | Variable | How to Get | |---------|----------|------------| | Notion | `NOTION_API_TOKEN` | [Notion Integrations](https://www.notion.so/my-integrations) | -| Ghost Blog | `GHOST_BLOG_ADMIN_KEY` | Ghost Admin → Integrations | -| Ghost Journal | `GHOST_JOURNAL_ADMIN_KEY` | Ghost Admin → Integrations | +| Ghost Blog | `GHOST_BLOG_ADMIN_KEY` | Ghost Admin > Integrations | +| Ghost Journal | `GHOST_JOURNAL_ADMIN_KEY` | Ghost Admin > Integrations | | Figma | `FIGMA_ACCESS_TOKEN` | [Figma Settings](https://www.figma.com/developers/api#access-tokens) | ### Using 1Password CLI @@ -143,6 +189,15 @@ pyenv local 3.11 python scripts/validate_install.py --verbose ``` +### Commands not showing in Claude Code +```bash +# Check symlinks are intact +ls -la ~/.claude/commands/ + +# Re-install commands +./install.sh --commands +``` + ## File Reference | File | Purpose | diff --git a/custom-skills/_ourdigital-shared/install.sh b/custom-skills/_ourdigital-shared/install.sh index 46f4e24..8cc16e9 100755 --- a/custom-skills/_ourdigital-shared/install.sh +++ b/custom-skills/_ourdigital-shared/install.sh @@ -7,6 +7,7 @@ # ./install.sh # Interactive install # ./install.sh --update # Update existing installation # ./install.sh --uninstall # Remove installation +# ./install.sh --commands # Only install/update global slash commands # ./install.sh --help # Show help # @@ -23,9 +24,12 @@ NC='\033[0m' # No Color # Configuration SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" SKILLS_DIR="$(dirname "$SCRIPT_DIR")" +REPO_DIR="$(dirname "$SKILLS_DIR")" ENV_FILE="$HOME/.env.ourdigital" CONFIG_DIR="$HOME/.ourdigital" VENV_DIR="$SKILLS_DIR/.venv-ourdigital" +CLAUDE_COMMANDS_DIR="$HOME/.claude/commands" +REPO_COMMANDS_DIR="$REPO_DIR/.claude/commands" # Print banner print_banner() { @@ -70,6 +74,13 @@ check_prerequisites() { missing+=("git") fi + # Check Claude Code CLI + if command -v claude &> /dev/null; then + success "Claude Code CLI available" + else + warn "Claude Code CLI not found (slash commands require it)" + fi + # Check 1Password CLI (optional) if command -v op &> /dev/null; then success "1Password CLI available" @@ -101,6 +112,92 @@ setup_directories() { mkdir -p "$CONFIG_DIR/logs" success "Created $CONFIG_DIR/logs/" + # Create Claude commands directory + mkdir -p "$CLAUDE_COMMANDS_DIR" + success "Created $CLAUDE_COMMANDS_DIR/" + + echo "" +} + +# Install global slash commands via symlinks +setup_global_commands() { + info "Setting up global slash commands..." + + if [[ ! -d "$REPO_COMMANDS_DIR" ]]; then + error "Commands directory not found: $REPO_COMMANDS_DIR" + echo " Make sure you're running from the our-claude-skills repository." + return 1 + fi + + mkdir -p "$CLAUDE_COMMANDS_DIR" + + local linked=0 + local skipped=0 + local updated=0 + + for cmd_file in "$REPO_COMMANDS_DIR"/*.md; do + [[ -f "$cmd_file" ]] || continue + local filename + filename=$(basename "$cmd_file") + local target="$CLAUDE_COMMANDS_DIR/$filename" + + if [[ -L "$target" ]]; then + local current_link + current_link=$(readlink "$target") + if [[ "$current_link" == "$cmd_file" ]]; then + ((skipped++)) + else + rm "$target" + ln -s "$cmd_file" "$target" + ((updated++)) + fi + elif [[ -f "$target" ]]; then + warn "Skipping $filename (non-symlink file exists at $target)" + ((skipped++)) + else + ln -s "$cmd_file" "$target" + ((linked++)) + fi + done + + [[ $linked -gt 0 ]] && success "Linked $linked new commands" + [[ $updated -gt 0 ]] && success "Updated $updated existing symlinks" + [[ $skipped -gt 0 ]] && info "Skipped $skipped (already current)" + + # Count total symlinks pointing to our repo + local total + total=$(find "$CLAUDE_COMMANDS_DIR" -maxdepth 1 -type l -lname "$REPO_COMMANDS_DIR/*" 2>/dev/null | wc -l | tr -d ' ') + success "Total global commands from this repo: $total" + + echo "" +} + +# Remove global slash command symlinks +remove_global_commands() { + info "Removing global slash command symlinks..." + + if [[ ! -d "$CLAUDE_COMMANDS_DIR" ]]; then + info "No commands directory found, nothing to remove" + return + fi + + local removed=0 + for link in "$CLAUDE_COMMANDS_DIR"/*.md; do + [[ -L "$link" ]] || continue + local link_target + link_target=$(readlink "$link") + if [[ "$link_target" == "$REPO_COMMANDS_DIR/"* ]]; then + rm "$link" + ((removed++)) + fi + done + + if [[ $removed -gt 0 ]]; then + success "Removed $removed command symlinks" + else + info "No symlinks from this repo found" + fi + echo "" } @@ -239,7 +336,7 @@ validate_installation() { info "Validating installation..." local checks_passed=0 - local checks_total=6 + local checks_total=7 # Check directories [[ -d "$CONFIG_DIR" ]] && ((checks_passed++)) && success "Config directory exists" || warn "Config directory missing" @@ -255,6 +352,16 @@ validate_installation() { # Check skills directory [[ -d "$SKILLS_DIR/01-ourdigital-brand-guide" ]] && ((checks_passed++)) && success "Skills directory valid" || warn "Skills not found" + # Check global commands + local cmd_count + cmd_count=$(find "$CLAUDE_COMMANDS_DIR" -maxdepth 1 -type l -lname "$REPO_COMMANDS_DIR/*" 2>/dev/null | wc -l | tr -d ' ') + if [[ $cmd_count -gt 0 ]]; then + ((checks_passed++)) + success "Global slash commands installed ($cmd_count commands)" + else + warn "No global slash commands found (run with --commands to install)" + fi + echo "" echo -e "${CYAN}Validation: $checks_passed/$checks_total checks passed${NC}" echo "" @@ -262,17 +369,97 @@ validate_installation() { # Show installed skills show_skills() { - info "Installed OurDigital Skills:" + info "Installed Skills:" echo "" - for dir in "$SKILLS_DIR"/0{1,2,3,4,5,6,7,8,9}-ourdigital-* "$SKILLS_DIR"/10-ourdigital-*; do - if [[ -d "$dir" ]]; then - name=$(basename "$dir") - desc=$(grep -m1 "^name:" "$dir/desktop/SKILL.md" 2>/dev/null | cut -d':' -f2 | xargs || echo "") - echo -e " ${GREEN}✓${NC} $name" + local categories=( + "OurDigital Core:0{1,2,3,4,5,6,7,8,9}-ourdigital-*,10-ourdigital-*" + "SEO Tools:1{1,2,3,4,5,6,7,8,9}-seo-*,2{0,1,2,3,4,5,6,7,8,9}-seo-*,3{0,1,2,3,4}-seo-*" + "Jamie Clinic:4{0,1,2,3,4,5}-jamie-*" + "NotebookLM:5{0,1,2,3}-notebooklm-*" + "GTM/GA:6{0,1,2}-gtm-*" + "Notion:3{1,2}-notion-*" + "Reference & Multi-Agent:9{0,1}-*" + ) + + for category in "${categories[@]}"; do + IFS=':' read -r label patterns <<< "$category" + local count=0 + local names=() + + IFS=',' read -ra pattern_arr <<< "$patterns" + for pattern in "${pattern_arr[@]}"; do + for dir in "$SKILLS_DIR"/$pattern; do + if [[ -d "$dir" ]]; then + ((count++)) + names+=("$(basename "$dir")") + fi + done + done + + if [[ $count -gt 0 ]]; then + echo -e " ${CYAN}$label${NC} ($count skills)" + for name in "${names[@]}"; do + echo -e " ${GREEN}✓${NC} $name" + done + echo "" + fi + done +} + +# Show global command summary +show_global_commands() { + info "Global Slash Commands (available from any project):" + echo "" + + if [[ ! -d "$CLAUDE_COMMANDS_DIR" ]]; then + warn "No commands directory found" + return + fi + + local cmd_count=0 + local categories=() + + for link in "$CLAUDE_COMMANDS_DIR"/*.md; do + [[ -L "$link" ]] || continue + local link_target + link_target=$(readlink "$link") + if [[ "$link_target" == "$REPO_COMMANDS_DIR/"* ]]; then + ((cmd_count++)) + local name + name=$(basename "$link" .md) + categories+=("$name") fi done + if [[ $cmd_count -eq 0 ]]; then + warn "No commands symlinked from this repo" + return + fi + + # Group by prefix + local seo=0 gtm=0 jamie=0 notebooklm=0 notion=0 ourdigital=0 other=0 + for name in "${categories[@]}"; do + case "$name" in + seo-*) ((seo++)) ;; + gtm-*) ((gtm++)) ;; + jamie-*) ((jamie++)) ;; + notebooklm-*) ((notebooklm++)) ;; + notion-*) ((notion++)) ;; + ourdigital-*) ((ourdigital++)) ;; + *) ((other++)) ;; + esac + done + + [[ $seo -gt 0 ]] && echo -e " ${GREEN}SEO${NC}: $seo commands (/seo-technical, /seo-keyword-strategy, ...)" + [[ $gtm -gt 0 ]] && echo -e " ${GREEN}GTM${NC}: $gtm commands (/gtm-audit, /gtm-manager)" + [[ $jamie -gt 0 ]] && echo -e " ${GREEN}Jamie${NC}: $jamie commands (/jamie-editor, /jamie-audit)" + [[ $notebooklm -gt 0 ]] && echo -e " ${GREEN}NotebookLM${NC}: $notebooklm commands (/notebooklm-agent, ...)" + [[ $notion -gt 0 ]] && echo -e " ${GREEN}Notion${NC}: $notion commands (/notion-writer, /notion-organizer)" + [[ $ourdigital -gt 0 ]] && echo -e " ${GREEN}OurDigital${NC}: $ourdigital commands (/ourdigital-research, ...)" + [[ $other -gt 0 ]] && echo -e " ${GREEN}Other${NC}: $other commands" + echo "" + echo -e " ${CYAN}Total: $cmd_count global commands${NC}" echo "" } @@ -286,19 +473,20 @@ print_usage() { echo "2. Edit credentials if needed:" echo " nano $ENV_FILE" echo "" - echo "3. Use skills with 'our' or 'ourdigital' prefix:" - echo " - our blog [topic]" - echo " - our research [topic]" - echo " - our 견적서" + echo "3. Use slash commands from any project (globally installed):" + echo " /seo-technical https://example.com" + echo " /reference-curator \"Claude Code best practices\"" + echo " /ourdigital-research \"topic\"" + echo " /notebooklm-agent" echo "" - echo "4. Documentation:" - echo " $SKILLS_DIR/OUR_SKILL_PROJECT_PLAN_v1.1.md" + echo "4. Update commands after pulling repo changes:" + echo " ./install.sh --commands" echo "" } # Uninstall uninstall() { - warn "This will remove OurDigital configuration (not skills)." + warn "This will remove OurDigital configuration and global commands (not skill source files)." read -p "Continue? (y/N): " -n 1 -r echo @@ -307,6 +495,9 @@ uninstall() { exit 0 fi + # Remove global command symlinks + remove_global_commands + # Backup before removing if [[ -f "$ENV_FILE" ]]; then cp "$ENV_FILE" "$ENV_FILE.uninstall.backup" @@ -334,16 +525,22 @@ show_help() { echo "Options:" echo " --help, -h Show this help message" echo " --update, -u Update existing installation" - echo " --uninstall Remove installation (preserves skills)" + echo " --uninstall Remove installation (preserves skill source files)" echo " --validate Only run validation checks" + echo " --commands Only install/update global slash commands" echo " --skip-creds Skip credentials setup" echo " --skip-venv Skip virtual environment setup" echo "" echo "Examples:" echo " ./install.sh # Full interactive install" echo " ./install.sh --update # Update existing setup" + echo " ./install.sh --commands # Just install/refresh global commands" echo " ./install.sh --skip-creds # Install without credentials" echo "" + echo "Global Commands:" + echo " Slash commands are symlinked to ~/.claude/commands/ so they" + echo " work from any project directory in Claude Code." + echo "" } # Main installation flow @@ -351,6 +548,7 @@ main_install() { print_banner check_prerequisites setup_directories + setup_global_commands setup_environment if [[ "$SKIP_CREDS" != true ]]; then @@ -364,6 +562,7 @@ main_install() { setup_config validate_installation show_skills + show_global_commands print_usage echo -e "${GREEN}╔═══════════════════════════════════════════════════════════╗${NC}" @@ -387,12 +586,21 @@ while [[ $# -gt 0 ]]; do ;; --validate) validate_installation + show_global_commands + exit 0 + ;; + --commands) + info "Installing/updating global slash commands..." + setup_global_commands + show_global_commands exit 0 ;; --update|-u) info "Updating installation..." + setup_global_commands setup_python_env validate_installation + show_global_commands exit 0 ;; --skip-creds) diff --git a/docs/USER-GUIDE-KO.md b/docs/USER-GUIDE-KO.md new file mode 100644 index 0000000..7eb9a81 --- /dev/null +++ b/docs/USER-GUIDE-KO.md @@ -0,0 +1,1236 @@ +# OurDigital 커스텀 스킬 — 사용자 가이드 + +> **our-claude-skills** 컬렉션의 52개 커스텀 스킬에 대한 종합 가이드입니다. + +--- + +## 목차 + +1. [소개](#1-소개) +2. [빠른 시작](#2-빠른-시작) +3. [스킬 카테고리 요약](#3-스킬-카테고리-요약) +4. [OurDigital 코어 (00-10)](#4-ourdigital-코어-00-10) +5. [SEO 도구 (11-34)](#5-seo-도구-11-34) +6. [제이미 클리닉 (40-45)](#6-제이미-클리닉-40-45) +7. [NotebookLM 도구 (50-53)](#7-notebooklm-도구-50-53) +8. [GTM / 애널리틱스 (60-62)](#8-gtm--애널리틱스-60-62) +9. [Notion 도구 (31-32)](#9-notion-도구-31-32) +10. [레퍼런스 큐레이터 (90)](#10-레퍼런스-큐레이터-90) +11. [멀티 에이전트 가이드 (91)](#11-멀티-에이전트-가이드-91) +12. [아키텍처 및 규칙](#12-아키텍처-및-규칙) +13. [새 스킬 만들기](#13-새-스킬-만들기) +14. [문제 해결](#14-문제-해결) + +--- + +## 1. 소개 + +### 커스텀 스킬이란? + +커스텀 스킬은 Claude의 기능을 확장하는 재사용 가능한 도메인별 지시서(directive)입니다. 각 스킬은 Claude에게 특정 작업을 수행하는 방법을 알려줍니다 — OurDigital 브랜드 톤으로 블로그를 작성하거나, SEO 감사를 실행하거나, GTM 컨테이너를 관리하거나, 레퍼런스 문서를 큐레이션하는 작업 등을 포함합니다. + +### 두 가지 플랫폼, 하나의 컬렉션 + +모든 스킬은 **두 개의 독립적인 플랫폼**에서 작동하도록 설계되어 있습니다: + +| 플랫폼 | 지시서 파일 | 실행 방식 | 적합한 사용자 | +|--------|-----------|----------|------------| +| **Claude Code** (CLI) | `code/CLAUDE.md` | Bash/Python 직접 실행, 슬래시 명령 | 개발자, 자동화, 스크립팅 | +| **Claude Desktop** (앱) | `desktop/SKILL.md` | MCP 도구만 사용, 대화형 | 비기술 사용자, 가이드 워크플로우 | + +두 플랫폼을 모두 사용할 필요는 없습니다. 사용하는 플랫폼에 맞는 지시서를 따르면 됩니다. + +### 스킬 호출 방법 + +**Claude Code** — CLI에서 슬래시 명령을 입력합니다: + +``` +/seo-technical https://ourdigital.org +/reference-curator "MCP 문서" --depth deep +/notebooklm-studio generate audio "AI 트렌드 요약" +``` + +**Claude Desktop** — 자연어 트리거를 사용합니다: + +``` +"ourdigital.org에 대해 기술 SEO 감사를 실행해줘" +"노트북에서 팟캐스트를 만들어줘" +"AI 마케팅에 대한 블로그 포스트를 작성해줘" +``` + +--- + +## 2. 빠른 시작 + +### 사전 요구사항 + +| 요구사항 | 사용 스킬 | 설치 | +|---------|----------|------| +| Python 3.10+ | SEO 스크립트, NotebookLM | `brew install python` | +| Node.js 18+ | GTM 스크립트, 크롤러 | `brew install node` | +| Firecrawl MCP | 레퍼런스 큐레이터, 크롤링 | Claude Code MCP 설정에서 구성 | +| Notion MCP | Notion 스킬 | Claude Code MCP 설정에서 구성 | +| Ahrefs MCP | SEO 스킬 (11-34) | Claude Code MCP 설정에서 구성 | +| notebooklm-py | NotebookLM 스킬 (50-53) | `pip install notebooklm-py && playwright install chromium` | + +### 설치 + +```bash +# 저장소 복제 +git clone https://github.com/ourdigital/our-claude-skills.git +cd our-claude-skills + +# (선택) SEO 의존성 설치 +pip install -r custom-skills/_ourdigital-shared/requirements/base.txt + +# (선택) 레퍼런스 큐레이터 설치 +cd custom-skills/90-reference-curator && ./install.sh + +# (선택) NotebookLM 설정 +pip install notebooklm-py +playwright install chromium +notebooklm login +``` + +### 슬래시 명령 확인 + +저장소를 복제하고 Claude Code에서 열면 `.claude/commands/`의 슬래시 명령이 자동으로 사용 가능합니다. Claude Code에서 `/`를 입력하면 전체 목록을 확인할 수 있습니다. + +--- + +## 3. 스킬 카테고리 요약 + +| 범위 | 도메인 | 개수 | 설명 | +|------|--------|------|------| +| 00 | 설정 및 메타 | 1 | Claude Code 설정 최적화 | +| 01-10 | OurDigital 코어 | 10 | 브랜드, 콘텐츠, 디자인, 비즈니스 도구 | +| 11-34 | SEO | 24 | 기술 감사부터 경영진 리포트까지 | +| 40-45 | 제이미 클리닉 | 5 | 의료 브랜드 콘텐츠 및 소셜 미디어 | +| 50-53 | NotebookLM | 4 | AI 노트북 관리 및 콘텐츠 생성 | +| 60-62 | GTM / 애널리틱스 | 3 | 태그 관리 및 모니터링 | +| 31-32 | Notion | 2 | 워크스페이스 정리 및 콘텐츠 작성 | +| 90 | 레퍼런스 큐레이터 | 1 (6개 하위 스킬) | 문서 큐레이션 파이프라인 | +| 91 | 멀티 에이전트 | 1 | 에이전트 협업 프레임워크 | + +**총 52개 스킬** (레퍼런스 큐레이터 하위 스킬 포함) + +--- + +## 4. OurDigital 코어 (00-10) + +### 개요 + +코어 스킬은 브랜드 아이덴티티, 다채널 콘텐츠 생성, 비주얼 디자인, 광고, 교육, 비즈니스 운영을 담당합니다. + +### 00 — 설정 감사 (Settings Audit) + +| | | +|---|---| +| **목적** | Claude Code 설정 최적화, 토큰 사용량 감사, MCP 오류 진단 | +| **명령** | `/settings-audit` | +| **트리거** | "settings audit", "exceed response limit", "MCP error" | +| **플랫폼** | Code + Desktop | + +**기능:** +- `~/.claude/settings.json` 분석 및 최적화 기회 파악 +- 토큰 사용 패턴 보고 +- MCP 서버 연결 문제 진단 +- 권한 및 훅 설정 권장사항 제공 + +### 01 — 브랜드 가이드 + +| | | +|---|---| +| **목적** | OurDigital 브랜드 기준, 글쓰기 스타일, 비주얼 아이덴티티 참조 | +| **명령** | `/ourdigital-brand-guide` | +| **트리거** | "brand guide", "writing style", "브랜드 가이드" | +| **플랫폼** | Desktop (슬래시 명령으로 적용) | + +**기능:** +- OurDigital "디지털 클리닉" 브랜드 메타포 가이드라인 제공 +- 채널별 톤 & 보이스 정의 +- 컬러 팔레트, 타이포그래피 (Noto Sans KR, Inter) 규정 +- 3대 브랜드 가치 적용: 데이터 중심, 실행 지향, 마케팅 과학 + +**브랜드 채널:** + +| 채널 | 도메인 | 톤 | +|------|--------|-----| +| 메인 사이트 | ourdigital.org | 전문적, 데이터 중심 | +| 블로그 | blog.ourdigital.org | 분석적, 교육적 | +| 저널 | journal.ourdigital.org | 대화체, 시적 | +| 아워스토리 | ourstory.day | 친밀한, 진정성 | +| 기업 | dintelligence.co.kr | 전문적, B2B | + +### 02 — 블로그 작성기 + +| | | +|---|---| +| **목적** | blog.ourdigital.org (Ghost)용 한국어 블로그 작성 | +| **트리거** | "write blog post", "블로그 작성" | +| **플랫폼** | Desktop | + +**기능:** +- OurDigital 편집 기준에 따른 한국어 블로그 포스트 작성 +- 적절한 제목, 소제목, CTA로 콘텐츠 구조화 +- "디지털 클리닉" 분석적 톤 적용 +- 게시물당 800-1,200단어 목표 + +### 03 — 저널 작성기 + +| | | +|---|---| +| **목적** | journal.ourdigital.org (Ghost)용 영문 에세이/아티클 작성 | +| **트리거** | "write essay", "journal article" | +| **플랫폼** | Desktop | + +**기능:** +- 영문 에세이 및 장문 기사 작성 +- 저널 채널에 정의된 대화체, 시적 톤 적용 +- 개인 서사 및 문화 비평 지원 + +### 04 — 리서치 + +| | | +|---|---| +| **목적** | 리서치 → 블로그 워크플로우 | +| **명령** | `/ourdigital-research` | +| **트리거** | "research this", "블로그 리서치" | +| **플랫폼** | Code + Desktop | + +**기능:** +- 주어진 주제에 대한 웹 리서치 수행 +- 결과를 구조화된 아웃라인으로 정리 +- 해당 스킬을 통해 블로그/저널 작성으로 전환 가능 + +### 05 — 문서/프레젠테이션 + +| | | +|---|---| +| **목적** | Notion → 프레젠테이션 워크플로우 | +| **명령** | `/ourdigital-presentation` | +| **트리거** | "create document", "프레젠테이션 만들기" | +| **플랫폼** | Code + Desktop | + +**기능:** +- Notion 콘텐츠를 프레젠테이션 형식으로 내보내기 +- OurDigital 브랜드 비주얼 아이덴티티로 슬라이드 구성 +- 한국어/영문 이중 언어 콘텐츠 지원 + +### 06 — 디자이너 + +| | | +|---|---| +| **목적** | 비주얼 스토리텔링 및 이미지 프롬프트 생성 | +| **명령** | `/ourdigital-designer` | +| **트리거** | "create image prompt", "비주얼 디자인" | +| **플랫폼** | Code + Desktop | + +**기능:** +- AI 이미지 생성기용 상세 이미지 프롬프트 생성 +- OurDigital 비주얼 브랜드 가이드라인 준수 (컬러 팔레트, 타이포그래피) +- 블로그 및 소셜 미디어용 비주얼 스토리텔링 컨셉 제작 + +### 07 — 광고 매니저 + +| | | +|---|---| +| **목적** | 광고 카피라이팅 및 키워드 리서치 | +| **트리거** | "ad copy", "keyword research", "광고 카피" | +| **플랫폼** | Desktop | + +**기능:** +- Google Ads, Meta Ads, Naver Ads용 광고 카피 작성 +- 유료 캠페인용 키워드 리서치 수행 +- A/B 테스트 변형 생성 +- 한국어/영문 광고 카피 지원 + +### 08 — 트레이너 + +| | | +|---|---| +| **목적** | 교육 자료 생성 | +| **트리거** | "create training", "교육 자료" | +| **플랫폼** | Desktop | + +**기능:** +- 구조화된 교육 자료 및 커리큘럼 생성 +- 퀴즈, 연습문제, 평가 기준표 생성 +- 한국어/영문 이중 언어 교육 콘텐츠 지원 + +### 09 — 백오피스 + +| | | +|---|---| +| **목적** | 비즈니스 문서 생성 | +| **트리거** | "create proposal", "견적서", "invoice" | +| **플랫폼** | Desktop | + +**기능:** +- 비즈니스 문서 생성: 제안서, 견적서, 계약서 +- OurDigital 기업 브랜딩 적용 +- 한국어 비즈니스 문서 규격 지원 + +### 10 — 스킬 크리에이터 + +| | | +|---|---| +| **목적** | 새 스킬을 만드는 메타 스킬 | +| **트리거** | "create skill", "init skill" | +| **플랫폼** | Desktop | + +**기능:** +- 새 스킬 디렉토리 구조 자동 생성 +- `CLAUDE.md` 및 `SKILL.md` 보일러플레이트 생성 +- 듀얼 플랫폼 규칙 자동 적용 +- 다음 사용 가능한 스킬 번호 자동 할당 + +**예시:** +```bash +python example-skills/skills-main/skill-creator/scripts/init_skill.py my-new-skill --path custom-skills/ +``` + +--- + +## 5. SEO 도구 (11-34) + +### 개요 + +SEO 스위트는 가장 큰 스킬 그룹으로, 기술적 크롤 가능성부터 경영진 대시보드까지 모든 것을 다룹니다. 스킬 11-18은 사이트 수준 감사, 19-28은 전략 및 인텔리전스, 29-34는 특수 운영 및 리포팅에 중점을 둡니다. + +모든 SEO 스킬은 다음과 통합됩니다: +- **Ahrefs MCP** — 도메인 메트릭, 백링크, 키워드 데이터 +- **Notion** — SEO 감사 로그 데이터베이스에 영구 기록 +- **Python 스크립트** — 공유 `base_client.py` 패턴 (RateLimiter, ConfigManager, BaseAsyncClient) + +### 감사 및 기술 (11-18) + +#### 11 — 종합 감사 + +| | | +|---|---| +| **목적** | 통합 6단계 SEO 감사 오케스트레이터 | +| **트리거** | "comprehensive SEO", "종합 SEO 감사" | + +스킬 12-18을 단일 종합 감사로 오케스트레이션합니다. 기술, 온페이지, Core Web Vitals, Search Console, 스키마, 로컬 감사를 순차적으로 실행하여 통합 보고서를 생성합니다. + +#### 12 — 기술 감사 + +| | | +|---|---| +| **목적** | Robots.txt, 사이트맵, 크롤 가능성 분석 | +| **명령** | `/seo-technical` | +| **트리거** | "technical SEO", "크롤 가능성" | + +**기능:** +- robots.txt 디렉티브 유효성 검사 +- XML 사이트맵 완전성 및 구조 확인 +- 크롤 오류 및 리다이렉트 체인 분석 +- HTTPS 설정 및 캐노니컬 태그 테스트 + +#### 13 — 온페이지 감사 + +| | | +|---|---| +| **목적** | 메타 태그, 헤딩, 내부 링크 분석 | +| **명령** | `/seo-on-page` | +| **트리거** | "on-page SEO", "메타 태그" | + +**기능:** +- 타이틀 태그, 메타 디스크립션, 헤딩 계층 구조 분석 +- 내부 링크 구조 및 앵커 텍스트 확인 +- Open Graph 및 Twitter Card 태그 유효성 검사 +- 콘텐츠 품질 신호 검토 + +#### 14 — Core Web Vitals + +| | | +|---|---| +| **목적** | LCP, CLS, FID, INP 성능 지표 | +| **명령** | `/seo-vitals` | +| **트리거** | "Core Web Vitals", "페이지 속도" | + +**기능:** +- Largest Contentful Paint (LCP) 측정 +- Cumulative Layout Shift (CLS) 측정 +- First Input Delay (FID) / Interaction to Next Paint (INP) 측정 +- 실행 가능한 최적화 권장사항 제공 + +#### 15 — Search Console + +| | | +|---|---| +| **목적** | Google Search Console 데이터 분석 | +| **명령** | `/seo-gsc` | +| **트리거** | "Search Console", "GSC", "순위" | + +**기능:** +- 검색 성능 데이터 분석 (클릭, 노출, CTR, 순위) +- 키워드 기회 및 하락 페이지 식별 +- 색인 범위 문제 보고 +- 시간에 따른 순위 변화 추적 + +#### 16 — 스키마 검증기 + +| | | +|---|---| +| **목적** | 구조화된 데이터 유효성 검사 | +| **명령** | `/seo-schema-validator` | +| **트리거** | "validate schema", "JSON-LD 확인" | + +**기능:** +- 기존 JSON-LD, Microdata, RDFa 마크업 유효성 검사 +- Google 리치 결과 요구사항 대비 확인 +- 누락된 필수 및 권장 속성 보고 +- Schema.org 어휘 대비 테스트 + +#### 17 — 스키마 생성기 + +| | | +|---|---| +| **목적** | 구조화된 데이터 마크업 생성 | +| **명령** | `/seo-schema-generator` | +| **트리거** | "generate schema", "JSON-LD 생성" | + +**기능:** +- 다양한 스키마 타입용 JSON-LD 마크업 생성 +- 지원: Article, LocalBusiness, Product, FAQ, HowTo, Organization, BreadcrumbList +- 출력 유효성 검증 후 전달 +- 구현 가이드 제공 + +#### 18 — 로컬 감사 + +| | | +|---|---| +| **목적** | 로컬 SEO: NAP 일관성, GBP, 인용 | +| **명령** | `/seo-local` | +| **트리거** | "local SEO", "Google Business Profile" | + +**기능:** +- 웹 전반에 걸친 NAP (이름-주소-전화번호) 일관성 확인 +- Google 비즈니스 프로필 완전성 감사 +- 로컬 인용 소스 분석 +- 로컬 키워드 타겟팅 검토 + +### 전략 및 인텔리전스 (19-28) + +#### 19 — 키워드 전략 + +| | | +|---|---| +| **목적** | 키워드 확장, 검색 의도 분류, 클러스터링, 갭 분석 | +| **명령** | `/seo-keyword-strategy` | +| **트리거** | "keyword research", "키워드 전략" | + +**기능:** +- Ahrefs 데이터를 활용한 시드 키워드 확장 +- 검색 의도 분류 (정보형, 탐색형, 상업적, 거래형) +- 토픽 및 SERP 유사성 기반 키워드 클러스터링 +- 경쟁사 대비 콘텐츠 갭 식별 + +**예시:** +``` +/seo-keyword-strategy "디지털 마케팅 서울" --competitors competitor1.com,competitor2.com +``` + +#### 20 — SERP 분석 + +| | | +|---|---| +| **목적** | Google/Naver SERP 피처 감지 및 경쟁사 포지션 분석 | +| **명령** | `/seo-serp-analysis` | +| **트리거** | "SERP analysis", "SERP 분석" | + +**기능:** +- SERP 피처 감지 (추천 스니펫, PAA, 지식 패널, 로컬 팩) +- 타겟 키워드별 경쟁사 포지셔닝 분석 +- Google 및 Naver (네이버) 동시 지원 +- SERP 피처 기회 식별 + +#### 21 — 순위 추적 + +| | | +|---|---| +| **목적** | 키워드 순위 모니터링, 가시성 점수, 알림 | +| **명령** | `/seo-position-tracking` | +| **트리거** | "rank tracking", "순위 모니터링" | + +**기능:** +- 시간에 따른 키워드 순위 모니터링 +- 가시성 점수 및 검색 점유율(SOV) 계산 +- 순위 변동 시 알림 생성 +- 경쟁사 움직임 추적 + +#### 22 — 링크 빌딩 + +| | | +|---|---| +| **목적** | 백링크 감사, 유해 링크 감지, 링크 갭 분석 | +| **명령** | `/seo-link-building` | +| **트리거** | "backlink audit", "링크 빌딩" | + +**기능:** +- Ahrefs 데이터를 활용한 기존 백링크 프로필 감사 +- 디스어보우(disavow)할 유해/스팸 링크 식별 +- 경쟁사 대비 링크 갭 기회 발견 +- 아웃리치 대상 및 링크 유치 콘텐츠 제안 + +#### 23 — 콘텐츠 전략 + +| | | +|---|---| +| **목적** | 콘텐츠 감사, 하락 감지, 콘텐츠 브리프, 토픽 클러스터 | +| **명령** | `/seo-content-strategy` | +| **트리거** | "content strategy", "콘텐츠 전략" | + +**기능:** +- 기존 콘텐츠 인벤토리 및 성과 감사 +- 콘텐츠 하락(트래픽/순위 감소) 감지 +- 키워드 타겟이 포함된 콘텐츠 브리프 생성 +- 토픽 클러스터 및 내부 링크 전략 매핑 + +#### 24 — 이커머스 SEO + +| | | +|---|---| +| **목적** | 상품 페이지 감사, Product 스키마 유효성 검사 | +| **명령** | `/seo-ecommerce` | +| **트리거** | "e-commerce SEO", "상품 SEO" | + +**기능:** +- 상품 페이지 SEO 요소 감사 (타이틀, 설명, 이미지) +- Product 스키마 마크업 유효성 검사 +- 카테고리 페이지 최적화 확인 +- 패싯 네비게이션 및 크롤 효율성 검토 + +#### 25 — KPI 프레임워크 + +| | | +|---|---| +| **목적** | 통합 SEO KPI, 헬스 스코어, ROI 계산 | +| **명령** | `/seo-kpi-framework` | +| **트리거** | "SEO KPI", "SEO 성과" | + +**기능:** +- 모든 감사 차원에 걸친 통합 SEO KPI 정의 및 추적 +- 복합 헬스 스코어 계산 +- 트래픽 및 전환 데이터 기반 SEO ROI 추정 +- 이해관계자 보고용 KPI 대시보드 생성 + +#### 26 — 국제 SEO + +| | | +|---|---| +| **목적** | Hreflang 유효성 검사, 콘텐츠 동등성, 다국어 분석 | +| **명령** | `/seo-international` | +| **트리거** | "international SEO", "hreflang" | + +**기능:** +- hreflang 태그 구현 유효성 검사 +- 언어 버전 간 콘텐츠 동등성 확인 +- 국제 URL 구조 분석 (서브도메인 vs. 서브디렉토리 vs. ccTLD) +- 지역 타겟팅 설정 검토 + +#### 27 — AI 가시성 + +| | | +|---|---| +| **목적** | AI 검색 인용, 브랜드 레이더, AI 내 검색 점유율 | +| **명령** | `/seo-ai-visibility` | +| **트리거** | "AI visibility", "AI 검색" | + +**기능:** +- AI 생성 검색 결과에서 브랜드 언급 모니터링 +- AI 검색(ChatGPT, Perplexity, Google AI Overview)에서의 검색 점유율 추적 +- 인용 패턴 및 인용 도메인 분석 +- AI 노출 이력 및 트렌드 측정 + +#### 28 — 지식 그래프 + +| | | +|---|---| +| **목적** | 엔티티 SEO, 지식 패널 최적화, PAA 분석 | +| **명령** | `/seo-knowledge-graph` | +| **트리거** | "knowledge graph", "엔티티 SEO" | + +**기능:** +- Google 지식 그래프에서의 엔티티 존재감 감사 +- 지식 패널 노출 최적화 +- "사용자가 함께 묻는 질문(PAA)" 기회 분석 +- 엔티티 동음이의어 해소 및 구조화된 데이터 연결 검토 + +### 특수 운영 (29-34) + +#### 29 — 게이트웨이 아키텍트 + +| | | +|---|---| +| **목적** | 게이트웨이 페이지 전략 및 아키텍처 설계 | +| **명령** | `/seo-gateway-architect` | +| **트리거** | "SEO strategy", "게이트웨이 페이지" | + +**기능:** +- 타겟 키워드 클러스터에 대한 게이트웨이 페이지 아키텍처 설계 +- URL 구조 및 내부 링크 매핑 +- 콘텐츠 계층 구조 및 필러-클러스터 관계 계획 + +#### 30 — 게이트웨이 빌더 + +| | | +|---|---| +| **목적** | 게이트웨이 페이지 콘텐츠 생성 | +| **명령** | `/seo-gateway-builder` | +| **트리거** | "build gateway page" | + +**기능:** +- 아키텍트 블루프린트 기반 최적화된 게이트웨이 페이지 콘텐츠 생성 +- 메타 태그, 헤딩, 본문, 내부 링크 포함 +- 콘텐츠 구조에 대한 SEO 베스트 프랙티스 준수 + +#### 31 — 경쟁사 인텔리전스 + +| | | +|---|---| +| **목적** | 경쟁사 프로파일링, 벤치마킹, 위협 분석 | +| **명령** | `/seo-competitor-intel` | +| **트리거** | "competitor analysis", "경쟁사 분석" | + +**기능:** +- Ahrefs 데이터를 활용한 경쟁사 SEO 전략 프로파일링 +- 도메인 권한, 트래픽, 키워드 중복도 벤치마킹 +- 경쟁 위협 및 기회 식별 +- 비교 보고서 생성 + +#### 32 — 크롤 예산 + +| | | +|---|---| +| **목적** | 서버 로그 분석, 봇 프로파일링, 크롤 낭비 식별 | +| **명령** | `/seo-crawl-budget` | +| **트리거** | "crawl budget", "로그 분석" | + +**기능:** +- 봇 크롤 패턴에 대한 서버 접근 로그 분석 +- Googlebot, Bingbot 및 기타 크롤러 행동 프로파일링 +- 크롤 낭비 식별 (중복 콘텐츠, Soft 404, 파라미터 URL) +- 크롤 예산 최적화 전략 제안 + +#### 33 — 마이그레이션 플래너 + +| | | +|---|---| +| **목적** | 사이트 이전 계획, 리다이렉트 매핑, 리스크 평가 | +| **명령** | `/seo-migration-planner` | +| **트리거** | "site migration", "사이트 이전", "도메인 이전" | + +**기능:** +- 이전 전 기준선 스냅샷 생성 +- 리다이렉트 매핑 생성 (이전 URL → 새 URL) +- 이전 리스크 요인 평가 +- 이전 후 모니터링 체크포인트 계획 +- 도메인 이전, CMS 이전, HTTPS 전환, URL 재구성 지원 + +#### 34 — 리포팅 대시보드 + +| | | +|---|---| +| **목적** | 경영진 보고서, HTML 대시보드, 데이터 집계 | +| **명령** | `/seo-reporting-dashboard` | +| **트리거** | "SEO report", "SEO 대시보드", "보고서" | + +**기능:** +- 모든 SEO 스킬의 데이터를 통합 보고서로 집계 +- 핵심 지표 및 트렌드가 포함된 경영진 요약 생성 +- 인터랙티브 HTML 대시보드 생성 +- 한국어 보고서 요약 지원 +- 다양한 형식으로 내보내기 (Markdown, HTML, PDF 준비) + +--- + +## 6. 제이미 클리닉 (40-45) + +### 개요 + +제이미 성형외과 클리닉의 디지털 프레즌스를 위한 스킬입니다. 모든 콘텐츠는 엄격한 의료 브랜드 규정을 준수해야 하며 한국어 콘텐츠를 지원합니다. + +#### 40 — 브랜드 에디터 + +| | | +|---|---| +| **목적** | 제이미 클리닉 브랜드 콘텐츠 생성 | +| **명령** | `/jamie-editor` | +| **트리거** | "Jamie 블로그 작성", "Jamie content" | + +**기능:** +- 제이미 브랜드 보이스에 맞는 블로그 및 마케팅 콘텐츠 생성 +- 의료 콘텐츠 규정 준수 가이드라인 적용 +- 일관된 톤 유지: 전문적이면서도 친근한 +- 한국어/영문 콘텐츠 지원 + +#### 41 — 브랜드 감사 + +| | | +|---|---| +| **목적** | 콘텐츠 리뷰 및 브랜드 규정 준수 확인 | +| **명령** | `/jamie-audit` | +| **트리거** | "review content", "브랜드 감사" | + +**기능:** +- 기존 콘텐츠의 브랜드 일관성 리뷰 +- 의료 주장의 규정 준수 여부 확인 +- 톤, 용어, 비주얼 브랜드 준수 유효성 검사 +- 구체적인 수정 제안이 포함된 규정 준수 보고서 생성 + +#### 43 — YouTube 매니저 + +| | | +|---|---| +| **목적** | YouTube 채널 SEO 감사 및 콘텐츠 최적화 | +| **트리거** | "YouTube SEO", "YT 최적화" | + +**기능:** +- YouTube 채널 및 동영상 SEO 감사 +- 타이틀, 설명, 태그, 썸네일 최적화 +- 경쟁사 YouTube 채널 분석 +- 비디오 SEO 콘텐츠 전략 제안 + +#### 44 — 자막 검사기 + +| | | +|---|---| +| **목적** | YouTube 자막 파일(SBV) 유효성 검사 및 오타 수정 | +| **트리거** | "자막 확인", "subtitle QA" | + +**기능:** +- SBV 자막 파일 형식 및 타이밍 유효성 검사 +- 한국어/영문 오타 감지 및 수정 +- 자막 동기화 확인 +- 접근성 규정 준수 확인 + +#### 45 — Instagram 매니저 + +| | | +|---|---| +| **목적** | Instagram 계정 관리 및 전략 | +| **트리거** | "Instagram 관리", "IG 전략" | + +**기능:** +- Instagram 콘텐츠 캘린더 계획 +- 캡션 카피 및 해시태그 전략 생성 +- 참여도 지표 분석 +- 플랫폼에서의 브랜드 비주얼 일관성 유지 + +--- + +## 7. NotebookLM 도구 (50-53) + +### 개요 + +Google NotebookLM 플랫폼을 위한 4가지 전문 스킬로, `notebooklm-py` CLI로 구동됩니다. + +**사전 요구사항 (모든 스킬):** +```bash +pip install notebooklm-py +playwright install chromium +notebooklm login # 브라우저 기반 Google OAuth +``` + +#### 50 — 에이전트 + +| | | +|---|---| +| **목적** | Gemini 기반 인용이 포함된 노트북 Q&A | +| **명령** | `/notebooklm-agent` | +| **트리거** | "ask NotebookLM", "노트북 질문" | + +**기능:** +- 자연어 질문으로 NotebookLM 노트북 쿼리 +- 출처 인용이 포함된 답변 반환 +- 프로그래밍 사용을 위한 JSON 출력 지원 +- 이름 또는 ID로 특정 노트북 지정 가능 + +**예시:** +```bash +notebooklm ask "AI 도입에 대한 핵심 발견사항은?" --json +``` + +#### 51 — 자동화 + +| | | +|---|---| +| **목적** | 노트북, 소스, 아티팩트의 프로그래밍 방식 관리 | +| **명령** | `/notebooklm-automation` | +| **트리거** | "create notebook", "노트북 관리" | + +**기능:** +- 프로그래밍 방식으로 노트북 생성 및 관리 +- 노트북에 소스 (URL, 문서, 텍스트) 추가 +- 기존 노트북 및 소스 목록 조회 및 관리 +- 배치 작업 처리 + +**예시:** +```bash +notebooklm create "리서치 프로젝트 알파" +notebooklm source add "https://example.com/paper.pdf" +notebooklm list --json +``` + +#### 52 — 스튜디오 + +| | | +|---|---| +| **목적** | 콘텐츠 생성: 오디오, 비디오, 퀴즈, 플래시카드, 슬라이드, 마인드맵 | +| **명령** | `/notebooklm-studio` | +| **트리거** | "팟캐스트 만들기", "비디오 생성", "퀴즈 만들기" | + +**기능:** +- 오디오 팟캐스트 생성 (deep-dive, brief, critique, debate 형식) +- 비디오 생성 (classic, whiteboard, kawaii, anime, pixel 등 다양한 스타일) +- 노트북 콘텐츠로부터 퀴즈 및 플래시카드 생성 +- 슬라이드 덱, 인포그래픽, 마인드맵 생성 + +**생성 소요 시간:** + +| 콘텐츠 유형 | 대략적 소요 시간 | +|-----------|--------------| +| 마인드맵 | 즉시 | +| 퀴즈/플래시카드 | 5-15분 | +| 오디오 팟캐스트 | 10-20분 | +| 비디오 | 15-45분 | + +**예시:** +```bash +notebooklm generate audio "AI 윤리에 대한 토론 만들기" --format debate +notebooklm generate video --style whiteboard +notebooklm download audio ./podcast.mp3 +``` + +#### 53 — 리서치 + +| | | +|---|---| +| **목적** | 웹 및 Google Drive 리서치, 소스 발견 | +| **명령** | `/notebooklm-research` | +| **트리거** | "research topic", "리서치" | + +**기능:** +- 웹 리서치 수행 및 결과를 노트북에 자동 임포트 +- 관련 문서에 대한 Google Drive 검색 +- 빠른 모드 (5-10개 소스, 수 초) 및 심층 모드 (20개 이상 소스, 2-5분) 지원 +- 논블로킹 작업 및 상태 폴링 + +**예시:** +```bash +# 빠른 웹 리서치 +notebooklm source add-research "머신러닝 트렌드" + +# 심층 리서치 및 자동 임포트 +notebooklm source add-research "AI 규제" --mode deep --import-all + +# Drive 리서치 +notebooklm source add-research "분기 보고서" --from drive +``` + +--- + +## 8. GTM / 애널리틱스 (60-62) + +### 개요 + +태그 구현의 감사, 관리, 모니터링을 위한 Google Tag Manager 스킬입니다. + +#### 60 — GTM 감사 + +| | | +|---|---| +| **목적** | GTM 컨테이너 감사 및 분석 | +| **명령** | `/gtm-audit` | +| **트리거** | "audit GTM", "GTM 분석" | + +**기능:** +- GTM 컨테이너 설정 감사 +- 미사용 또는 손상된 태그 식별 +- 트리거 설정 및 실행 규칙 확인 +- 변수 정의 및 데이터 레이어 사용 검토 +- 권장사항이 포함된 감사 보고서 생성 + +#### 61 — GTM 매니저 + +| | | +|---|---| +| **목적** | GTM 관리 및 dataLayer 운영 | +| **명령** | `/gtm-manager` | +| **트리거** | "GTM manager", "dataLayer" | + +**기능:** +- GTM 태그, 트리거, 변수 관리 +- dataLayer push 이벤트 설정 +- GTM 워크스페이스 설정 생성 및 수정 +- 배치 태그 작업 지원 + +#### 62 — GTM 가디언 + +| | | +|---|---| +| **목적** | 실시간 태그 모니터링 및 유효성 검사 | +| **트리거** | "monitor GTM", "태그 검증" | + +**기능:** +- 실시간 태그 발화 모니터링 +- 베스트 프랙티스 대비 태그 설정 유효성 검사 +- 태그 오류, 지연 발화, 누락 데이터 알림 +- GTM 관련 질문에 대한 지식 도우미 역할 + +--- + +## 9. Notion 도구 (31-32) + +### 개요 + +Notion 워크스페이스에서 콘텐츠를 관리하고 작성하기 위한 스킬입니다. Notion MCP 통합이 필요합니다. + +#### 31 — Notion 오거나이저 + +| | | +|---|---| +| **목적** | Notion 워크스페이스 관리 및 정리 | +| **명령** | `/notion-organizer` | +| **트리거** | "organize Notion", "워크스페이스 정리" | + +**기능:** +- Notion 페이지 및 데이터베이스 정리 +- 워크스페이스 구조 정리 +- 페이지 속성 및 관계 관리 +- Notion 콘텐츠에 대한 배치 작업 지원 + +#### 32 — Notion 라이터 + +| | | +|---|---| +| **목적** | 마크다운 콘텐츠를 Notion 페이지 또는 데이터베이스에 푸시 | +| **명령** | `/notion-writer` | +| **트리거** | "Notion에 작성", "Notion으로 내보내기" | + +**기능:** +- 마크다운 콘텐츠를 Notion 블록으로 변환 +- 지정된 데이터베이스에 새 페이지 생성 +- 기존 페이지 콘텐츠 업데이트 +- 서식, 헤딩, 코드 블록, 목록 보존 + +--- + +## 10. 레퍼런스 큐레이터 (90) + +### 개요 + +웹에서 레퍼런스 문서를 큐레이션, 처리, 내보내기하는 모듈형 파이프라인입니다. 단일 파이프라인 명령으로 오케스트레이션되는 6개의 하위 스킬로 구성됩니다. + +### 파이프라인 명령 + +| | | +|---|---| +| **명령** | `/reference-curator` | +| **목적** | 전체 파이프라인: 발견 → 크롤링 → 저장 → 정제 → 검토 → 내보내기 | + +### 입력 모드 + +| 모드 | 예시 | 파이프라인 시작 | +|------|------|--------------| +| **주제** | `"Claude 시스템 프롬프트"` | 발견 (1단계) | +| **URL** | `https://docs.anthropic.com/...` | 크롤러 (2단계, 발견 건너뜀) | +| **매니페스트** | `./manifest.json` | 크롤러 (재개) | + +### 주요 인자 + +| 인자 | 기본값 | 설명 | +|------|-------|------| +| `--depth` | `standard` | 크롤 깊이: `light`, `standard`, `deep`, `full` | +| `--output` | `~/Documents/reference-library/` | 출력 디렉토리 (생성 시 권한 요청) | +| `--max-sources` | `100` | 발견할 최대 소스 수 | +| `--max-pages` | 깊이에 따라 변동 | 소스당 최대 페이지 수 | +| `--auto-approve` | 꺼짐 | 임계값 이상의 문서 자동 승인 | +| `--threshold` | `0.85` | QA 승인 임계값 | +| `--export-format` | `project_files` | 출력 형식: `project_files`, `fine_tuning`, `jsonl` | + +### 깊이 레벨 + +``` +light ████░░░░░░░░░░░░ ~20 페이지 메인 콘텐츠만 가장 빠름 +standard ████████░░░░░░░░ ~50 페이지 메인 + 링크 빠름 +deep ████████████░░░░ ~150 페이지 전체 페이지 + HTML 보통 +full ████████████████ ~500 페이지 모든 것 + 원본 HTML 느림 +``` + +### 파이프라인 단계 + +``` +1. reference-discovery 권위 있는 소스 검색 및 검증 +2. web-crawler Firecrawl로 페이지 크롤링 (깊이 제어) +3. content-repository 버전 추적과 함께 문서 저장 +4. content-distiller 요약 및 핵심 개념 추출 + ↕ QA 루프 +5. quality-reviewer 점수 매기기, 승인, 리팩터, 또는 거부 +6. markdown-exporter 최종 형식으로 내보내기 +``` + +### 출력 구조 + +``` +~/Documents/reference-library/ +├── {토픽-슬러그}/ +│ ├── README.md # 목차가 있는 인덱스 +│ ├── 00-page-name.md # 개별 페이지 파일 +│ ├── 01-page-name.md +│ ├── {토픽-슬러그}-complete.md # 통합 번들 +│ └── manifest.json # 크롤 메타데이터 +├── pipeline_state/ # 재개 상태 +└── exports/ # 파인튜닝 / JSONL 내보내기 +``` + +### 예시 + +```bash +# 단일 문서 페이지 빠른 스캔 +/reference-curator https://docs.example.com/api --depth light + +# 표준 문서 크롤링 +/reference-curator "Glossary for WordPress" --max-sources 5 + +# 전체 페이지 콘텐츠 포함 심층 크롤링 +/reference-curator https://docs.codeat.co/glossary/ --depth deep + +# 전체 아카이빙 크롤링 +/reference-curator https://docs.anthropic.com --depth full --max-pages 300 + +# 자동 승인 및 파인튜닝 내보내기 +/reference-curator "MCP servers" --depth deep --auto-approve --export-format fine_tuning +``` + +### 하위 스킬 (개별 사용) + +| 하위 스킬 | 명령 | 목적 | +|----------|------|------| +| reference-discovery | `/reference-discovery` | 소스 검색 및 검증 | +| web-crawler | `/web-crawler` | 멀티 백엔드 크롤링 | +| content-repository | `/content-repository` | 버전 관리가 있는 MySQL 저장소 | +| content-distiller | `/content-distiller` | 요약 및 추출 | +| quality-reviewer | `/quality-reviewer` | QA 루프 라우팅 | +| markdown-exporter | `/markdown-exporter` | 마크다운/JSONL 내보내기 | + +--- + +## 11. 멀티 에이전트 가이드 (91) + +### 개요 + +Claude Code, Gemini, Codex, 인간 리뷰어가 함께 작업하는 프로젝트를 위한 멀티 에이전트 협업 프레임워크를 설정합니다. + +| | | +|---|---| +| **명령** | `/multi-agent-guide` | +| **트리거** | "set up multi-agent", "에이전트 가드레일" | + +### 에이전트 계층 구조 + +``` + ┌─────────────────┐ + │ Claude Code │ + │ (리드 에이전트) │ + └────────┬────────┘ + │ + ┌──────────────┼──────────────┐ + v v v +┌──────────┐ ┌──────────┐ ┌──────────┐ +│ Gemini │ │ Codex │ │ 인간 │ +│ (리서치) │ │ (속도) │ │ (리뷰) │ +└──────────┘ └──────────┘ └──────────┘ +``` + +### 생성되는 파일 + +``` +your-project/ +├── .agent-state/ +│ ├── tasks.yaml # 작업 레지스트리 +│ └── locks.yaml # 잠금 레지스트리 +├── tools/ +│ └── check-ownership.py # 소유권 검증 +├── MULTI_AGENT_FRAMEWORK.md # 통합 규칙 +├── GEMINI.md # Gemini 에이전트 지시서 +└── CODEX.md # Codex 에이전트 지시서 +``` + +### 커밋 규칙 + +``` +[에이전트] 유형(범위): 설명 + +[Claude] feat(core): 인증 기능 구현 +[Gemini] docs(api): API 문서 업데이트 +[Codex] test(models): 단위 테스트 추가 +``` + +--- + +## 12. 아키텍처 및 규칙 + +### 듀얼 플랫폼 구조 + +모든 스킬은 일관된 디렉토리 구조를 따릅니다: + +``` +XX-skill-name/ +├── code/ # Claude Code 버전 +│ ├── CLAUDE.md # 액션 중심 지시서 +│ ├── scripts/ # 실행 가능한 Python/Bash +│ └── docs/ # 문서 +│ +├── desktop/ # Claude Desktop 버전 +│ ├── SKILL.md # YAML 프론트매터가 있는 스킬 지시서 +│ ├── skill.yaml # 확장 메타데이터 (선택) +│ └── tools/ # MCP 도구 문서 +│ +├── shared/ # 공유 리소스 (선택) +│ ├── references/ # 브랜드 가이드라인, 데이터 파일 +│ ├── templates/ # 출력 템플릿 +│ └── scripts/ # 공유 스크립트 +│ +└── README.md # 스킬 개요 +``` + +### 플랫폼 차이점 + +| 항목 | `code/` (Claude Code) | `desktop/` (Claude Desktop) | +|------|----------------------|----------------------------| +| 지시서 | CLAUDE.md | SKILL.md (YAML 프론트매터) | +| 실행 | 직접 Bash/Python | MCP 도구만 | +| 스크립트 | 자동화에 필수 | 참조용 | +| 슬래시 명령 | `.claude/commands/*.md` | 해당 없음 | + +### 공유 설정 + +모든 스킬은 다음의 공통 설정을 공유합니다: +``` +custom-skills/_ourdigital-shared/ +├── config/ +│ └── ourdigital.yaml # 브랜드, 채널, 색상, Notion, 내보내기 +├── requirements/ +│ └── base.txt # Python 의존성 +└── installer/ # 공유 설정 스크립트 +``` + +### 스킬 번호 규칙 + +| 범위 | 도메인 | 상태 | +|------|--------|------| +| 00 | 설정 및 메타 | 활성 | +| 01-09 | OurDigital 코어 | 활성 | +| 10 | 스킬 크리에이터 | 활성 | +| 11-34 | SEO 도구 | 활성 | +| 35-39 | SEO (예약) | 사용 가능 | +| 40-49 | 제이미 클리닉 | 활성 (40-45) | +| 50-59 | NotebookLM | 활성 (50-53) | +| 60-69 | GTM/애널리틱스 | 활성 (60-62) | +| 70-89 | 미지정 | 사용 가능 | +| 90-99 | 인프라스트럭처 | 활성 (90-91) | + +### 설계 원칙 + +1. **한 가지를 잘 수행** — 각 스킬은 단일 기능에 집중 +2. **지시서 1,500단어 이하** — 간결하고 실행 가능하게 +3. **자기 완결성** — 각 플랫폼 버전은 완전히 독립적 +4. **코드 우선** — Claude Code 버전을 먼저 만들고, 이후 Desktop +5. **순차적 번호** — 도메인별 논리적 그룹핑 + +--- + +## 13. 새 스킬 만들기 + +### 스킬 크리에이터 사용 + +```bash +python example-skills/skills-main/skill-creator/scripts/init_skill.py my-new-skill --path custom-skills/ +``` + +### 수동 생성 + +1. **번호 선택** — 위의 번호 규칙에서 사용 가능한 범위 확인 +2. **디렉토리 구조 생성:** + ```bash + mkdir -p custom-skills/XX-my-skill/{code,desktop,shared} + ``` +3. **`code/CLAUDE.md` 작성** — Claude Code용 액션 중심 지시서 +4. **`desktop/SKILL.md` 작성** — YAML 프론트매터가 있는 대화형 지시서 +5. **필요시 스크립트 추가** — `code/scripts/`에 배치 +6. **슬래시 명령 생성** — `.claude/commands/my-skill.md` +7. **`CLAUDE.md` 업데이트** — 저장소 루트의 요약 테이블에 스킬 추가 + +### SKILL.md 프론트매터 형식 + +```markdown +--- +name: my-skill-name +description: | + 스킬이 하는 일에 대한 간단한 설명. + Triggers: keyword1, keyword2, 한국어 트리거. +--- + +# 스킬 제목 + +지시서 내용 시작... +``` + +### 슬래시 명령 형식 + +```markdown +--- +description: 명령 목록에 표시되는 짧은 설명 +argument-hint: <필수-인자> [--선택적 플래그] +allowed-tools: Read, Write, Bash, WebSearch, WebFetch +--- + +# 스킬 제목 + +이 명령이 호출될 때 Claude Code에 대한 지침... +``` + +--- + +## 14. 문제 해결 + +### 일반적인 문제 + +**슬래시 명령이 표시되지 않을 때:** +- Claude Code에서 저장소가 작업 디렉토리로 열려 있는지 확인 +- `.claude/commands/*.md` 파일에 유효한 YAML 프론트매터가 있는지 확인 +- 명령이 최근에 추가되었다면 Claude Code를 재시작 + +**MCP 도구 오류:** +- `/settings-audit`를 실행하여 MCP 연결 문제 진단 +- Claude Code 설정에서 MCP 서버가 구성되어 있는지 확인 +- 환경 변수에 API 키가 설정되어 있는지 확인 + +**NotebookLM 인증:** +```bash +notebooklm login # 세션이 만료된 경우 재인증 +``` + +**SEO 스킬 Python 오류:** +```bash +pip install -r custom-skills/_ourdigital-shared/requirements/base.txt +``` + +**레퍼런스 큐레이터 출력 디렉토리:** +- 기본 출력: `~/Documents/reference-library/` +- 파이프라인은 새 디렉토리 생성 전 권한을 요청합니다 +- 스킬 관련 디렉토리에는 출력을 저장하지 않습니다 + +### 도움 받기 + +- 저장소: https://github.com/ourdigital/our-claude-skills +- 이슈: https://github.com/ourdigital/our-claude-skills/issues +- 자가 진단: `/settings-audit` 실행 + +--- + +*최종 업데이트: 2026-02-24* diff --git a/docs/USER-GUIDE.md b/docs/USER-GUIDE.md new file mode 100644 index 0000000..1685840 --- /dev/null +++ b/docs/USER-GUIDE.md @@ -0,0 +1,1289 @@ +# OurDigital Custom Skills — User Guide + +> A comprehensive guide to the 52 custom skills in the **our-claude-skills** collection. + +--- + +## Table of Contents + +1. [Introduction](#1-introduction) +2. [Quick Start](#2-quick-start) +3. [Skill Categories at a Glance](#3-skill-categories-at-a-glance) +4. [OurDigital Core (00-10)](#4-ourdigital-core-00-10) +5. [SEO Tools (11-34)](#5-seo-tools-11-34) +6. [Jamie Clinic (40-45)](#6-jamie-clinic-40-45) +7. [NotebookLM Tools (50-53)](#7-notebooklm-tools-50-53) +8. [GTM / Analytics (60-62)](#8-gtm--analytics-60-62) +9. [Notion Tools (31-32)](#9-notion-tools-31-32) +10. [Reference Curator (90)](#10-reference-curator-90) +11. [Multi-Agent Guide (91)](#11-multi-agent-guide-91) +12. [Architecture & Conventions](#12-architecture--conventions) +13. [Creating New Skills](#13-creating-new-skills) +14. [Troubleshooting](#14-troubleshooting) + +--- + +## 1. Introduction + +### What Are Custom Skills? + +Custom skills are reusable, domain-specific instruction sets that extend Claude's capabilities. Each skill teaches Claude how to perform a particular task — writing a blog post in the OurDigital brand voice, running an SEO audit, managing a GTM container, or curating reference documentation. + +### Two Platforms, One Collection + +Every skill is designed to work on **two independent platforms**: + +| Platform | Directive File | How It Runs | Best For | +|----------|---------------|-------------|----------| +| **Claude Code** (CLI) | `code/CLAUDE.md` | Direct Bash/Python execution, slash commands | Developers, automation, scripting | +| **Claude Desktop** (App) | `desktop/SKILL.md` | MCP tools only, conversational | Non-technical users, guided workflows | + +You do not need both. Pick the platform you use and follow the corresponding directive. + +### How Skills Are Invoked + +**Claude Code** — Type a slash command in the CLI: + +``` +/seo-technical https://ourdigital.org +/reference-curator "MCP documentation" --depth deep +/notebooklm-studio generate audio "AI trends summary" +``` + +**Claude Desktop** — Use natural language triggers: + +``` +"Run a technical SEO audit on ourdigital.org" +"Create a podcast from my notebook" +"Write a blog post about AI marketing" +``` + +--- + +## 2. Quick Start + +### Prerequisites + +| Requirement | Used By | Install | +|-------------|---------|---------| +| Python 3.10+ | SEO scripts, NotebookLM | `brew install python` | +| Node.js 18+ | GTM scripts, crawlers | `brew install node` | +| Firecrawl MCP | Reference Curator, crawling | Configured in Claude Code MCP settings | +| Notion MCP | Notion skills | Configured in Claude Code MCP settings | +| Ahrefs MCP | SEO skills (11-34) | Configured in Claude Code MCP settings | +| notebooklm-py | NotebookLM skills (50-53) | `pip install notebooklm-py && playwright install chromium` | + +### Installation + +```bash +# Clone the repository +git clone https://github.com/ourdigital/our-claude-skills.git +cd our-claude-skills + +# (Optional) Install SEO dependencies +pip install -r custom-skills/_ourdigital-shared/requirements/base.txt + +# (Optional) Install Reference Curator +cd custom-skills/90-reference-curator && ./install.sh + +# (Optional) Set up NotebookLM +pip install notebooklm-py +playwright install chromium +notebooklm login +``` + +### Verifying Slash Commands + +Once the repository is cloned and opened in Claude Code, slash commands are automatically available from `.claude/commands/`. Type `/` in Claude Code to see the full list. + +--- + +## 3. Skill Categories at a Glance + +| Range | Domain | Count | Description | +|-------|--------|-------|-------------| +| 00 | Settings & Meta | 1 | Claude Code settings optimization | +| 01-10 | OurDigital Core | 10 | Brand, content, design, business tools | +| 11-34 | SEO | 24 | Technical audit through executive reporting | +| 40-45 | Jamie Clinic | 5 | Medical brand content and social media | +| 50-53 | NotebookLM | 4 | AI notebook management and content generation | +| 60-62 | GTM / Analytics | 3 | Tag management and monitoring | +| 31-32 | Notion | 2 | Workspace organization and writing | +| 90 | Reference Curator | 1 (6 sub-skills) | Documentation curation pipeline | +| 91 | Multi-Agent | 1 | Agent collaboration framework | + +**Total: 52 skills** (including Reference Curator sub-skills) + +--- + +## 4. OurDigital Core (00-10) + +### Overview + +The core skills handle brand identity, content creation across multiple channels, visual design, advertising, training, and business operations. + +### 00 — Settings Audit + +| | | +|---|---| +| **Purpose** | Optimize Claude Code settings, audit token usage, diagnose MCP errors | +| **Command** | `/settings-audit` | +| **Triggers** | "settings audit", "exceed response limit", "MCP error" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Analyzes `~/.claude/settings.json` for optimization opportunities +- Reports token usage patterns +- Diagnoses MCP server connection issues +- Recommends permission and hook configurations + +**Example:** +``` +/settings-audit +``` + +### 01 — Brand Guide + +| | | +|---|---| +| **Purpose** | OurDigital brand standards, writing style, visual identity reference | +| **Command** | `/ourdigital-brand-guide` | +| **Triggers** | "brand guide", "writing style", "brand standards" | +| **Platforms** | Desktop (slash command adapted from desktop) | + +**What it does:** +- Provides the OurDigital "Digital Clinic" brand metaphor guidelines +- Defines tone and voice per channel (ourdigital.org, blog, journal, ourstory.day) +- Specifies color palette, typography (Noto Sans KR, Inter), and visual rules +- Enforces the three brand values: Data-driven, In-action, Marketing Science + +**Brand channels:** + +| Channel | Domain | Tone | +|---------|--------|------| +| Main Site | ourdigital.org | Professional, data-driven | +| Blog | blog.ourdigital.org | Analytical, educational | +| Journal | journal.ourdigital.org | Conversational, poetic | +| OurStory | ourstory.day | Intimate, authentic | +| Corporate | dintelligence.co.kr | Professional, B2B | + +### 02 — Blog Writer + +| | | +|---|---| +| **Purpose** | Korean blog creation for blog.ourdigital.org (Ghost) | +| **Triggers** | "write blog post", "블로그 작성" | +| **Platforms** | Desktop | + +**What it does:** +- Writes Korean-language blog posts following OurDigital editorial standards +- Structures content with proper headings, subheadings, and CTA +- Applies the "Digital Clinic" analytical tone +- Targets 800-1,200 words per post + +### 03 — Journal Writer + +| | | +|---|---| +| **Purpose** | English essay/article for journal.ourdigital.org (Ghost) | +| **Triggers** | "write essay", "journal article" | +| **Platforms** | Desktop | + +**What it does:** +- Creates English-language essays and long-form articles +- Uses the conversational, poetic tone defined for the Journal channel +- Handles personal narratives and cultural commentary + +### 04 — Research + +| | | +|---|---| +| **Purpose** | Research-to-Blog workflow | +| **Command** | `/ourdigital-research` | +| **Triggers** | "research this", "blog post research" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Conducts web research on a given topic +- Synthesizes findings into a structured outline +- Optionally transitions into blog/journal writing with the appropriate skill + +### 05 — Document + +| | | +|---|---| +| **Purpose** | Notion-to-Presentation workflow | +| **Command** | `/ourdigital-presentation` | +| **Triggers** | "create document", "Notion export", "presentation" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Exports Notion content into presentation-ready format +- Structures slides with OurDigital brand visual identity +- Supports Korean and English bilingual content + +### 06 — Designer + +| | | +|---|---| +| **Purpose** | Visual storytelling and image prompt generation | +| **Command** | `/ourdigital-designer` | +| **Triggers** | "create image prompt", "visual design" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Generates detailed image prompts for AI image generators +- Follows OurDigital visual brand guidelines (color palette, typography) +- Creates visual storytelling concepts for blog posts and social media + +### 07 — Ad Manager + +| | | +|---|---| +| **Purpose** | Ad copywriting and keyword research | +| **Triggers** | "ad copy", "keyword research", "광고 카피" | +| **Platforms** | Desktop | + +**What it does:** +- Writes ad copy for Google Ads, Meta Ads, and Naver Ads +- Conducts keyword research for paid campaigns +- Generates A/B test variants +- Supports Korean and English ad copy + +### 08 — Trainer + +| | | +|---|---| +| **Purpose** | Training material creation | +| **Triggers** | "create training", "교육 자료" | +| **Platforms** | Desktop | + +**What it does:** +- Creates structured training materials and curricula +- Generates quizzes, exercises, and assessment rubrics +- Supports bilingual (Korean/English) training content + +### 09 — Back Office + +| | | +|---|---| +| **Purpose** | Business document creation | +| **Triggers** | "create proposal", "견적서", "invoice" | +| **Platforms** | Desktop | + +**What it does:** +- Generates business documents: proposals, invoices, contracts +- Applies OurDigital corporate branding +- Supports Korean business document conventions + +### 10 — Skill Creator + +| | | +|---|---| +| **Purpose** | Meta skill for creating new skills | +| **Triggers** | "create skill", "init skill" | +| **Platforms** | Desktop | + +**What it does:** +- Scaffolds new skill directory structure +- Generates boilerplate `CLAUDE.md` and `SKILL.md` files +- Follows the dual-platform convention automatically +- Assigns the next available skill number + +**Example:** +```bash +python example-skills/skills-main/skill-creator/scripts/init_skill.py my-new-skill --path custom-skills/ +``` + +--- + +## 5. SEO Tools (11-34) + +### Overview + +The SEO suite is the largest skill group, covering everything from technical crawlability to executive dashboards. Skills 11-18 focus on site-level audits, 19-28 on strategy and intelligence, and 29-34 on specialized operations and reporting. + +All SEO skills integrate with: +- **Ahrefs MCP** — Domain metrics, backlinks, keyword data +- **Notion** — SEO Audit Log database for persistent records +- **Python scripts** — Shared `base_client.py` patterns (RateLimiter, ConfigManager, BaseAsyncClient) + +### Audit & Technical (11-18) + +#### 11 — Comprehensive Audit + +| | | +|---|---| +| **Purpose** | Unified 6-stage SEO audit orchestrator | +| **Triggers** | "comprehensive SEO", "full SEO audit" | +| **Platforms** | Code + Desktop | + +**What it does:** +Orchestrates skills 12-18 into a single comprehensive audit. Runs technical, on-page, Core Web Vitals, Search Console, schema, and local audits in sequence, producing a unified report. + +#### 12 — Technical Audit + +| | | +|---|---| +| **Purpose** | Robots.txt, sitemap, crawlability analysis | +| **Command** | `/seo-technical` | +| **Triggers** | "technical SEO", "crawlability" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Validates robots.txt directives +- Checks XML sitemap completeness and structure +- Analyzes crawl errors and redirect chains +- Tests HTTPS configuration and canonical tags + +**Example:** +``` +/seo-technical https://ourdigital.org +``` + +#### 13 — On-Page Audit + +| | | +|---|---| +| **Purpose** | Meta tags, headings, internal links | +| **Command** | `/seo-on-page` | +| **Triggers** | "on-page SEO", "meta tags" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Analyzes title tags, meta descriptions, heading hierarchy +- Checks internal linking structure and anchor text +- Validates Open Graph and Twitter Card tags +- Reviews content quality signals + +#### 14 — Core Web Vitals + +| | | +|---|---| +| **Purpose** | LCP, CLS, FID, INP performance metrics | +| **Command** | `/seo-vitals` | +| **Triggers** | "Core Web Vitals", "page speed" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Measures Largest Contentful Paint (LCP) +- Measures Cumulative Layout Shift (CLS) +- Measures First Input Delay (FID) / Interaction to Next Paint (INP) +- Provides actionable optimization recommendations + +#### 15 — Search Console + +| | | +|---|---| +| **Purpose** | Google Search Console data analysis | +| **Command** | `/seo-gsc` | +| **Triggers** | "Search Console", "GSC", "rankings" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Analyzes search performance data (clicks, impressions, CTR, position) +- Identifies keyword opportunities and declining pages +- Reports on index coverage issues +- Tracks ranking changes over time + +#### 16 — Schema Validator + +| | | +|---|---| +| **Purpose** | Structured data validation | +| **Command** | `/seo-schema-validator` | +| **Triggers** | "validate schema", "JSON-LD check" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Validates existing JSON-LD, Microdata, and RDFa markup +- Checks against Google's rich result requirements +- Reports missing required and recommended properties +- Tests against Schema.org vocabulary + +#### 17 — Schema Generator + +| | | +|---|---| +| **Purpose** | Structured data creation | +| **Command** | `/seo-schema-generator` | +| **Triggers** | "generate schema", "create JSON-LD" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Generates JSON-LD markup for various schema types +- Supports: Article, LocalBusiness, Product, FAQ, HowTo, Organization, BreadcrumbList +- Validates output before delivery +- Provides implementation instructions + +#### 18 — Local Audit + +| | | +|---|---| +| **Purpose** | Local SEO: NAP consistency, GBP, citations | +| **Command** | `/seo-local` | +| **Triggers** | "local SEO", "Google Business Profile" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Checks Name-Address-Phone (NAP) consistency across the web +- Audits Google Business Profile completeness +- Analyzes local citation sources +- Reviews local keyword targeting + +### Strategy & Intelligence (19-28) + +#### 19 — Keyword Strategy + +| | | +|---|---| +| **Purpose** | Keyword expansion, intent classification, clustering, gap analysis | +| **Command** | `/seo-keyword-strategy` | +| **Triggers** | "keyword research", "keyword strategy" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Expands seed keywords using Ahrefs data +- Classifies search intent (informational, navigational, commercial, transactional) +- Clusters keywords by topic and SERP similarity +- Identifies content gaps vs. competitors + +**Example:** +``` +/seo-keyword-strategy "digital marketing Seoul" --competitors competitor1.com,competitor2.com +``` + +#### 20 — SERP Analysis + +| | | +|---|---| +| **Purpose** | Google/Naver SERP features and competitor positions | +| **Command** | `/seo-serp-analysis` | +| **Triggers** | "SERP analysis", "SERP features" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Detects SERP features (featured snippets, PAA, knowledge panels, local packs) +- Analyzes competitor positioning for target keywords +- Supports both Google and Naver (Korean search engine) +- Identifies SERP feature opportunities + +#### 21 — Position Tracking + +| | | +|---|---| +| **Purpose** | Rank monitoring, visibility scores, alerts | +| **Command** | `/seo-position-tracking` | +| **Triggers** | "rank tracking", "position monitoring" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Monitors keyword rankings over time +- Calculates visibility scores and share of voice +- Generates alerts for significant ranking changes +- Tracks competitor movements + +#### 22 — Link Building + +| | | +|---|---| +| **Purpose** | Backlink audit, toxic link detection, link gap analysis | +| **Command** | `/seo-link-building` | +| **Triggers** | "backlink audit", "link building" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Audits existing backlink profile using Ahrefs data +- Identifies toxic or spammy links for disavow +- Finds link gap opportunities vs. competitors +- Suggests outreach targets and link-worthy content + +#### 23 — Content Strategy + +| | | +|---|---| +| **Purpose** | Content audit, decay detection, content briefs, topic clusters | +| **Command** | `/seo-content-strategy` | +| **Triggers** | "content strategy", "content audit" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Audits existing content inventory and performance +- Detects content decay (declining traffic/rankings) +- Generates content briefs with keyword targets +- Maps topic clusters and internal linking strategy + +#### 24 — E-commerce SEO + +| | | +|---|---| +| **Purpose** | Product page audit, product schema validation | +| **Command** | `/seo-ecommerce` | +| **Triggers** | "e-commerce SEO", "product SEO" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Audits product page SEO elements (titles, descriptions, images) +- Validates Product schema markup +- Checks category page optimization +- Reviews faceted navigation and crawl efficiency + +#### 25 — KPI Framework + +| | | +|---|---| +| **Purpose** | Unified SEO KPIs, health scores, ROI calculation | +| **Command** | `/seo-kpi-framework` | +| **Triggers** | "SEO KPI", "SEO performance" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Defines and tracks unified SEO KPIs across all audit dimensions +- Calculates composite health scores +- Estimates SEO ROI based on traffic and conversion data +- Generates KPI dashboards for stakeholder reporting + +#### 26 — International SEO + +| | | +|---|---| +| **Purpose** | Hreflang validation, content parity, multi-language analysis | +| **Command** | `/seo-international` | +| **Triggers** | "international SEO", "hreflang" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Validates hreflang tag implementation +- Checks content parity across language versions +- Analyzes international URL structure (subdomain vs. subdirectory vs. ccTLD) +- Reviews geo-targeting settings + +#### 27 — AI Visibility + +| | | +|---|---| +| **Purpose** | AI search citations, brand radar, share of voice in AI | +| **Command** | `/seo-ai-visibility` | +| **Triggers** | "AI visibility", "AI search" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Monitors brand mentions in AI-generated search results +- Tracks share of voice in AI search (ChatGPT, Perplexity, Google AI Overview) +- Analyzes citation patterns and cited domains +- Measures AI impression history and trends + +#### 28 — Knowledge Graph + +| | | +|---|---| +| **Purpose** | Entity SEO, Knowledge Panel optimization, PAA analysis | +| **Command** | `/seo-knowledge-graph` | +| **Triggers** | "knowledge graph", "entity SEO" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Audits entity presence in Google's Knowledge Graph +- Optimizes for Knowledge Panel appearance +- Analyzes "People Also Ask" opportunities +- Reviews entity disambiguation and structured data connections + +### Specialized Operations (29-34) + +#### 29 — Gateway Architect + +| | | +|---|---| +| **Purpose** | Gateway page strategy and architecture design | +| **Command** | `/seo-gateway-architect` | +| **Triggers** | "SEO strategy", "gateway pages" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Designs gateway page architecture for target keyword clusters +- Maps URL structures and internal linking +- Plans content hierarchy and pillar-cluster relationships + +#### 30 — Gateway Builder + +| | | +|---|---| +| **Purpose** | Gateway page content generation | +| **Command** | `/seo-gateway-builder` | +| **Triggers** | "build gateway page" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Generates optimized gateway page content based on architect blueprints +- Includes meta tags, headings, body copy, and internal links +- Follows SEO best practices for content structure + +#### 31 — Competitor Intel + +| | | +|---|---| +| **Purpose** | Competitor profiling, benchmarking, threat analysis | +| **Command** | `/seo-competitor-intel` | +| **Triggers** | "competitor analysis", "competitive intel" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Profiles competitor SEO strategies using Ahrefs data +- Benchmarks domain authority, traffic, and keyword overlap +- Identifies competitive threats and opportunities +- Generates comparative reports + +#### 32 — Crawl Budget + +| | | +|---|---| +| **Purpose** | Server log analysis, bot profiling, crawl waste identification | +| **Command** | `/seo-crawl-budget` | +| **Triggers** | "crawl budget", "log analysis" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Analyzes server access logs for bot crawl patterns +- Profiles Googlebot, Bingbot, and other crawler behavior +- Identifies crawl waste (duplicate content, soft 404s, parameter URLs) +- Recommends crawl budget optimization strategies + +#### 33 — Migration Planner + +| | | +|---|---| +| **Purpose** | Site migration planning, redirect mapping, risk assessment | +| **Command** | `/seo-migration-planner` | +| **Triggers** | "site migration", "domain move", "사이트 이전" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Creates pre-migration baseline snapshots +- Generates redirect mapping (old URL → new URL) +- Assesses migration risk factors +- Plans post-migration monitoring checkpoints +- Supports domain moves, CMS migrations, HTTPS transitions, and URL restructuring + +#### 34 — Reporting Dashboard + +| | | +|---|---| +| **Purpose** | Executive reports, HTML dashboards, data aggregation | +| **Command** | `/seo-reporting-dashboard` | +| **Triggers** | "SEO report", "SEO dashboard", "보고서" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Aggregates data from all other SEO skills into unified reports +- Generates executive summaries with key metrics and trends +- Creates interactive HTML dashboards +- Supports Korean-language report summaries +- Exports to multiple formats (Markdown, HTML, PDF-ready) + +--- + +## 6. Jamie Clinic (40-45) + +### Overview + +Skills for Jamie Plastic Surgery Clinic's digital presence. All content must follow strict medical brand compliance guidelines and supports Korean-language content. + +#### 40 — Brand Editor + +| | | +|---|---| +| **Purpose** | Jamie Clinic branded content generation | +| **Command** | `/jamie-editor` | +| **Triggers** | "write Jamie blog", "Jamie content" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Generates blog posts and marketing content in Jamie's brand voice +- Follows medical content compliance guidelines +- Maintains consistent tone: professional yet approachable +- Supports Korean and English content + +#### 41 — Brand Audit + +| | | +|---|---| +| **Purpose** | Content review and brand compliance checking | +| **Command** | `/jamie-audit` | +| **Triggers** | "review content", "brand audit" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Reviews existing content for brand consistency +- Checks medical claims against compliance standards +- Validates tone, terminology, and visual brand adherence +- Generates compliance reports with specific revision suggestions + +#### 43 — YouTube Manager + +| | | +|---|---| +| **Purpose** | YouTube channel SEO audit and content optimization | +| **Command** | N/A (use trigger) | +| **Triggers** | "YouTube SEO", "YT optimization" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Audits YouTube channel and video SEO +- Optimizes titles, descriptions, tags, and thumbnails +- Analyzes competitor YouTube channels +- Suggests content strategy for video SEO + +#### 44 — Subtitle Checker + +| | | +|---|---| +| **Purpose** | YouTube subtitle file (SBV) validation and typo correction | +| **Command** | N/A (use trigger) | +| **Triggers** | "check subtitles", "subtitle QA" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Validates SBV subtitle file format and timing +- Detects and corrects Korean/English typos +- Checks subtitle synchronization +- Ensures accessibility compliance + +#### 45 — Instagram Manager + +| | | +|---|---| +| **Purpose** | Instagram account management and strategy | +| **Command** | N/A (use trigger) | +| **Triggers** | "Instagram management", "IG strategy" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Plans Instagram content calendar +- Generates caption copy and hashtag strategies +- Analyzes engagement metrics +- Maintains brand visual consistency on the platform + +--- + +## 7. NotebookLM Tools (50-53) + +### Overview + +Four specialized skills for Google's NotebookLM platform, powered by the `notebooklm-py` CLI. + +**Prerequisites (all skills):** +```bash +pip install notebooklm-py +playwright install chromium +notebooklm login # Browser-based Google OAuth +``` + +#### 50 — Agent + +| | | +|---|---| +| **Purpose** | Q&A from notebooks with Gemini-powered citations | +| **Command** | `/notebooklm-agent` | +| **Triggers** | "ask NotebookLM", "query notebook", "노트북 질문" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Queries NotebookLM notebooks with natural language questions +- Returns answers with source citations +- Supports JSON output for programmatic use +- Can target specific notebooks by name or ID + +**Example:** +```bash +notebooklm ask "What are the key findings about AI adoption?" --json +``` + +#### 51 — Automation + +| | | +|---|---| +| **Purpose** | Programmatic notebook, source, and artifact management | +| **Command** | `/notebooklm-automation` | +| **Triggers** | "create notebook", "add sources", "노트북 관리" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Creates and manages notebooks programmatically +- Adds sources (URLs, documents, text) to notebooks +- Lists and manages existing notebooks and sources +- Handles batch operations + +**Example:** +```bash +notebooklm create "Research Project Alpha" +notebooklm source add "https://example.com/paper.pdf" +notebooklm list --json +``` + +#### 52 — Studio + +| | | +|---|---| +| **Purpose** | Content generation: audio, video, quizzes, flashcards, slides, mind maps | +| **Command** | `/notebooklm-studio` | +| **Triggers** | "create podcast", "generate video", "make quiz", "팟캐스트 만들기" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Generates audio podcasts (deep-dive, brief, critique, debate formats) +- Creates videos (classic, whiteboard, kawaii, anime, pixel, and more styles) +- Builds quizzes and flashcards from notebook content +- Generates slide decks, infographics, and mind maps + +**Generation times:** + +| Content Type | Approximate Time | +|-------------|-----------------| +| Mind map | Instant | +| Quiz/Flashcards | 5-15 min | +| Audio podcast | 10-20 min | +| Video | 15-45 min | + +**Example:** +```bash +notebooklm generate audio "Create a debate about AI ethics" --format debate +notebooklm generate video --style whiteboard +notebooklm download audio ./podcast.mp3 +``` + +#### 53 — Research + +| | | +|---|---| +| **Purpose** | Web and Google Drive research, source discovery | +| **Command** | `/notebooklm-research` | +| **Triggers** | "research topic", "find sources", "리서치" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Conducts web research and auto-imports results into notebooks +- Searches Google Drive for relevant documents +- Supports fast mode (5-10 sources, seconds) and deep mode (20+ sources, 2-5 min) +- Non-blocking operation with status polling + +**Example:** +```bash +# Fast web research +notebooklm source add-research "machine learning trends" + +# Deep research with auto-import +notebooklm source add-research "AI regulation" --mode deep --import-all + +# Drive research +notebooklm source add-research "quarterly report" --from drive +``` + +--- + +## 8. GTM / Analytics (60-62) + +### Overview + +Google Tag Manager skills for auditing, managing, and monitoring tag implementations. + +#### 60 — GTM Audit + +| | | +|---|---| +| **Purpose** | GTM container audit and analysis | +| **Command** | `/gtm-audit` | +| **Triggers** | "audit GTM", "GTM analysis" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Audits GTM container configuration +- Identifies unused or broken tags +- Checks trigger configurations and firing rules +- Reviews variable definitions and data layer usage +- Generates audit report with recommendations + +#### 61 — GTM Manager + +| | | +|---|---| +| **Purpose** | GTM management and dataLayer operations | +| **Command** | `/gtm-manager` | +| **Triggers** | "GTM manager", "dataLayer" | +| **Platforms** | Code | + +**What it does:** +- Manages GTM tags, triggers, and variables +- Configures dataLayer push events +- Creates and modifies GTM workspace configurations +- Supports batch tag operations + +#### 62 — GTM Guardian + +| | | +|---|---| +| **Purpose** | Live tag monitoring and validation | +| **Command** | N/A (use trigger) | +| **Triggers** | "monitor GTM", "tag validation" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Monitors live tag firing in real-time +- Validates tag configurations against best practices +- Alerts on tag errors, slow-firing tags, or missing data +- Acts as a knowledge assistant for GTM questions + +--- + +## 9. Notion Tools (31-32) + +### Overview + +Skills for managing and writing content within Notion workspaces. Requires the Notion MCP integration. + +#### 31 — Notion Organizer + +| | | +|---|---| +| **Purpose** | Notion workspace management and organization | +| **Command** | `/notion-organizer` | +| **Triggers** | "organize Notion", "workspace cleanup" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Organizes Notion pages and databases +- Cleans up workspace structure +- Manages page properties and relations +- Supports batch operations on Notion content + +#### 32 — Notion Writer + +| | | +|---|---| +| **Purpose** | Push markdown content to Notion pages or databases | +| **Command** | `/notion-writer` | +| **Triggers** | "write to Notion", "export to Notion" | +| **Platforms** | Code + Desktop | + +**What it does:** +- Converts markdown content to Notion blocks +- Creates new pages in specified databases +- Updates existing page content +- Preserves formatting, headings, code blocks, and lists + +--- + +## 10. Reference Curator (90) + +### Overview + +A modular pipeline for curating, processing, and exporting reference documentation from the web. Consists of 6 sub-skills orchestrated by a single pipeline command. + +### Pipeline Command + +| | | +|---|---| +| **Command** | `/reference-curator` | +| **Purpose** | Full pipeline: discover → crawl → store → distill → review → export | + +### Input Modes + +| Mode | Example | Pipeline Start | +|------|---------|---------------| +| **Topic** | `"Claude system prompts"` | Discovery (Stage 1) | +| **URLs** | `https://docs.anthropic.com/...` | Crawler (Stage 2, skip discovery) | +| **Manifest** | `./manifest.json` | Crawler (resume) | + +### Key Arguments + +| Argument | Default | Description | +|----------|---------|-------------| +| `--depth` | `standard` | Crawl depth: `light`, `standard`, `deep`, `full` | +| `--output` | `~/Documents/reference-library/` | Output directory (asks permission to create) | +| `--max-sources` | `100` | Max sources to discover | +| `--max-pages` | varies by depth | Max pages per source | +| `--auto-approve` | off | Auto-approve documents scoring above threshold | +| `--threshold` | `0.85` | QA approval threshold | +| `--export-format` | `project_files` | Output format: `project_files`, `fine_tuning`, `jsonl` | + +### Depth Levels + +``` +light ████░░░░░░░░░░░░ ~20 pages Main content only Fastest +standard ████████░░░░░░░░ ~50 pages Main + links Fast +deep ████████████░░░░ ~150 pages Full page + HTML Moderate +full ████████████████ ~500 pages Everything + raw HTML Slow +``` + +### Pipeline Stages + +``` +1. reference-discovery Search & validate authoritative sources +2. web-crawler Crawl pages using Firecrawl (depth-controlled) +3. content-repository Store documents with version tracking +4. content-distiller Summarize and extract key concepts + ↕ QA Loop +5. quality-reviewer Score, approve, refactor, or reject +6. markdown-exporter Export to final format +``` + +### Output Structure + +``` +~/Documents/reference-library/ +├── {topic-slug}/ +│ ├── README.md # Index with table of contents +│ ├── 00-page-name.md # Individual page files +│ ├── 01-page-name.md +│ ├── {topic-slug}-complete.md # Combined bundle +│ └── manifest.json # Crawl metadata +├── pipeline_state/ # Resume state +└── exports/ # Fine-tuning / JSONL exports +``` + +### Examples + +```bash +# Quick scan of a single doc page +/reference-curator https://docs.example.com/api --depth light + +# Standard documentation crawl +/reference-curator "Glossary for WordPress" --max-sources 5 + +# Deep crawl with full page content +/reference-curator https://docs.codeat.co/glossary/ --depth deep + +# Full archival crawl +/reference-curator https://docs.anthropic.com --depth full --max-pages 300 + +# Auto-approve with fine-tuning export +/reference-curator "MCP servers" --depth deep --auto-approve --export-format fine_tuning +``` + +### Sub-skills (Individual Use) + +| Sub-skill | Command | Purpose | +|-----------|---------|---------| +| reference-discovery | `/reference-discovery` | Search & validate sources | +| web-crawler | `/web-crawler` | Multi-backend crawling | +| content-repository | `/content-repository` | MySQL storage with versioning | +| content-distiller | `/content-distiller` | Summarization & extraction | +| quality-reviewer | `/quality-reviewer` | QA loop routing | +| markdown-exporter | `/markdown-exporter` | Export to markdown/JSONL | + +--- + +## 11. Multi-Agent Guide (91) + +### Overview + +Sets up a multi-agent collaboration framework for projects where Claude Code, Gemini, Codex, and human reviewers work together. + +| | | +|---|---| +| **Command** | `/multi-agent-guide` | +| **Triggers** | "set up multi-agent", "agent guardrails" | + +### Agent Hierarchy + +``` + ┌─────────────────┐ + │ Claude Code │ + │ (Lead Agent) │ + └────────┬────────┘ + │ + ┌──────────────┼──────────────┐ + v v v +┌──────────┐ ┌──────────┐ ┌──────────┐ +│ Gemini │ │ Codex │ │ Human │ +│(Research)│ │ (Speed) │ │ (Review) │ +└──────────┘ └──────────┘ └──────────┘ +``` + +### What It Creates + +``` +your-project/ +├── .agent-state/ +│ ├── tasks.yaml # Task registry +│ └── locks.yaml # Lock registry +├── tools/ +│ └── check-ownership.py # Ownership verification +├── MULTI_AGENT_FRAMEWORK.md # Consolidated rules +├── GEMINI.md # Gemini agent directive +└── CODEX.md # Codex agent directive +``` + +### Commit Convention + +``` +[Agent] type(scope): description + +[Claude] feat(core): implement authentication +[Gemini] docs(api): update API documentation +[Codex] test(models): add unit tests +``` + +--- + +## 12. Architecture & Conventions + +### Dual-Platform Structure + +Every skill follows a consistent directory structure: + +``` +XX-skill-name/ +├── code/ # Claude Code version +│ ├── CLAUDE.md # Action-oriented directive +│ ├── scripts/ # Executable Python/Bash +│ └── docs/ # Documentation +│ +├── desktop/ # Claude Desktop version +│ ├── SKILL.md # Skill directive with YAML frontmatter +│ ├── skill.yaml # Extended metadata (optional) +│ └── tools/ # MCP tool documentation +│ +├── shared/ # Shared resources (optional) +│ ├── references/ # Brand guidelines, data files +│ ├── templates/ # Output templates +│ └── scripts/ # Shared scripts +│ +└── README.md # Skill overview +``` + +### Platform Differences + +| Aspect | `code/` (Claude Code) | `desktop/` (Claude Desktop) | +|--------|----------------------|----------------------------| +| Directive | CLAUDE.md | SKILL.md (YAML frontmatter) | +| Execution | Direct Bash/Python | MCP tools only | +| Scripts | Required for automation | Reference only | +| Slash commands | `.claude/commands/*.md` | N/A | + +### Shared Configuration + +All skills share common configuration at: +``` +custom-skills/_ourdigital-shared/ +├── config/ +│ └── ourdigital.yaml # Brand, channels, colors, Notion, exports +├── requirements/ +│ └── base.txt # Python dependencies +└── installer/ # Shared setup scripts +``` + +### Skill Numbering Convention + +| Range | Domain | Status | +|-------|--------|--------| +| 00 | Settings & Meta | Active | +| 01-09 | OurDigital Core | Active | +| 10 | Skill Creator | Active | +| 11-34 | SEO Tools | Active | +| 35-39 | SEO (Reserved) | Available | +| 40-49 | Jamie Clinic | Active (40-45) | +| 50-59 | NotebookLM | Active (50-53) | +| 60-69 | GTM/Analytics | Active (60-62) | +| 70-89 | Unassigned | Available | +| 90-99 | Infrastructure | Active (90-91) | + +### Design Principles + +1. **One thing done well** — Each skill focuses on a single capability +2. **Directives under 1,500 words** — Concise and actionable +3. **Self-contained** — Each platform version is fully independent +4. **Code-first** — Build the Claude Code version first, then Desktop +5. **Progressive numbering** — Logical grouping by domain + +--- + +## 13. Creating New Skills + +### Using the Skill Creator + +```bash +python example-skills/skills-main/skill-creator/scripts/init_skill.py my-new-skill --path custom-skills/ +``` + +### Manual Creation + +1. **Choose a number** from the available ranges (see numbering convention above) +2. **Create the directory structure:** + ```bash + mkdir -p custom-skills/XX-my-skill/{code,desktop,shared} + ``` +3. **Write `code/CLAUDE.md`** — Action-oriented directive for Claude Code +4. **Write `desktop/SKILL.md`** — Conversational directive with YAML frontmatter +5. **Add scripts** if needed in `code/scripts/` +6. **Create a slash command** in `.claude/commands/my-skill.md` +7. **Update `CLAUDE.md`** at the repo root to include your skill in the summary table + +### SKILL.md Frontmatter Format + +```markdown +--- +name: my-skill-name +description: | + Brief description of what the skill does. + Triggers: keyword1, keyword2, 한국어 트리거. +--- + +# Skill Title + +Directive content starts here... +``` + +### Slash Command Format + +```markdown +--- +description: Short description shown in command list +argument-hint: [--optional flag] +allowed-tools: Read, Write, Bash, WebSearch, WebFetch +--- + +# Skill Title + +Instructions for Claude Code when this command is invoked... +``` + +--- + +## 14. Troubleshooting + +### Common Issues + +**Slash commands not showing up:** +- Ensure the repo is opened as the working directory in Claude Code +- Check that `.claude/commands/*.md` files have valid YAML frontmatter +- Restart Claude Code if commands were recently added + +**MCP tool errors:** +- Run `/settings-audit` to diagnose MCP connection issues +- Verify MCP servers are configured in Claude Code settings +- Check that API keys are set in environment variables + +**NotebookLM authentication:** +```bash +notebooklm login # Re-authenticate if session expired +``` + +**SEO skill Python errors:** +```bash +pip install -r custom-skills/_ourdigital-shared/requirements/base.txt +``` + +**Reference Curator output directory:** +- Default output: `~/Documents/reference-library/` +- The pipeline will ask permission before creating new directories +- Never stores output in skill-related directories + +### Getting Help + +- Repository: https://github.com/ourdigital/our-claude-skills +- Issues: https://github.com/ourdigital/our-claude-skills/issues +- Run `/settings-audit` for self-diagnostics + +--- + +*Last updated: 2026-02-24*