← Back to list

optimizing-blog-posts-for-seo
by WesleySmits
43 production-ready skills for AI coding agents. Works with Claude, GitHub Copilot, Cursor, Windsurf, and Zed.
⭐ 0🍴 0📅 Jan 18, 2026
SKILL.md
name: optimizing-blog-posts-for-seo description: Analyzes and enhances existing blog posts for better search rankings. Use when the user asks about SEO optimization, blog post improvements, content refreshing, ranking improvements, or competitor content gaps.
SEO Blog Post Optimizer
When to use this skill
- User wants to improve existing blog posts
- User asks about SEO content optimization
- User mentions ranking improvements
- User needs competitor content analysis
- User wants to refresh outdated content
Workflow
- Analyze current content
- Research top-ranking competitors
- Identify content gaps
- Optimize on-page elements
- Enhance content structure
- Add supporting elements
- Validate improvements
Instructions
Step 1: Current Content Audit
Evaluate the existing post:
| Element | Check | Notes |
|---|---|---|
| Word count | Current vs. competitor avg | |
| Headings | H1, H2, H3 structure | |
| Target keyword | Primary and secondary | |
| Keyword density | 1-2% optimal | |
| Meta title | 50-60 chars, keyword included | |
| Meta description | 150-160 chars, compelling | |
| URL slug | Short, keyword-rich | |
| Images | Alt text, optimization | |
| Internal links | Relevant connections | |
| External links | Authoritative sources | |
| Publish date | Freshness signal |
Step 2: Competitor Analysis
Analyze top 5 ranking pages for target keyword:
## Competitor Analysis: "[Target Keyword]"
### Top Ranking Pages
| Rank | URL | Word Count | Headings | Key Sections |
| ---- | ----- | ---------- | -------- | ---------------- |
| 1 | [URL] | [#] | [#] | [Topics covered] |
| 2 | [URL] | [#] | [#] | [Topics covered] |
| 3 | [URL] | [#] | [#] | [Topics covered] |
### Common Elements (Present in 3+ competitors)
- [ ] [Section/topic 1]
- [ ] [Section/topic 2]
- [ ] [FAQ section]
- [ ] [Data/statistics]
- [ ] [Visual content]
### Differentiators (Unique angles to explore)
- [Gap 1]
- [Gap 2]
Step 3: Content Gap Analysis
Identify missing elements:
Structural gaps:
- Missing H2/H3 sections competitors cover
- No FAQ section when SERP shows "People Also Ask"
- Missing table of contents for long content
- No conclusion or summary section
Topic gaps:
- Subtopics competitors address
- Questions not answered
- Use cases not covered
- Examples not provided
Technical gaps:
- Missing schema markup
- No featured snippet optimization
- Poor mobile formatting
- Slow-loading elements
Step 4: On-Page Optimization
Title Tag Optimization
Format: [Primary Keyword] - [Benefit/Modifier] | [Brand]
Example: "SEO Blog Writing: 15 Tips to Rank Higher in 2026 | ContentPro"
Title formulas:
- How to [Keyword]: [Number] [Adjective] Ways
- [Keyword]: The Complete Guide for [Year]
- [Number] [Keyword] Tips That [Benefit]
- [Keyword] vs [Alternative]: Which Is Better?
Meta Description Optimization
Format: [Hook with keyword] + [Value proposition] + [CTA]
Example: "Learn proven SEO blog writing techniques that boost rankings. Discover 15 actionable tips used by top content marketers. Start ranking today."
URL Optimization
- Keep under 60 characters
- Include primary keyword
- Remove stop words (a, the, and, or)
- Use hyphens, not underscores
Step 5: Content Structure Enhancement
Heading Hierarchy
# H1: Main Title (1 only, contains primary keyword)
## H2: Major Section (contains secondary keywords)
### H3: Subsection (supports H2 topic)
#### H4: Detail point (rarely needed)
Recommended Structure
- Hook intro (50-100 words) - Problem + promise
- Quick answer - Featured snippet target
- Table of contents - For posts 1,500+ words
- Main sections - Comprehensive coverage
- FAQ section - "People Also Ask" answers
- Conclusion - Summary + CTA
Featured Snippet Optimization
| Snippet Type | Format | Target |
|---|---|---|
| Paragraph | 40-60 word answer after H2 question | Definition queries |
| List | Numbered/bulleted under H2 | "How to" queries |
| Table | Comparison data | "vs" or comparison queries |
Step 6: Content Enrichment
Add Missing Elements
Statistics and data:
- Find recent statistics (within 2 years)
- Link to primary sources
- Format as callout boxes or tables
Visual content:
- Add 1 image per 300-500 words
- Include infographics for data
- Add screenshots for tutorials
- Consider embedded video
Examples and case studies:
- Real-world applications
- Before/after comparisons
- Step-by-step walkthroughs
Expert quotes:
- Industry authority opinions
- Customer testimonials
- Research citations
Internal Linking Strategy
| Link Type | Purpose | Anchor Text |
|---|---|---|
| Pillar to cluster | Authority distribution | Descriptive, keyword-rich |
| Cluster to pillar | Support main topic | Exact or partial match |
| Related posts | User journey | Natural, contextual |
| CTA links | Conversion | Action-oriented |
Target 3-5 internal links per 1,000 words.
External Linking
- Link to authoritative sources (.edu, .gov, industry leaders)
- Open in new tab
- 2-5 external links per post
- Avoid linking to competitors
Step 7: Technical SEO Checks
## Technical SEO Checklist
### Schema Markup
- [ ] Article schema implemented
- [ ] FAQ schema (if FAQ section exists)
- [ ] HowTo schema (if tutorial)
- [ ] Breadcrumb schema
### Page Speed
- [ ] Images compressed (WebP format)
- [ ] Lazy loading enabled
- [ ] Core Web Vitals passing
### Mobile Optimization
- [ ] Responsive layout
- [ ] Tap targets sized correctly
- [ ] Text readable without zoom
- [ ] No horizontal scrolling
### Indexing
- [ ] Page is indexable (no noindex)
- [ ] Canonical URL correct
- [ ] XML sitemap includes page
- [ ] No orphan page (internal links exist)
Step 8: Content Freshness
Update signals:
- Change publish date to current date
- Add "Updated: [Date]" notice
- Update statistics with recent data
- Add new sections for current trends
- Replace outdated screenshots/examples
Historical optimization:
- Keep original publish date visible
- Add "Originally published: [Date]"
- Note major updates in content
Output Format
# SEO Optimization Report: [Post Title]
## Current Performance
- **URL:** [URL]
- **Target keyword:** [Keyword]
- **Current word count:** [#]
- **Publish date:** [Date]
---
## Competitor Benchmark
| Metric | Your Post | Competitor Avg | Gap |
| -------------- | --------- | -------------- | ------ |
| Word count | [#] | [#] | [+/-#] |
| Headings | [#] | [#] | [+/-#] |
| Images | [#] | [#] | [+/-#] |
| Internal links | [#] | [#] | [+/-#] |
---
## Recommended Improvements
### High Priority
1. [Action item with specific guidance]
2. [Action item with specific guidance]
### Medium Priority
1. [Action item]
2. [Action item]
### Low Priority
1. [Action item]
---
## Content Additions
### New Sections to Add
- **[H2 heading]**: [Brief description of what to cover]
- **[H2 heading]**: [Brief description]
### FAQ Section
**Q: [Question from PAA]**
A: [40-60 word answer]
**Q: [Question]**
A: [Answer]
---
## On-Page Optimizations
**Recommended title tag:**
[New title - 60 chars max]
**Recommended meta description:**
[New description - 160 chars max]
**Internal links to add:**
- [Anchor text] → [Target URL]
- [Anchor text] → [Target URL]
---
## Technical Fixes
- [ ] [Fix needed]
- [ ] [Fix needed]
---
## Expected Impact
[Brief statement on potential ranking improvement]
Validation
Before completing:
- All competitor pages analyzed
- Content gaps identified
- On-page elements optimized
- Structure improvements recommended
- Internal linking strategy included
- Technical SEO checked
- Actionable recommendations provided
Error Handling
- No target keyword provided: Ask user to specify primary keyword.
- Post not found: Request URL or content to analyze.
- No competitors ranking: Broaden keyword scope or check search volume.
- Content too thin: Recommend expanding or combining with related posts.
Resources
- Google Search Console - Performance data
- Ahrefs - Competitor analysis
- Semrush - Keyword research
- Schema.org - Structured data reference
- PageSpeed Insights - Performance testing
Score
Total Score
60/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
○LICENSE
ライセンスが設定されている
0/10
✓説明文
100文字以上の説明がある
+10
○人気
GitHub Stars 100以上
0/15
✓最近の活動
1ヶ月以内に更新
+10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
○言語
プログラミング言語が設定されている
0/5
✓タグ
1つ以上のタグが設定されている
+5
Reviews
💬
Reviews coming soon

