refactor(skills): Restructure skills to dual-platform architecture

Major refactoring of ourdigital-custom-skills with new numbering system: ## Structure Changes - Each skill now has code/ (Claude Code) and desktop/ (Claude Desktop) versions - New progressive numbering: 01-09 General, 10-19 SEO, 20-29 GTM, 30-39 OurDigital, 40-49 Jamie ## Skill Reorganization - 01-notion-organizer (from 02) - 10-18: SEO tools split into focused skills (technical, on-page, local, schema, vitals, gsc, gateway) - 20-21: GTM audit and manager - 30-32: OurDigital designer, research, presentation - 40-41: Jamie brand editor and audit ## New Files - .claude/commands/: Slash command definitions for all skills - CLAUDE.md: Updated with new skill structure documentation - REFACTORING_PLAN.md: Migration documentation - COMPATIBILITY_REPORT.md, SKILLS_COMPARISON.md: Analysis docs ## Removed - Old skill directories (02-05, 10-14, 20-21 old numbering) - Consolidated into new structure with _archive/ for reference 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-22 01:58:24 +09:00
parent 214247ace2
commit eea49f9f8c
251 changed files with 12308 additions and 102 deletions
--- a/.claude/commands/gtm-audit.md
+++ b/.claude/commands/gtm-audit.md
@@ -0,0 +1,42 @@
+# GTM Audit
+
+Lightweight Google Tag Manager audit tool.
+
+## Triggers
+- "audit GTM", "check dataLayer", "GTM 검사"
+
+## Capabilities
+
+1. **Container Analysis** - Tags, triggers, variables inventory
+2. **DataLayer Validation** - Check event structure
+3. **Form Tracking** - Verify form submission events
+4. **E-commerce Check** - Validate purchase/cart events
+
+## Scripts
+
+```bash
+# Audit GTM container
+python ourdigital-custom-skills/20-gtm-audit/code/scripts/gtm_audit.py \
+  --url https://example.com
+
+# With detailed dataLayer check
+python ourdigital-custom-skills/20-gtm-audit/code/scripts/gtm_audit.py \
+  --url https://example.com --check-datalayer --output report.json
+```
+
+## Audit Checklist
+
+### Container Health
+- [ ] GTM container loads correctly
+- [ ] No JavaScript errors from GTM
+- [ ] Container ID matches expected
+
+### DataLayer Events
+- [ ] `page_view` fires on all pages
+- [ ] `purchase` event has required fields
+- [ ] Form submissions tracked
+
+### Common Issues
+- Missing ecommerce object
+- Incorrect event names (GA4 format)
+- Duplicate event firing
--- a/.claude/commands/gtm-manager.md
+++ b/.claude/commands/gtm-manager.md
@@ -0,0 +1,49 @@
+# GTM Manager
+
+Full GTM management with dataLayer injection and tag generation.
+
+## Triggers
+- "GTM manager", "generate dataLayer tag", "dataLayer 태그 생성"
+
+## Capabilities
+
+1. **Full Audit** - Everything in gtm-audit plus more
+2. **DataLayer Injector** - Generate custom HTML tags
+3. **Event Mapping** - Map site actions to GA4 events
+4. **Notion Export** - Save audit results to Notion
+
+## Scripts
+
+```bash
+# Full GTM management
+python ourdigital-custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \
+  --url https://example.com --full-audit
+
+# Generate dataLayer tag
+python ourdigital-custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \
+  --generate-tag purchase --output purchase_tag.html
+
+# Export to Notion
+python ourdigital-custom-skills/21-gtm-manager/code/scripts/gtm_manager.py \
+  --url https://example.com --notion-export --database DATABASE_ID
+```
+
+## DataLayer Tag Templates
+
+### Purchase Event
+```html
+<script>
+dataLayer.push({
+  'event': 'purchase',
+  'ecommerce': {
+    'transaction_id': '{{Order ID}}',
+    'value': {{Order Total}},
+    'currency': 'KRW',
+    'items': [...]
+  }
+});
+</script>
+```
+
+## Environment
+- `NOTION_TOKEN` - For Notion export (optional)
--- a/.claude/commands/jamie-audit.md
+++ b/.claude/commands/jamie-audit.md
@@ -0,0 +1,60 @@
+# Jamie Brand Audit
+
+Jamie Clinic content **review and evaluation** tool.
+
+## Triggers
+- "review Jamie content", "브랜드 검토", "audit brand compliance"
+
+## Capabilities (Guidance-based)
+
+1. **Voice & Tone Check** - 격식체 ratio, honorifics
+2. **Brand Alignment** - Slogan, values, no competitors
+3. **Regulatory Compliance** - Medical advertising laws
+4. **Technical Accuracy** - Procedure facts, recovery times
+
+## Review Checklist
+
+### Voice & Tone
+- [ ] 90% 격식체 ratio maintained
+- [ ] Correct honorifics (환자분/고객님)
+- [ ] Jamie personality traits present
+
+### Brand Alignment
+- [ ] Slogan consistency
+- [ ] Core values reflected
+- [ ] No competitor mentions
+
+### Regulatory Compliance
+- [ ] No exaggerated claims
+- [ ] No guarantee language
+- [ ] Proper disclosures included
+
+### Technical Accuracy
+- [ ] Procedure facts correct
+- [ ] Medical terms accurate
+- [ ] Recovery times realistic
+
+## Output Format
+
+```markdown
+# Brand Audit Report
+
+## Overall Score: 85/100
+
+## Issues Found
+1. Line 23: "최고의" → Remove superlative claim
+2. Line 45: Missing disclosure for before/after image
+
+## Recommendations
+- Adjust tone in paragraph 3
+- Add required disclaimers
+
+## Verdict: REVISION REQUIRED
+```
+
+## Workflow
+1. Receive content for review
+2. Check against brand guidelines
+3. Verify regulatory compliance
+4. Provide structured feedback
+5. Recommend approval/revision
--- a/.claude/commands/jamie-editor.md
+++ b/.claude/commands/jamie-editor.md
@@ -0,0 +1,47 @@
+# Jamie Brand Editor
+
+Jamie Clinic content **generation** toolkit.
+
+## Triggers
+- "write Jamie blog", "제이미 콘텐츠 생성", "create Jamie content"
+
+## Capabilities
+
+1. **Blog Posts** - 블로그 포스팅
+2. **Procedure Pages** - 시술 페이지
+3. **Ad Copy** - 광고 카피
+4. **Social Media** - SNS 콘텐츠
+5. **Compliance Check** - Korean medical ad regulations
+
+## Scripts
+
+```bash
+# Check content compliance
+python ourdigital-custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \
+  --input draft.md
+
+# With detailed report
+python ourdigital-custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \
+  --input draft.md --verbose --output report.json
+
+# Batch check
+python ourdigital-custom-skills/40-jamie-brand-editor/code/scripts/compliance_checker.py \
+  --dir ./drafts --output compliance_report.json
+```
+
+## Brand Voice Requirements
+
+| Rule | Requirement |
+|------|-------------|
+| 격식체 ratio | 90% (~습니다/~입니다) |
+| Patient reference | "환자분" for medical contexts |
+| Key descriptor | "자연스러운" (natural) |
+| Tone | No exaggeration, realistic expectations |
+
+## Compliance Rules
+
+- ❌ No exaggerated claims
+- ❌ No before/after comparison violations
+- ❌ No guarantee language
+- ❌ No competitor comparisons
+- ✅ Proper disclosure requirements
--- a/.claude/commands/notion-organizer.md
+++ b/.claude/commands/notion-organizer.md
@@ -0,0 +1,32 @@
+# Notion Organizer
+
+Notion workspace management agent for organizing, restructuring, and maintaining databases.
+
+## Triggers
+- "organize Notion", "노션 정리", "database cleanup"
+
+## Capabilities
+
+1. **Database Schema Analysis** - Analyze and document database structures
+2. **Property Cleanup** - Remove unused properties, standardize types
+3. **Data Migration** - Move data between databases with mapping
+4. **Bulk Operations** - Archive, tag, or update multiple pages
+
+## Scripts
+
+```bash
+# Analyze database schema
+python ourdigital-custom-skills/01-notion-organizer/code/scripts/schema_migrator.py \
+  --source-db DATABASE_ID --analyze
+
+# Migrate with mapping
+python ourdigital-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 ourdigital-custom-skills/01-notion-organizer/code/scripts/async_organizer.py \
+  --database DATABASE_ID --operation archive --filter "Status=Done"
+```
+
+## Environment
+- `NOTION_TOKEN` - Notion integration token (required)
--- a/.claude/commands/ourdigital-designer.md
+++ b/.claude/commands/ourdigital-designer.md
@@ -0,0 +1,43 @@
+# OurDigital Designer
+
+Visual storytelling toolkit for blog featured images.
+
+## Triggers
+- "create image prompt", "블로그 이미지", "featured image"
+
+## Capabilities
+
+1. **Concept Extraction** - Extract visual themes from essay text
+2. **Prompt Generation** - Create AI image prompts
+3. **Mood Calibration** - Fine-tune emotional parameters
+4. **Style Consistency** - OurDigital brand visual language
+
+## Scripts
+
+```bash
+# Generate image prompt
+python ourdigital-custom-skills/30-ourdigital-designer/code/scripts/generate_prompt.py \
+  --topic "AI identity" --mood "contemplative"
+
+# From essay text
+python ourdigital-custom-skills/30-ourdigital-designer/code/scripts/generate_prompt.py \
+  --input essay.txt --auto-extract
+
+# Calibrate mood
+python ourdigital-custom-skills/30-ourdigital-designer/code/scripts/mood_calibrator.py \
+  --input "essay excerpt" --style "minimalist"
+```
+
+## Visual Style Guide
+
+| Essay Type | Strategy | Colors |
+|------------|----------|--------|
+| Technology | Organic-digital hybrids | Cool blues → warm accents |
+| Social | Network patterns | Desaturated → hope spots |
+| Philosophy | Zen space, symbols | Monochrome + single accent |
+
+## Output Format
+- 1200x630px (OG image standard)
+- Minimalist vector + subtle textures
+- 60-30-10 color rule
+- 20%+ negative space
--- a/.claude/commands/ourdigital-presentation.md
+++ b/.claude/commands/ourdigital-presentation.md
@@ -0,0 +1,42 @@
+# OurDigital Presentation
+
+Notion-to-presentation workflow for branded slides.
+
+## Triggers
+- "create presentation", "Notion to PPT", "프레젠테이션 만들기"
+
+## Capabilities
+
+1. **Notion Extraction** - Pull content from Notion pages
+2. **Content Synthesis** - Structure into slide format
+3. **Brand Application** - Apply corporate styling
+4. **Multi-format Output** - PowerPoint, Figma, HTML
+
+## Scripts
+
+```bash
+# Full automated workflow
+python ourdigital-custom-skills/32-ourdigital-presentation/code/scripts/run_workflow.py \
+  --notion-url [NOTION_URL] --output presentation.pptx
+
+# Step-by-step
+python ourdigital-custom-skills/32-ourdigital-presentation/code/scripts/extract_notion.py [URL] > research.json
+python ourdigital-custom-skills/32-ourdigital-presentation/code/scripts/synthesize_content.py research.json > synthesis.json
+python ourdigital-custom-skills/32-ourdigital-presentation/code/scripts/apply_brand.py synthesis.json --output presentation.pptx
+```
+
+## Pipeline
+
+```
+extract_notion.py → synthesize_content.py → apply_brand.py
+     ↓                    ↓                      ↓
+ research.json       synthesis.json         presentation.pptx
+```
+
+## Output Formats
+- PowerPoint (.pptx)
+- Figma (via API)
+- HTML preview
+
+## Environment
+- `NOTION_TOKEN` - Notion API token (required)
--- a/.claude/commands/ourdigital-research.md
+++ b/.claude/commands/ourdigital-research.md
@@ -0,0 +1,45 @@
+# OurDigital Research
+
+Research-to-publication workflow for OurDigital blogs.
+
+## Triggers
+- "export to Ulysses", "publish research", "블로그 발행"
+
+## Capabilities
+
+1. **Markdown Export** - Format research for publishing
+2. **Ulysses Integration** - Direct export to Ulysses app
+3. **Publishing Checklist** - Pre-publish verification
+4. **Multi-target** - blog.ourdigital.org, journal, ourstory.day
+
+## Scripts
+
+```bash
+# Export to Ulysses
+python ourdigital-custom-skills/31-ourdigital-research/code/scripts/export_to_ulysses.py \
+  --input research.md --group "Blog Drafts"
+
+# With tags
+python ourdigital-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 ourdigital-custom-skills/31-ourdigital-research/code/scripts/export_to_ulysses.py \
+  --notion-export notion_export.zip \
+  --group "From Notion"
+```
+
+## Workflow
+
+1. Complete research in Claude/Notion
+2. Export to markdown
+3. Run export script → Ulysses
+4. Edit and polish in Ulysses
+5. Publish to Ghost/OurDigital
+
+## Output Targets
+- **blog.ourdigital.org** - Main blog
+- **journal.ourdigital.org** - Long-form essays
+- **ourstory.day** - Personal narratives
--- a/.claude/commands/seo-gateway-architect.md
+++ b/.claude/commands/seo-gateway-architect.md
@@ -0,0 +1,51 @@
+# SEO Gateway Architect
+
+Keyword strategy and content architecture for gateway pages.
+
+## Triggers
+- "keyword strategy", "SEO planning", "게이트웨이 전략"
+
+## Capabilities
+
+1. **Keyword Analysis** - Volume, difficulty, intent
+2. **LSI Keywords** - Related semantic keywords
+3. **Long-tail Opportunities** - Location + service combinations
+4. **Content Architecture** - Recommended H1-H3 structure
+
+## Scripts
+
+```bash
+# Analyze keyword
+python ourdigital-custom-skills/17-seo-gateway-architect/code/scripts/keyword_analyzer.py \
+  --topic "눈 성형"
+
+# With location targeting
+python ourdigital-custom-skills/17-seo-gateway-architect/code/scripts/keyword_analyzer.py \
+  --topic "눈 성형" --market "강남" --output strategy.json
+```
+
+## Output
+
+```
+# Keyword Analysis Report
+
+## Primary Keyword: 강남 눈 성형
+- Search Volume: 12,000
+- Difficulty: 65/100
+- Intent: Informational
+
+## LSI Keywords
+1. 쌍꺼풀 수술 - Volume: 8,000
+2. 눈매교정 - Volume: 5,500
+...
+
+## Recommendations
+1. Focus on educational content
+2. Include FAQ schema markup
+3. Target long-tail keywords for quick wins
+```
+
+## Workflow
+1. Run keyword analysis
+2. Review strategy output
+3. Hand off to `/seo-gateway-builder` for content
--- a/.claude/commands/seo-gateway-builder.md
+++ b/.claude/commands/seo-gateway-builder.md
@@ -0,0 +1,55 @@
+# SEO Gateway Builder
+
+Generate SEO-optimized gateway pages from templates.
+
+## Triggers
+- "build gateway page", "generate landing pages", "게이트웨이 페이지 생성"
+
+## Capabilities
+
+1. **Template-based Generation** - Medical, service, local templates
+2. **Batch Creation** - Multiple location × service combinations
+3. **SEO Optimization** - Meta tags, schema, internal links
+4. **Localization** - Korean/English content support
+
+## Scripts
+
+```bash
+# Generate with sample data
+python ourdigital-custom-skills/18-seo-gateway-builder/code/scripts/generate_pages.py
+
+# Custom configuration
+python ourdigital-custom-skills/18-seo-gateway-builder/code/scripts/generate_pages.py \
+  --config config/services.json \
+  --locations config/locations.json \
+  --output ./pages
+```
+
+## Configuration
+
+### services.json
+```json
+{
+  "services": [{
+    "id": "laser_hair_removal",
+    "korean": "레이저 제모",
+    "keywords": ["permanent hair removal"]
+  }]
+}
+```
+
+### locations.json
+```json
+{
+  "locations": [{
+    "id": "gangnam",
+    "korean": "강남",
+    "landmarks": ["COEX", "Gangnam Station"]
+  }]
+}
+```
+
+## Output
+- Markdown files with SEO meta
+- Schema markup included
+- Internal linking suggestions
--- a/.claude/commands/seo-gsc.md
+++ b/.claude/commands/seo-gsc.md
@@ -0,0 +1,37 @@
+# SEO Search Console
+
+Google Search Console data retrieval and analysis.
+
+## Triggers
+- "get GSC data", "Search Console report", "search performance"
+
+## Capabilities
+
+1. **Search Performance** - Clicks, impressions, CTR, position
+2. **Query Analysis** - Top queries, trending keywords
+3. **Page Performance** - Best/worst performing pages
+4. **Index Coverage** - Indexed pages, errors, warnings
+
+## Scripts
+
+```bash
+# Get search performance
+python ourdigital-custom-skills/16-seo-search-console/code/scripts/gsc_client.py \
+  --site https://example.com --days 28
+
+# Query analysis
+python ourdigital-custom-skills/16-seo-search-console/code/scripts/gsc_client.py \
+  --site https://example.com --report queries --limit 100
+
+# Page performance
+python ourdigital-custom-skills/16-seo-search-console/code/scripts/gsc_client.py \
+  --site https://example.com --report pages --output pages_report.json
+```
+
+## Environment
+- `GOOGLE_APPLICATION_CREDENTIALS` - Service account JSON path (required)
+
+## Output
+- CSV/JSON performance data
+- Trend analysis
+- Actionable insights
--- a/.claude/commands/seo-local.md
+++ b/.claude/commands/seo-local.md
@@ -0,0 +1,38 @@
+# SEO Local Audit
+
+Local SEO audit for NAP consistency, Google Business Profile, and citations.
+
+## Triggers
+- "local SEO audit", "check NAP", "GBP audit"
+
+## Capabilities (Guidance-based)
+
+1. **NAP Consistency** - Name, Address, Phone verification across web
+2. **GBP Optimization** - Google Business Profile completeness
+3. **Citation Audit** - Directory listings verification
+4. **Local Schema** - LocalBusiness markup validation
+
+## Audit Checklist
+
+### NAP Consistency
+- [ ] Business name matches exactly across all platforms
+- [ ] Address format is consistent (Suite vs Ste, etc.)
+- [ ] Phone number format matches (with/without country code)
+
+### Google Business Profile
+- [ ] All categories properly selected
+- [ ] Business hours accurate and complete
+- [ ] Photos uploaded (logo, cover, interior, exterior)
+- [ ] Q&A section monitored
+- [ ] Reviews responded to
+
+### Citations
+- [ ] Major directories (Yelp, Yellow Pages, etc.)
+- [ ] Industry-specific directories
+- [ ] Local chamber of commerce
+- [ ] Social media profiles
+
+## Tools to Use
+- Google Business Profile Manager
+- Moz Local / BrightLocal for citation audit
+- Schema.org validator for LocalBusiness markup
--- a/.claude/commands/seo-on-page.md
+++ b/.claude/commands/seo-on-page.md
@@ -0,0 +1,31 @@
+# SEO On-Page Audit
+
+On-page SEO analysis for meta tags, headings, content, and links.
+
+## Triggers
+- "analyze page SEO", "check meta tags", "on-page audit"
+
+## Capabilities
+
+1. **Meta Tag Analysis** - Title, description, OG tags, canonical
+2. **Heading Structure** - H1-H6 hierarchy validation
+3. **Content Analysis** - Word count, keyword density
+4. **Link Audit** - Internal/external links, broken links
+
+## Scripts
+
+```bash
+# Full page analysis
+python ourdigital-custom-skills/11-seo-on-page-audit/code/scripts/page_analyzer.py \
+  --url https://example.com/page
+
+# Multiple pages
+python ourdigital-custom-skills/11-seo-on-page-audit/code/scripts/page_analyzer.py \
+  --urls urls.txt --output report.json
+```
+
+## Output
+- Meta tag completeness score
+- Heading structure report
+- Content quality metrics
+- Link health status
--- a/.claude/commands/seo-schema-generator.md
+++ b/.claude/commands/seo-schema-generator.md
@@ -0,0 +1,42 @@
+# SEO Schema Generator
+
+Generate JSON-LD structured data markup from templates.
+
+## Triggers
+- "generate schema", "create structured data", "make JSON-LD"
+
+## Capabilities
+
+1. **Template-based Generation** - Use pre-built templates
+2. **Custom Schema** - Build schema from specifications
+3. **Multi-type Support** - Combine multiple schema types
+
+## Scripts
+
+```bash
+# Generate from template
+python ourdigital-custom-skills/14-seo-schema-generator/code/scripts/schema_generator.py \
+  --type LocalBusiness --output schema.json
+
+# With custom data
+python ourdigital-custom-skills/14-seo-schema-generator/code/scripts/schema_generator.py \
+  --type Article \
+  --data '{"headline": "My Article", "author": "John Doe"}' \
+  --output article-schema.json
+```
+
+## Available Templates
+
+| Type | Use Case |
+|------|----------|
+| `Article` | Blog posts, news articles |
+| `LocalBusiness` | Local business pages |
+| `Product` | E-commerce product pages |
+| `FAQPage` | FAQ sections |
+| `BreadcrumbList` | Navigation breadcrumbs |
+| `Organization` | Company/about pages |
+| `WebSite` | Homepage with sitelinks search |
+
+## Output
+- Valid JSON-LD ready for embedding
+- HTML script tag format option
--- a/.claude/commands/seo-schema-validator.md
+++ b/.claude/commands/seo-schema-validator.md
@@ -0,0 +1,36 @@
+# SEO Schema Validator
+
+JSON-LD structured data validation and analysis.
+
+## Triggers
+- "validate schema", "check structured data", "JSON-LD audit"
+
+## Capabilities
+
+1. **Schema Extraction** - Extract all JSON-LD from page
+2. **Syntax Validation** - Check JSON structure
+3. **Schema.org Compliance** - Validate against schema.org specs
+4. **Google Rich Results** - Check eligibility for rich snippets
+
+## Scripts
+
+```bash
+# Validate page schema
+python ourdigital-custom-skills/13-seo-schema-validator/code/scripts/schema_validator.py \
+  --url https://example.com
+
+# Validate local file
+python ourdigital-custom-skills/13-seo-schema-validator/code/scripts/schema_validator.py \
+  --file schema.json
+
+# Batch validation
+python ourdigital-custom-skills/13-seo-schema-validator/code/scripts/schema_validator.py \
+  --urls urls.txt --output validation_report.json
+```
+
+## Supported Schema Types
+- Article, BlogPosting, NewsArticle
+- Product, Offer, AggregateRating
+- LocalBusiness, Organization
+- FAQPage, HowTo, Recipe
+- BreadcrumbList, WebSite
--- a/.claude/commands/seo-technical.md
+++ b/.claude/commands/seo-technical.md
@@ -0,0 +1,33 @@
+# SEO Technical Audit
+
+Technical SEO audit for robots.txt and sitemap validation.
+
+## Triggers
+- "check robots.txt", "validate sitemap", "technical SEO"
+
+## Capabilities
+
+1. **Robots.txt Analysis** - Parse and validate robots.txt rules
+2. **Sitemap Validation** - Check XML sitemap structure and URLs
+3. **Sitemap Crawling** - Crawl all URLs in sitemap for issues
+
+## Scripts
+
+```bash
+# Check robots.txt
+python ourdigital-custom-skills/10-seo-technical-audit/code/scripts/robots_checker.py \
+  --url https://example.com
+
+# Validate sitemap
+python ourdigital-custom-skills/10-seo-technical-audit/code/scripts/sitemap_validator.py \
+  --url https://example.com/sitemap.xml
+
+# Crawl sitemap URLs
+python ourdigital-custom-skills/10-seo-technical-audit/code/scripts/sitemap_crawler.py \
+  --sitemap https://example.com/sitemap.xml --output report.json
+```
+
+## Output
+- Robots.txt rule analysis
+- Sitemap structure validation
+- URL accessibility report
--- a/.claude/commands/seo-vitals.md
+++ b/.claude/commands/seo-vitals.md
@@ -0,0 +1,40 @@
+# SEO Core Web Vitals
+
+Google PageSpeed Insights and Core Web Vitals analysis.
+
+## Triggers
+- "check page speed", "Core Web Vitals", "PageSpeed audit"
+
+## Capabilities
+
+1. **Performance Metrics** - LCP, FID, CLS scores
+2. **Mobile/Desktop** - Separate analysis for each
+3. **Optimization Tips** - Actionable recommendations
+4. **Historical Tracking** - Compare over time
+
+## Scripts
+
+```bash
+# Analyze single URL
+python ourdigital-custom-skills/15-seo-core-web-vitals/code/scripts/pagespeed_client.py \
+  --url https://example.com
+
+# Mobile and desktop
+python ourdigital-custom-skills/15-seo-core-web-vitals/code/scripts/pagespeed_client.py \
+  --url https://example.com --strategy both
+
+# Batch analysis
+python ourdigital-custom-skills/15-seo-core-web-vitals/code/scripts/pagespeed_client.py \
+  --urls urls.txt --output vitals_report.json
+```
+
+## Environment
+- `PAGESPEED_API_KEY` - Google API key (optional, higher quota)
+
+## Metrics Explained
+
+| Metric | Good | Needs Improvement | Poor |
+|--------|------|-------------------|------|
+| LCP | ≤2.5s | 2.5-4s | >4s |
+| FID | ≤100ms | 100-300ms | >300ms |
+| CLS | ≤0.1 | 0.1-0.25 | >0.25 |