claude-seo-workflows
About claude-seo-workflows
A Claude skill for SEO work on websites, blogs, landing pages, and developer content. It combines search-intent and keyword research with content structure, metadata, technical SEO, and internal linking, emphasizing readable material over keyword stuffing.
Key features
- 01Search-intent analysis
- 02Keyword research
- 03Content structure optimization
- 04Metadata recommendations
- 05Technical SEO checks
- 06Internal linking strategy
Use cases
- 01Plan SEO-focused blog content
- 02Optimize a landing page
- 03Review technical SEO and metadata
- 04Build connected topic content
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ composio-community/ opencode-skills --skill claude-seo-workflowsAfter installing, type/claude-seo-workflowsin Claude Code to confirm it loaded.
Details
From the project READMEClaude SEO Workflows
Overview
This skill enables Claude to assist with comprehensive SEO workflows for websites, blogs, landing pages, and developer-focused content.
The workflow focuses on:
- keyword research
- search intent analysis
- technical SEO
- content structure optimization
- metadata generation
- internal linking strategy
- search-focused writing
- scalable content workflows
The goal is to create content and site structures that:
- rank effectively
- match user intent
- remain readable and useful
- avoid low-quality AI-generated SEO patterns
This workflow prioritizes high-quality, human-readable content over keyword stuffing or outdated SEO tactics.
Setup
Before starting:
-
Define the target website or content category.
-
Identify:
- audience
- search intent
- competitors
- content goals
- Gather:
- existing content
- analytics data (optional)
- target keywords
- product/service information
Recommended tools:
- Google Search Console
- Ahrefs
- SEMrush
- Screaming Frog
- Google Trends
- Markdown editors
- CMS platforms
Optional:
- Existing SEO reports
- Competitor analysis
- Analytics dashboards
Inputs Required
- Topic or keyword targets
- Audience profile
- Existing content or URLs
- Website structure
- Product or service information
Optional:
- Competitor pages
- Search Console data
- Technical SEO audit data
When to Use This Skill
Use this skill when:
- planning SEO content
- optimizing landing pages
- improving technical SEO
- generating blog content
- researching keywords
- improving search visibility
- structuring content for ranking
- building scalable SEO workflows
When NOT to Use
Do NOT use this skill for:
- keyword stuffing
- spam-style SEO automation
- low-quality bulk content generation
- misleading ranking manipulation
- black-hat SEO tactics
Example Use Case
Optimize a developer tools landing page for AI workflow automation keywords.
Claude should:
- Research search intent
- Identify high-value keywords
- Structure content around user problems
- Improve metadata and headings
- Optimize readability
- Add internal linking opportunities
- Improve technical SEO structure
Final result should:
- target real search intent
- remain human-readable
- improve discoverability
- support long-term SEO growth
- avoid generic AI-generated writing
Core SEO Principles
1. Prioritize Search Intent
Good SEO begins with understanding:
- why users search
- what users expect
- what problems users want solved
Claude should optimize for:
- usefulness
- relevance
- clarity
- intent satisfaction
Avoid:
- keyword stuffing
- shallow content
- generic filler text
Content that satisfies intent performs better long-term.
2. Write for Humans First
SEO content should remain:
- readable
- useful
- well-structured
- engaging
Claude should avoid:
- robotic phrasing
- repetitive keyword insertion
- unnatural headings
- over-optimized copy
Good SEO content should feel:
- natural
- authoritative
- trustworthy
- helpful
3. Build Strong Content Structure
Good content structure improves:
- readability
- crawlability
- ranking potential
- user engagement
Recommended structure:
- clear headings
- logical sections
- concise paragraphs
- strong introductions
- scannable formatting
Claude should:
- organize information clearly
- maintain logical flow
- improve readability continuously
4. Optimize Metadata Properly
Metadata strongly affects:
- click-through rates
- search visibility
- page relevance
Optimize:
- title tags
- meta descriptions
- heading hierarchy
- image alt text
- structured data opportunities
Avoid:
- duplicate metadata
- vague titles
- keyword stuffing
5. Improve Technical SEO
Technical SEO improves:
- crawlability
- indexing
- performance
- user experience
Claude should help identify:
- slow-loading pages
- broken links
- poor heading structure
- duplicate content
- missing metadata
- weak internal linking
Technical quality affects long-term ranking stability.
6. Build Topical Authority
Strong SEO systems focus on:
- topic depth
- content relationships
- internal linking
- consistent expertise
Claude should help create:
- content clusters
- supporting articles
- semantic keyword coverage
- connected content ecosystems
Authority compounds over time.
Workflow
1. Analyze Search Intent
Start by identifying:
- target audience
- search motivation
- competitor positioning
- expected content depth
Determine whether intent is:
- informational
- transactional
- navigational
- commercial investigation
Content structure should adapt to intent.
2. Research Keywords
Identify:
- primary keywords
- secondary keywords
- semantic variations
- long-tail opportunities
Prioritize:
- relevance
- realistic ranking opportunities
- intent alignment
Avoid:
- chasing irrelevant high-volume keywords
- over-optimizing low-quality traffic
3. Structure the Content
Create:
- heading hierarchy
- section flow
- internal linking opportunities
- supporting subsections
Good structure improves:
- readability
- ranking potential
- engagement
- crawlability
4. Optimize Content Quality
Claude should:
- improve clarity
- remove fluff
- strengthen explanations
- add useful examples
- improve readability
Focus on:
- expertise
- usefulness
- specificity
- depth
Avoid:
- repetitive phrasing
- generic filler
- unnecessary keyword repetition
5. Improve Technical SEO
Validate:
- metadata quality
- heading structure
- URL structure
- internal linking
- image optimization
- mobile readability
Ensure:
- pages remain crawlable
- structure stays logical
- content loads efficiently
6. Build Internal Linking Strategy
Identify:
- related pages
- supporting content
- topical relationships
Good internal linking improves:
- crawl efficiency
- authority flow
- content discoverability
Avoid:
- isolated pages
- excessive linking
- irrelevant anchor text
7. Final Validation
Before publishing validate:
- readability
- keyword alignment
- metadata quality
- search intent satisfaction
- technical SEO structure
Ensure:
- the content feels human-written
- structure remains clean
- SEO supports usability rather than hurting it
Output Expectations
The final output should include:
- optimized SEO structure
- search-focused content
- metadata recommendations
- keyword strategy
- internal linking opportunities
- technically sound page structure
The workflow itself should remain:
- scalable
- maintainable
- human-readable
- search-intent focused
- production-ready
Execution Strategy (for AI agents)
The agent should:
- Prioritize search intent over keyword density
- Keep content human-readable
- Improve technical SEO continuously
- Structure content clearly
- Build topical authority strategically
- Optimize for long-term search performance
The workflow should optimize for:
- discoverability
- usability
- ranking stability
- readability
- topical authority
Best Practices
- Write for humans first
- Use clear heading structures
- Avoid keyword stuffing
- Improve readability aggressively
- Build internal linking intentionally
- Optimize metadata carefully
- Focus on topical authority over isolated pages
Notes
- Search intent matters more than raw keyword density
- Readable content consistently outperforms robotic SEO writing
- Technical SEO compounds over time
- Strong internal linking improves authority distribution
- SEO works best when usability and discoverability align