seo-content
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.
What this skill does
# 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
1. **For Search Engines** — Technical optimization for ranking
2. **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**:
1. Generate outline from brief
2. Expand each section
3. Add your unique examples and insights
4. Refine voice and tone
5. 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 Related in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".