SEO Content Skill
Teaches a two-layer framework for writing content that ranks in search engines and engages readers, with templates and checklists.
What this file does
Teaches a two-layer framework for writing content that ranks in search engines and engages readers, with templates and checklists.
When to use it
- Writing blog posts or guides that need organic traffic
- Creating a content brief for an SEO-optimized article
- Training a team on SEO content best practices
- Reviewing existing content for E-E-A-T and ranking gaps
name: seo-content description: Create articles that rank in search engines and engage readers. Use when building organic traffic, establishing authority, or creating content that attracts your ideal customers through search.
SEO Content Skill
Overview
SEO Content is content optimized for search engines that also engages and converts readers. This skill teaches you to write content that ranks and resonates, following modern E-E-A-T principles and topical authority strategies.
Keywords: SEO content, search engine optimization, content marketing, ranking content, organic traffic, search intent, content strategy, E-E-A-T, topical authority
Related: See ./seo-strategy for the complete strategic framework and keyword research methodology.
The Modern SEO Content Framework
Two Layers of Optimization
- For Search Engines — Technical optimization for ranking
- For People — Engaging, valuable content that converts
The best SEO content serves both equally.
The E-E-A-T Imperative
Google now evaluates all content against E-E-A-T:
| Factor | How to Demonstrate |
|---|---|
| Experience | First-hand examples, real case studies, personal insights |
| Expertise | Deep knowledge, accurate information, comprehensive coverage |
| Authoritativeness | Credentials, citations, external recognition |
| Trustworthiness | Accuracy, sources, transparency, no misleading claims |
Action: Every article should include at least one personal example, cite 2-3 authoritative sources, and demonstrate depth beyond surface-level coverage.
Layer 1: Search Engine Optimization
Keyword Optimization
Primary Keyword: Your main target keyword
Placement Strategy:
| Location | Requirement |
|---|---|
| Title tag | First 60 characters |
| H1 heading | Include naturally |
| First 100 words | Early placement |
| Body content | 2-3 times naturally |
| Subheadings | Where relevant |
| URL slug | Short, keyword-included |
Secondary Keywords: Related terms that support the primary keyword
- Use naturally throughout content
- Include in H2/H3 headings where relevant
- Support topical completeness
Title Tag Formula
Requirements: 50-60 characters, keyword early, compelling
Formulas:
[Keyword]: [Number] [Benefit/Strategies/Ways] for [Outcome]
How to [Keyword] in [Year]: [Specific Benefit]
[Keyword]: The Complete Guide to [Outcome]
[Number] [Keyword] Tips That [Specific Result]
Examples:
- "Remote Team Management: 7 Strategies That Actually Work"
- "How to Improve Core Web Vitals in 2025: Complete Guide"
Meta Description
Requirements: 150-160 characters, keyword included, compelling CTA
Formula: "[Benefit statement]. Learn [specific outcome] with [unique angle]. [Soft CTA]."
Example: "Master remote team management with 7 proven strategies. Learn how top companies boost productivity by 40%. Complete guide inside."
Heading Structure
Use proper hierarchy to signal content structure:
H1: [Main Topic with Primary Keyword]
H2: [Major Section 1]
H3: [Subsection]
H3: [Subsection]
H2: [Major Section 2]
H3: [Subsection]
H2: FAQ (for featured snippets)
Rules:
- One H1 per page
- H2s for main sections (5-8 for comprehensive articles)
- H3s for subsections within H2s
- Include keywords naturally in headings
Content Length Guidelines
| Keyword Competition | Target Length |
|---|---|
| Low competition | 1,500-2,000 words |
| Medium competition | 2,000-3,000 words |
| High competition | 3,000-5,000+ words |
Key insight: Longer content ranks better IF it's comprehensive and valuable. Padding for length hurts rankings.
Layer 2: Human Optimization
Content Structure Template
1. Opening Hook (First 2-3 sentences)
- Answer search intent immediately
- Create curiosity or promise value
- Make them want to continue
Example:
"Most remote teams fail because of one fixable problem: unclear communication protocols. In this guide, you'll learn the exact 7 strategies that helped 500+ companies boost remote productivity by 40%."
2. Table of Contents
- For articles 1,500+ words
- Improves navigation
- Helps search engines understand structure
- Enables jump links in search results
3. Main Content Sections Each section should:
- Address one specific subtopic
- Include practical examples
- Provide actionable takeaways
- Use formatting for scannability
4. FAQ Section
- Target featured snippets
- Answer related questions
- Use exact question format
- Keep answers concise (40-60 words)
5. Conclusion
- Summarize key takeaways (3-5 bullets)
- Include clear call-to-action
- Link to related content
- Reinforce main value proposition
Search Intent Alignment
Critical: Match your content format to searcher intent.
| Intent Type | What They Want | Content Format |
|---|---|---|
| Informational | "How to manage remote teams" | Comprehensive tutorial/guide |
| Commercial | "Best remote team tools" | Comparison, reviews, rankings |
| Transactional | "Asana pricing" | Pricing page, product page |
| Navigational | "Slack login" | Direct page, comparison to alternatives |
Wrong format = no ranking, regardless of content quality.
Readability Standards
- Paragraphs: 2-3 sentences max
- Sentences: Under 20 words preferred
- Subheadings: Every 200-300 words
- Bullet points: For lists of 3+ items
- Bold text: Key phrases and takeaways
- White space: Generous margins and padding
Engagement Elements
Include these to increase dwell time and reduce bounce:
| Element | Purpose | Frequency |
|---|---|---|
| Real examples | Demonstrate expertise | Every major section |
| Data/statistics | Build credibility | 3-5 per article |
| Images/visuals | Break up text, illustrate points | Every 300-500 words |
| Actionable tips | Provide immediate value | Throughout |
| Case studies | Show proof of concepts | 1-2 per article |
| Pull quotes | Highlight key insights | 2-3 per article |
The Complete SEO Content Process
Step 1: Keyword Research & Validation
Before writing, confirm:
- Search volume: 100-10,000/month for long-tails
- Search intent: What format does Google reward?
- Competition: Can you realistically rank?
- SERP analysis: What's missing from current results?
Step 2: Competitor Analysis
Analyze top 5 ranking pages:
- Content length and depth
- Headings and structure
- Topics covered (and gaps)
- Media and visuals used
- E-E-A-T signals present
Find the gap: What can you cover that they don't?
Step 3: Create Content Brief
Brief Template:
Primary Keyword: [keyword]
Secondary Keywords: [list]
Search Intent: [informational/commercial/etc.]
Target Length: [word count]
Target Audience: [who]
Content Angle: [unique perspective]
Key Sections: [H2 outline]
Competitor Gaps: [what to add]
E-E-A-T Elements: [how to demonstrate]
Internal Links: [pages to link]
CTA: [desired action]
Step 4: Write with AI Assistance
The 80/20 Approach:
- AI handles: Outlines, first drafts, research summaries, metadata
- You handle: Unique insights, examples, fact-checking, voice refinement
Process:
- Generate outline from brief
- Expand each section
- Add your unique examples and insights
- Refine voice and tone
- Fact-check all claims
Step 5: On-Page SEO Checklist
- Title tag: 50-60 chars, keyword, compelling
- Meta description: 150-160 chars, keyword, CTA
- H1: Includes primary keyword
- H2s: 5-8 main sections with keywords
- First 100 words: Primary keyword included
- Images: Compressed, descriptive alt text
- Internal links: 3-5 to relevant pages
- External links: 2-3 to authoritative sources
- URL: Short, descriptive, keyword-included
- Schema markup: FAQ, Article, or appropriate type
Step 6: Quality Review Checklist
- E-E-A-T signals present (experience, expertise, authority, trust)
- Search intent fully satisfied
- Unique value vs. competitors
- Formatting clean and scannable
- All facts verified and sourced
- Brand voice consistent
- CTA clear and relevant
- No keyword stuffing
- Mobile-friendly layout
Content Templates
Template 1: How-To Guide
H1: How to [Achieve Outcome] in [Year]: [Benefit]
[Hook: State the problem and promise the solution]
Table of Contents
H2: Why [Topic] Matters
[Context and stakes]
H2: Step 1: [First Action]
[Instructions + example]
H2: Step 2: [Second Action]
[Instructions + example]
[Continue for all steps]
H2: Common Mistakes to Avoid
[3-5 pitfalls with solutions]
H2: FAQ
[4-6 questions in Q&A format]
H2: Conclusion
[Summary + CTA]
Template 2: Listicle/Roundup
H1: [Number] Best [Category] for [Outcome] in [Year]
[Hook: Why this matters + selection criteria]
Table of Contents
H2: Quick Comparison
[Summary table of all items]
H2: 1. [Item Name] - Best for [Use Case]
[Overview, features, pros/cons, who it's for]
[Continue for all items]
H2: How to Choose the Right [Category]
[Decision framework]
H2: FAQ
[4-6 questions]
H2: Conclusion
[Top picks summary + CTA]
Template 3: Ultimate Guide
H1: The Complete Guide to [Topic]: Everything You Need to Know
[Hook: Scope of guide + who it's for]
Table of Contents
H2: What is [Topic]?
[Definition + context]
H2: Why [Topic] Matters
[Benefits + stakes]
H2: How [Topic] Works
[Detailed explanation]
H2: [Major Subtopic 1]
H3: [Aspect 1]
H3: [Aspect 2]
[Continue for all subtopics]
H2: Best Practices
[5-10 actionable tips]
H2: Common Mistakes
[Pitfalls to avoid]
H2: Tools and Resources
[Recommended tools]
H2: FAQ
[6-10 questions]
H2: Conclusion
[Key takeaways + next steps]
Schema Markup Implementation
FAQ Schema (for featured snippets)
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "Your question here?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Your answer here (40-60 words)."
}
}]
}
Article Schema
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Title",
"author": {
"@type": "Person",
"name": "Author Name"
},
"datePublished": "2025-01-15",
"dateModified": "2025-01-15",
"image": "https://yoursite.com/image.jpg"
}
Integration with Other Skills
| Skill | Integration |
|---|---|
| seo-strategy | Provides keyword research and overall strategy |
| keyword-research | Feeds target keywords for content |
| brand-voice | Ensures consistent tone and personality |
| direct-response-copy | Makes content convert better |
| content-atomizer | Repurposes content across platforms |
| newsletter | Drives subscriber growth from SEO traffic |
Common Pitfalls
| Pitfall | Problem | Solution |
|---|---|---|
| Keyword stuffing | Unreadable, hurts rankings | Use keywords naturally, 2-3x max |
| Thin content | Not comprehensive enough | Match/exceed competitor depth |
| Wrong format | Misaligned with search intent | Analyze SERP before writing |
| No examples | Theoretical, not practical | Include real examples in each section |
| Missing E-E-A-T | Generic, no expertise shown | Add credentials, sources, experience |
| Poor structure | Hard to navigate | Use clear heading hierarchy |
| No internal links | Missed ranking opportunity | Link 3-5 relevant internal pages |
Metrics to Track
After publishing, monitor via Google Search Console:
| Metric | What It Tells You | Target |
|---|---|---|
| Impressions | Visibility in search | Increasing trend |
| Clicks | Traffic from search | Growing |
| CTR | Title/description effectiveness | >3% |
| Average position | Ranking progress | Top 10 |
| Dwell time (GA) | Content engagement | >2 minutes |
How to Use This Skill
- Get keyword from user — What are they targeting?
- Validate with seo-strategy — Is it winnable?
- Analyze SERP — What's the intent? What's missing?
- Create content brief — Structure the article
- Write with templates — Use appropriate format
- Apply checklists — On-page SEO + quality review
- Add schema markup — FAQ or Article
- Recommend tracking — GSC metrics to monitor
For complete keyword research methodology and 90-day SEO plans, use the /seo-strategy skill.
What's inside
Two optimization layers, 6-step process, 3 content templates, schema examples, and checklists.
Change this for your project
- Replace
majiayu000/claude-skill-registrywith your own repository path - Replace
./seo-strategywith the actual path to your strategy skill - Replace
https://yoursite.com/image.jpgwith your own image URL
Where it goes
Save as SKILL.md inside a skill folder. Loaded when the agent selects that skill.
Worth borrowing
- The 80/20 split between AI-generated drafts and human-added insights keeps content unique while saving time
- The competitor gap analysis template (what's missing from top 5 results) is a repeatable way to find ranking opportunities
Related Documents
AI Artist — Engineering Specification
Defines a 21-section engineering specification for a prompt construction skill, covering contracts, deterministic design, error taxonomy, and production readiness.
Image Generation Skill
Provides Python functions for generating, editing, and transforming images via DALL-E 3, FLUX (Replicate/fal.ai), and local Stable Diffusion, plus utilities and prompt engineering helpers.
draw.io Diagram Skill
Defines a complete workflow for creating, editing, exporting, and linting draw.io diagrams as native.drawio XML, including AWS icon support and SVG overlap checking.
Manage After Effects
Defines 8 action types and a JSON config format to automate After Effects composition building, rendering, and diagnostics from the command line or Python.