adding Claude Skill

cyberandy · cyberandy · commit fe90c5b612ca · 2025-10-22T11:11:36.000+02:00
diff --git a/docs/agent-wordlift/integrations.md b/docs/agent-wordlift/integrations.md
@@ -217,3 +217,287 @@ The MCP integration enables a new category of workflows where Agent WordLift ope
 :::note
 The MCP integration is **currently experimental** and we're actively expanding its capabilities. If you have questions or feedback, please reach out to our support team.
 :::
+
+## Agent WordLift Claude Skill
+
+Take your SEO audits to the next level with the official **WordLift SEO Audit Skill** for Claude! This pre-built Agent Skill delivers comprehensive SEO analysis and competitive intelligence directly within your Claude conversations.
+
+<iframe width="100%" height="500" src="https://www.youtube.com/embed/DRIVYxFB60I?si=LgmmSzs8S9Td8q-1" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
+### What is a Claude Skill?
+
+Claude Skills are specialized packages that extend Claude's capabilities with domain-specific expertise. The WordLift SEO Audit Skill combines Claude's reasoning with WordLift's powerful SEO intelligence, creating an AI-powered SEO analyst that can audit any URL, analyze competitors, and provide actionable recommendations—all through natural conversation.
+
+### Key Features:
+
+- **Comprehensive SEO Audits**: Analyze any URL for schema markup, meta tags, content quality, technical SEO, mobile readiness, and performance
+- **Competitive Intelligence**: Automatically identify and analyze your top SERP competitors to uncover schema gaps and opportunities
+- **Structured Data Analysis**: Complete inventory of schema types with coverage comparison against competitors
+- **Actionable Recommendations**: Prioritized issues with specific implementation steps and ROI estimates
+- **WordLift Branded Reports**: Professional, color-coded reports with visual progress indicators and severity badges
+- **Progressive Disclosure**: Efficient token usage through smart resource loading
+
+### Perfect For:
+
+- **SEO Professionals** conducting client audits and competitive analysis
+- **Content Teams** optimizing pages for search visibility
+- **Agencies** delivering comprehensive SEO reports at scale
+- **Developers** integrating SEO insights into workflows
+- **E-commerce Teams** improving product page performance
+
+### How It Works
+
+The WordLift SEO Audit Skill leverages the **WordLift MCP Server** (described above) to access Agent WordLift's capabilities. This architecture ensures:
+
+1. **Claude (with Skill)** → Provides methodology and formatting instructions
+2. **WordLift MCP Server** → Makes API calls and processes data
+3. **Agent WordLift** → Delivers SEO intelligence and competitive analysis
+
+```
+┌─────────────────────────────────────┐
+│   Claude with WordLift Skill        │
+│   ├── Audit methodology             │
+│   ├── Report formatting             │
+│   └── WordLift branding             │
+└─────────────────┬───────────────────┘
+                  │
+                  │ Uses MCP Tools
+                  │
+┌─────────────────▼───────────────────┐
+│   WordLift MCP Server               │
+│   https://mcp.wordlift.io/sse       │
+│   ├── Agent WordLift API            │
+│   └── Knowledge Graph Access        │
+└─────────────────────────────────────┘
+```
+
+### Installation & Setup
+
+**Step 1: Configure WordLift MCP Server** (if not already done)
+
+Follow the MCP integration setup instructions above to connect WordLift to Claude.
+
+**Step 2: Download the WordLift SEO Audit Skill**
+
+[Download WordLift SEO Audit Skill v1.0.0](https://github.com/wordlift/claude-skills/releases) (Coming Soon)
+
+Or clone from GitHub:
+```bash
+git clone https://github.com/wordlift/claude-skills.git
+cd claude-skills/wordlift-seo-audit
+```
+
+**Step 3: Upload to Claude**
+
+1. In Claude, navigate to **Settings** → **Capabilities**
+2. Click **Upload Skill**
+3. Select the `wl-seo-audit-competitors.zip` file (or the skill folder)
+4. Enable the skill for your conversations
+
+**Step 4: Start Using**
+
+Simply ask Claude to audit any URL:
+```
+"Audit https://example.com/products/backpack and compare with top 5 competitors"
+```
+
+### Example Commands
+
+**Basic SEO Audit**:
+```
+"Run an SEO audit on https://mysite.com"
+```
+
+**Competitive Analysis**:
+```
+"Compare the schema markup on https://mysite.com/products/shoes with top 3 competitors in the US market"
+```
+
+**SERP Gap Analysis**:
+```
+"Analyze https://mystore.com/category/electronics for the query 'best wireless headphones' and show me what schema types competitors are using"
+```
+
+**Market-Specific Audit**:
+```
+"Audit https://mysite.fr for the French market (fr-FR) and compare with top 10 competitors"
+```
+
+### What You Get
+
+Every audit delivers a comprehensive report including:
+
+1. **Executive Summary** with overall SEO health score (0-100)
+2. **Quick Stats Dashboard** showing key metrics at a glance
+3. **Six-Dimensional Score Breakdown**:
+   - 🏷️ Schema Markup
+   - 📝 Meta Tags
+   - ✍️ Content Quality
+   - ⚙️ Technical SEO
+   - 📱 Mobile Readiness
+   - ⚡ Performance
+4. **Prioritized Issues** with severity indicators and action steps
+5. **Structured Data Inventory** showing all schema types (found/missing)
+6. **Competitive Analysis** comparing your coverage with SERP leaders
+7. **Growth Opportunities** ranked by impact vs. effort with ROI estimates
+
+### Report Features
+
+- **Color-Coded Scores**: Visual progress bars (green/yellow/red based on performance)
+- **Severity Indicators**: 🔴 Critical, ⚠️ Warning, ℹ️ Info, ✅ Success
+- **Impact Badges**: HIGH/MEDIUM/LOW impact and effort ratings
+- **Professional Branding**: Official WordLift design system with brand colors
+- **Actionable Steps**: Specific implementation instructions for each recommendation
+- **Business Context**: CTR improvements, ranking potential, and competitive advantages
+
+### Technical Details
+
+**Skill Version**: 1.0.0
+
+**Dependencies**:
+- WordLift MCP Server (`https://mcp.wordlift.io/sse`)
+- MCP Tools: `WordLift:agent`, `WordLift:graphql`
+
+**Architecture**: 
+- Built using Anthropic's Agent Skills best practices
+- Progressive disclosure pattern for efficient token usage
+- Versioned and maintainable codebase
+- Complete brand guidelines and documentation
+
+**Supported Markets**:
+- Any locale (default: `en-US`)
+- Examples: `en-GB`, `fr-FR`, `de-DE`, `it-IT`, `es-ES`, `pt-BR`, etc.
+
+**Competitor Analysis**:
+- Top 1-20 SERP competitors (configurable)
+- Automatic query inference from target URL
+- Schema coverage comparison matrices
+- Gap analysis and opportunity identification
+
+### Example Output
+
+```markdown
+# 🎯 SEO Audit Report: example.com
+
+*Powered by WordLift Enterprise SEO Platform*
+
+## Overall SEO Score: 78/100
+### 👍 Good Progress - Room for Improvement
+
+---
+
+### 📊 Quick Stats Dashboard
+
+| 📦 Schema Types | 🔴 Critical Issues | 💡 Opportunities | ✅ Passing |
+|----------------|-------------------|------------------|-----------|
+| 4 types        | 2 found           | 5 identified     | 8 tests   |
+
+**Assessment**: Your site has solid technical SEO fundamentals with 85/100 
+technical score. However, missing Review and Rating schema is a critical 
+gap - competitors have 30% higher click-through rates with this markup.
+
+---
+
+## 📈 Score Breakdown
+
+- 🏷️ **Schema Markup**: 65/100 `[██████░░░░] 65%`
+- 📝 **Meta Tags**: 80/100 `[████████░░] 80%`
+- ✍️ **Content Quality**: 82/100 `[████████░░] 82%`
+- ⚙️ **Technical SEO**: 85/100 `[████████░░] 85%`
+- 📱 **Mobile Ready**: 90/100 `[█████████░] 90%`
+- ⚡ **Performance**: 72/100 `[███████░░░] 72%`
+
+---
+
+## 🎯 Critical Issues & Recommendations
+
+### 🔴 [PRIORITY 1] Missing Review & Rating Schema
+**Impact**: HIGH | **Category**: Schema
+
+Your product page lacks Review and AggregateRating structured data. 
+Products with review markup can achieve 15-35% higher click-through rates.
+
+💡 **Action Required**:
+- Implement schema.org/Review with properties: reviewRating, author, reviewBody
+- Add schema.org/AggregateRating with ratingValue, reviewCount
+- Test implementation using Google Rich Results Test
+...
+```
+
+### Advanced Usage
+
+**Custom Query Hints**:
+```
+"Audit https://mysite.com with query hints: 'sustainable fashion', 
+'eco-friendly clothing', 'organic textiles'"
+```
+
+**Mobile vs Desktop Analysis**:
+```
+"Compare mobile and desktop SEO for https://mysite.com"
+```
+
+**Batch Audits** (with API integration):
+```
+For multiple URLs, use the WordLift CLI in combination with Claude:
+1. Export URLs from your sitemap
+2. Use CLI to batch process through Agent WordLift
+3. Load results into Claude for summary analysis
+```
+
+### Why Use the Claude Skill vs. Direct MCP?
+
+| Feature | Claude Skill | Direct MCP Integration |
+|---------|-------------|----------------------|
+| **Pre-built Workflow** | ✅ Complete methodology | ❌ You build from scratch |
+| **Report Formatting** | ✅ Professional branded reports | ❌ Manual formatting needed |
+| **Best Practices** | ✅ Built-in SEO expertise | ⚠️ Requires your knowledge |
+| **Progressive Disclosure** | ✅ Optimized token usage | ⚠️ Manual management |
+| **Updates** | ✅ Version-tracked improvements | ❌ Manual updates |
+| **Branding** | ✅ WordLift design system | ❌ Custom styling needed |
+
+**Use the Skill when**: You want turnkey SEO audits with professional reports
+
+**Use Direct MCP when**: You're building custom workflows or integrating into your own tools
+
+### Open Source & Customization
+
+The WordLift SEO Audit Skill is open source! You can:
+
+- **Fork and Customize**: Adapt the skill to your specific needs
+- **White Label**: Modify branding for agency use (with proper licensing)
+- **Extend Functionality**: Add custom analysis modules
+- **Contribute**: Submit improvements back to the community
+
+**GitHub Repository**: https://github.com/wordlift/claude-skills (Coming Soon)
+
+### Support & Resources
+
+- **Documentation**: Complete skill documentation included in download
+- **Setup Guide**: Step-by-step installation and configuration
+- **Brand Guidelines**: WordLift design system and color palette
+- **Changelog**: Version history and release notes
+- **Community**: Join discussions in WordLift Community
+
+### Troubleshooting
+
+**Issue**: "Tool WordLift:agent not found"
+- **Solution**: Ensure WordLift MCP server is configured (see MCP integration section above)
+
+**Issue**: Skill doesn't trigger automatically
+- **Solution**: Check skill description matches your query intent. Try explicit phrases like "audit this URL"
+
+**Issue**: Reports missing branding
+- **Solution**: Ensure you're using skill version 1.0.0 or later with resources/BRANDING.md included
+
+**Need Help?** Contact WordLift support at support@wordlift.io
+
+---
+
+🚀 **Ready to transform your SEO workflow?** 
+
+[Download WordLift SEO Audit Skill](https://github.com/wordlift/claude-skills) and start delivering professional SEO audits in minutes!
+
+:::tip
+The Claude Skill integrates seamlessly with all other WordLift integrations (Chrome Extension, CLI, API, Zapier) for a complete SEO automation ecosystem. For custom workflows, explore the [MCP Integration](#agent-wordlift-model-context-protocol-mcp-integration) section above.
+:::
