seo-content

SEO Content Skill

Create search-optimized content that ranks and converts, informed by keyword data and competitor analysis.

Purpose

Develop content that attracts organic traffic while providing genuine value to readers and supporting business goals.

---

Required Integrations

Setup: Connect these data sources to enable full functionality. Claude will prompt you to connect any missing integrations when you use this skill.

Data Sources

# SEO CONTENT DATA SOURCES
# Configure the sources relevant to your SEO content needs

# Keyword & SEO Data
- source: seo_tools
  connector: "{{AHREFS | SEMRUSH | MOZ | GOOGLE_SEARCH_CONSOLE}}"
  data:
    - keyword_research
    - search_volume
    - keyword_difficulty
    - serp_analysis
    - competitor_rankings
    - backlink_data
    - content_gaps
    - ranking_positions

# Google Search Console
- source: google_search_console
  connector: "{{GOOGLE_SEARCH_CONSOLE}}"
  data:
    - current_rankings
    - impressions
    - clicks
    - ctr
    - position_changes

# Website Analytics
- source: analytics
  connector: "{{GOOGLE_ANALYTICS | MIXPANEL | AMPLITUDE}}"
  data:
    - organic_traffic
    - page_performance
    - conversion_by_page
    - bounce_rates
    - time_on_page

# Existing Content
- source: content_library
  connector: "{{GOOGLE_DRIVE | SHAREPOINT | NOTION | CMS}}"
  paths:
    - "/Marketing/Blog Posts/"
    - "/Marketing/Pillar Content/"
- source: website
  url: "{{YOUR_WEBSITE_URL}}"
  data:
    - existing_pages
    - internal_linking

# Brand & Product
- source: brand_docs
  connector: "{{GOOGLE_DRIVE | SHAREPOINT | NOTION}}"
  paths:
    - "/Marketing/Brand Guidelines/"
    - "/Marketing/Messaging/"
- source: product_docs
  connector: "{{GOOGLE_DRIVE | SHAREPOINT | NOTION | CONFLUENCE}}"
  paths:
    - "/Product/Features/"
    - "/Product/Use Cases/"

# Customer Research
- source: customer_research
  connector: "{{GOOGLE_DRIVE | SHAREPOINT | NOTION}}"
  paths:
    - "/Research/Customer Questions/"
    - "/Research/Support FAQs/"
    - "/Research/Sales FAQs/"

# Competitor Content
- source: competitor_analysis
  connector: "{{AHREFS | SEMRUSH}}"
  data:
    - competitor_top_pages
    - content_gaps
    - keyword_opportunities

Output Destinations

# Where to deliver SEO content outputs
outputs:
  # Always available - display in Claude UI
  - type: display
    enabled: true

  # Push to CMS
  - type: cms
    connector: "{{WORDPRESS | WEBFLOW | CONTENTFUL | HUBSPOT_CMS}}"
    actions:
      - create_draft
      - update_meta_tags

  # Save to content library
  - type: documents
    connector: "{{GOOGLE_DRIVE | SHAREPOINT | NOTION}}"
    destination: "/Marketing/SEO Content/"

  # Notify for review
  - type: slack
    connector: "{{SLACK}}"
    channel: "#content-review"

---

Instructions for Claude

IMPORTANT: Before executing this skill, you MUST validate the configuration above.

Pre-Execution Checklist

1. Check for placeholder values: Scan the YAML configuration for any {{...}} placeholders. These indicate required configuration that the user must provide.

2. Validate data sources: For each data source listed:

   • If a connector field shows {{OPTIONS}} format, ask the user which option they use
   • If URLs, paths, or names contain {{PLACEHOLDER}}, ask the user to provide actual values
   • Verify any required MCP servers are connected and available

3. Validate output destinations: For any output type beyond display:

   • Confirm the connector is available as an MCP server
   • Ensure destination paths/channels are configured (not placeholders)

If Configuration is Incomplete

Do not proceed with the skill. Instead:

1. List the specific missing or placeholder values found
2. Explain what each value is needed for
3. Ask the user to provide the missing configuration
4. Offer to help them set up the required MCP integrations

Example response when config is incomplete:

Before I can run this skill, I need some configuration:

**Missing values:**
- [List specific {{PLACEHOLDER}} values found]

**MCP connections needed:**
- [List required connectors not yet available]

Please provide these values, or let me know which data sources you'd like to skip.

Minimum Requirements

At minimum, this skill requires:

• Target keyword or topic
• Content goal (blog, landing page, pillar page, etc.)
• display output enabled (always available)
• Web search provides SERP analysis without additional setup

Enhanced functionality requires:

• SEO platform for keyword data and rankings
• Analytics for existing content performance
• Brand voice guidelines for tone
• Competitor content for gap analysis

---

Scheduling & Automation with Taizen

Automate this skill: Schedule recurring SEO content tasks with Taizen. Create a free account to set up automated agents that run on your schedule.

How It Works

The Taizen MCP server accepts natural language requests to schedule agents. Simply describe what you want to automate:

Every Monday morning, generate a weekly SEO performance report including
ranking changes, traffic trends, and content opportunities. Post to
#seo-content on Slack.

Taizen will:

1. Read this skill's definition to understand the capabilities
2. Create a recurring agent with your specified schedule
3. Execute the task and deliver results to your configured destinations

Example Natural Language Requests

Weekly Ranking Report:

Every Monday at 9am, generate a weekly SEO performance report including
ranking changes, traffic trends, and content opportunities. Post findings
to #seo-content and save to our SEO folder.

Monthly Content Gap Analysis:

On the 1st of each month, identify content gaps by analyzing competitor
rankings and keyword opportunities we're missing. Share with #content-strategy.

Content Refresh Alerts:

Every morning, check for articles older than 12 months with declining traffic
that need a content refresh. Alert me on Slack if any articles have dropped
more than 30% in traffic or fallen 5+ positions.

Quarterly Content Audit:

At the start of each quarter, run a comprehensive content audit including
performance analysis, consolidation opportunities, and strategic recommendations.
Save to our Content Audits folder.

Setting Up Taizen Automation

1. Create Account: Sign up at usetaizen.com
2. Connect MCP: Add the Taizen MCP integration in your Claude settings and authenticate
3. Connect SEO Tools: Link your Ahrefs, SEMrush, or Search Console
4. Schedule Agent: Describe your automation in natural language
5. Taizen Reads Skill: The agent receives this skill's full definition to understand what it can do

Technical Details

When scheduling via Taizen MCP, Claude will:

1. Read this SKILL.md file to get the full skill definition
2. Call Taizen MCP with the skill content included

Parameter	Description	Example
task	Natural language description of what to do	"Generate weekly SEO ranking report"
schedule	When to run (cron or trigger)	"every Monday at 9am" or "when keyword approved"
skill_content	Object containing primary skill and referenced skills	See structure below
outputs	Where to send results	"Slack #seo-content, Notion"
keywords	Keywords to focus on	"target keywords for Q2"

skill_content structure:

skill_content:
  primary:
    name: "seo-content"
    content: "<full content of this SKILL.md>"
  referenced:
    - name: "product-context"
      content: "<full content of product-context SKILL.md>"
    - name: "brand-voice"
      content: "<full content of brand-voice SKILL.md>"

Note to Claude: When a user asks to schedule this skill with Taizen, read this entire SKILL.md file and pass it as skill_content.primary. Also read any referenced background skills (like product-context and brand-voice) and include them in skill_content.referenced.

---

SEO Content Framework

1. Keyword Research Foundation

Keyword Categories:

Type	Intent	Examples
Informational	Learn/Understand	"what is [topic]", "how to [task]"
Commercial	Evaluate	"best [product]", "[A] vs [B]"
Transactional	Buy/Act	"[product] pricing", "buy [product]"
Navigational	Find	"[brand name]", "[product] login"

Keyword Selection Criteria:

• Search volume (sufficient audience)
• Keyword difficulty (achievable ranking)
• Business relevance (supports goals)
• Intent alignment (matches what you offer)

2. Content Structure

SEO-Friendly Format:

H1: Primary keyword + compelling angle
  - Introduction (hook, problem, promise)
  - Table of contents (for long content)

H2: Major subtopic 1
  - H3: Supporting point
  - H3: Supporting point

H2: Major subtopic 2
  - H3: Supporting point
  - H3: Supporting point

H2: FAQ section (targets related queries)
  - H3: Question 1 (exact match)
  - H3: Question 2 (exact match)

Conclusion + CTA

3. On-Page SEO Checklist

Title Tag:

• Primary keyword near the front
• Under 60 characters
• Compelling to click

Meta Description:

• Includes primary keyword
• 150-160 characters
• Clear value proposition
• Call to action

Content:

• Keyword in first 100 words
• Keywords in H2s naturally
• Related keywords throughout
• Proper heading hierarchy
• Internal links (3-5 minimum)
• External links to authoritative sources
• Optimized images with alt text

4. Content Quality Signals

E-E-A-T (Experience, Expertise, Authoritativeness, Trust):

• Author credentials visible
• Original research or data
• Expert quotes/sources
• Accurate, up-to-date information
• Clear, professional presentation

---

Content Types

Blog Post / Article

Long-form educational content (1,500-3,000+ words)

Pillar Page

Comprehensive topic overview linking to cluster content

How-To Guide

Step-by-step instructional content

Listicle

Numbered list of tips, tools, examples

Comparison Post

[A] vs [B] or "Best [Category]" roundups

Glossary / Definition

"What is [term]" educational content

---

How to Use This Skill

Invoke with natural language describing what SEO content you need:

Content Briefs

• "Create an SEO content brief for 'how to improve sales productivity'"
• "Build a brief for a pillar page on customer success"
• "Research and outline an article targeting 'best CRM for small business'"

Full Articles

• "Write an SEO-optimized blog post on email marketing best practices"
• "Create a comparison article: HubSpot vs Salesforce"
• "Write a how-to guide for setting up marketing automation"

Optimization

• "Optimize this existing article for SEO: [paste or link]"
• "Improve the meta tags for our pricing page"
• "Add FAQ schema markup suggestions for this content"

Content Strategy

• "What content gaps exist between us and [competitor]?"
• "Identify keyword opportunities for our product category"
• "Plan a content cluster around [topic]"

---

Output Format

Content Brief

# SEO Content Brief: [Primary Keyword]

**Created**: [Date]
**Data Sources Used**: [Ahrefs, Search Console, etc.]

---

## Target Keywords

| Keyword | Volume | Difficulty | Intent | Priority |
|---------|--------|------------|--------|----------|
| [Primary] | [Vol] | [KD] | [Intent] | Primary |
| [Secondary 1] | [Vol] | [KD] | [Intent] | Secondary |
| [Secondary 2] | [Vol] | [KD] | [Intent] | Secondary |

### Related Keywords to Include
*For semantic coverage:*
- [Keyword 1]
- [Keyword 2]
- [Keyword 3]
- [Keyword 4]

### Questions from "People Also Ask"
1. [Question 1]
2. [Question 2]
3. [Question 3]

---

## Search Intent Analysis

**What searchers want**:
- Primary need: [What they're trying to accomplish]
- Secondary needs: [Related information they need]
- Questions they have: [Specific questions]

**Content type that ranks** (from SERP analysis):
- Position 1: [Type] - [URL] - [Word count]
- Position 2: [Type] - [URL] - [Word count]
- Position 3: [Type] - [URL] - [Word count]

---

## Competitive Analysis

### Top Ranking Content

| Position | Title | Domain | Word Count | Key Angles |
|----------|-------|--------|------------|------------|
| 1 | [Title] | [Domain] | [Count] | [What they cover] |
| 2 | [Title] | [Domain] | [Count] | [What they cover] |
| 3 | [Title] | [Domain] | [Count] | [What they cover] |

### Content Gaps (Our Opportunity)
Based on competitor analysis:
- [What competitors miss that we can cover]
- [Unique angle we can take]
- [Data/examples we have that they don't]

---

## Recommended Structure

**Title**: [SEO-optimized title]
**Meta Description**: [150-160 chars with keyword and CTA]
**Target Word Count**: [Range based on competition]
**Estimated Reading Time**: [Minutes]

### Outline

**H1**: [Title/Primary keyword]

**Introduction** (150-200 words)
- Hook: [Angle to grab attention]
- Problem: [What reader faces]
- Promise: [What they'll learn]
- Credibility: [Why trust this content]

**H2**: [Section 1 - addresses primary search intent]
- H3: [Subtopic]
- H3: [Subtopic]
- *Include: [Specific points to cover]*

**H2**: [Section 2 - goes deeper]
- H3: [Subtopic]
- H3: [Subtopic]
- *Include: [Specific points to cover]*

**H2**: [Section 3 - practical/actionable]
- H3: [Subtopic]
- H3: [Subtopic]

**H2**: FAQ (for PAA targeting)
- H3: [Question 1 - exact match from PAA]
- H3: [Question 2 - exact match from PAA]
- H3: [Question 3 - exact match from PAA]

**Conclusion**
- Summary of key points
- CTA: [Desired action]

---

## Internal Linking Strategy

**Link TO these existing pages**:
- [Page 1]: [Anchor text suggestion]
- [Page 2]: [Anchor text suggestion]

**Update these pages to link TO this new content**:
- [Existing page 1]
- [Existing page 2]

---

## CTA Strategy
- **Primary CTA**: [Action] - [Where in content]
- **Secondary CTA**: [Action] - [Where in content]

## Visual Assets Needed
- [ ] Featured image
- [ ] [Diagram/infographic suggestion]
- [ ] [Screenshot needs]

## Schema Markup
Recommended: [Article/HowTo/FAQ schema]

Full SEO Article

# [SEO-Optimized Title with Primary Keyword]

**Meta Description**: [150-160 character description with keyword and CTA]
**Primary Keyword**: [Keyword]
**Word Count**: [Count]

---

[Introduction: 150-200 words]
- Hook that relates to reader's situation
- Establish the problem or opportunity
- Preview what they'll learn
- Brief credibility builder (why trust this)

**In this guide, you'll learn:**
- [Key point 1]
- [Key point 2]
- [Key point 3]

---

## [H2: Major Section 1 - Primary Keyword Related]

[Content that directly addresses search intent - include primary keyword naturally]

### [H3: Subtopic]

[Detailed content with examples, data, and actionable advice]

### [H3: Subtopic]

[Detailed content]

> **Key Takeaway**: [Boxed callout with important point]

[Internal link: Related content on your site]

---

## [H2: Major Section 2 - Secondary Keyword Related]

[Content that expands on the topic]

### [H3: Subtopic]

[Detailed content]

**[Data/Stat callout]**: [Interesting statistic with source - external link]

---

## [H2: Practical/Actionable Section]

[How to apply this information]

**Step 1: [Action]**
[Explanation]

**Step 2: [Action]**
[Explanation]

**Step 3: [Action]**
[Explanation]

---

## Frequently Asked Questions

### [Question from PAA - exact match]

[Direct answer to the question, 50-150 words, optimized for featured snippet]

### [Question from PAA - exact match]

[Direct answer]

### [Question from PAA - exact match]

[Direct answer]

---

## Conclusion

[Recap of key points - 2-3 sentences]

[Reinforcement of main value]

[Clear CTA: What should reader do next?]

---

**Related Resources:**
- [Internal link 1]
- [Internal link 2]
- [Internal link 3]

---

Automation Options

When configured with integrations, this skill can:

1. Keyword research - Pull real search volume and difficulty data from Ahrefs/SEMrush
2. SERP analysis - Analyze what's currently ranking to inform your approach
3. Content gap identification - Find keywords competitors rank for that you don't
4. Performance tracking - Monitor how your content ranks over time
5. Internal linking - Suggest linking opportunities across your site
6. CMS publishing - Push drafts directly to WordPress/Webflow/HubSpot