/optimize Command - SEO Machine

The /optimize command performs a final SEO optimization pass on completed articles, validating all elements meet best practices.

Usage

/optimize [article file]

article file

string

required

Path to the article file to optimize (in drafts/ or rewrites/)

Examples

/optimize drafts/content-marketing-strategies-2025-03-04.md

/optimize rewrites/podcast-guide-rewrite-2025-03-04.md

What It Does

Comprehensive SEO Audit

Keyword Analysis
Heading Structure
Content Quality

Primary Keyword Density: 1-2% throughout articleKeyword Placement Check:

In H1 headline ✓
In first 100 words ✓
In 2-3 H2 headings ✓
In meta title ✓
In meta description ✓
In URL slug ✓

Semantic Variations: Related keywords used naturallyKeyword Stuffing: No over-optimization detectedLSI Keywords: Latent semantic keywords present

Link Optimization

Internal Links (3-5+ required)

Count current internal links
Verify contextual relevance
Check keyword-rich anchor text
Ensure natural integration
Validate variety (pillar, blog, product, resources)
Cross-reference context/internal-links-map.md
Test for broken links

External Links (2-3+ required)

Count external authority links
Verify authoritative sources
Ensure relevance to content
Check link freshness
Test all external links
Verify appropriate nofollow usage

Meta Element Optimization

Meta Title

string

Requirements:

Length: 50-60 characters
Primary keyword included naturally
Compelling and click-worthy
Consider adding brand name
Distinct from other page titles

Output: 3-5 optimized alternatives with recommendations

Meta Description

string

Requirements:

Length: 150-160 characters
Primary keyword included
Clear value proposition
Call-to-action phrase
Encourages SERP click
Doesn’t cut off mid-sentence

Output: 3-5 optimized alternatives with recommendations

URL Slug

string

Requirements:

Concise but descriptive
Primary keyword included
Lowercase, hyphens between words
3-5 words ideal
No stop words unless necessary

Output: Evaluation and alternative if needed

Advanced SEO Analysis

The optimize command includes comprehensive analysis from specialized modules:

Search Intent

Verifies content matches user search intent (informational/commercial/transactional/navigational)

Keyword Density & Clustering

Detailed density analysis, keyword stuffing detection, topic clustering with TF-IDF

Content Length Comparison

Compares word count against top 10-20 SERP competitors for optimal length

Readability Score

Flesch Reading Ease, Flesch-Kincaid Grade Level, sentence structure analysis

SEO Quality Rating

Overall score (0-100) with category breakdowns and specific recommendations

Featured Snippet

Identifies snippet opportunities (question, list, table formats)

Output

Creates comprehensive optimization report saved to:

drafts/optimization-report-[topic-slug]-[YYYY-MM-DD].md

SEO Score (0-100)

Score Breakdown
Publishing Decision

Keyword Optimization: /25
Technical SEO: /25
Content Quality: /25
User Experience: /25
Overall Score: /100

Priority Fixes

List of critical issues:

## Priority Fixes

- [ ] Fix 1 (High Priority) - Add primary keyword to 2 more H2 headings
- [ ] Fix 2 (High Priority) - Increase word count to 2,200 (currently 1,850)
- [ ] Fix 3 (Medium Priority) - Add 2 more internal links

Optimization Recommendations

Quick Wins (5-10 minutes)

Specific keyword placement adjustments
Meta element tweaks
Internal link additions
Heading optimizations

Strategic Improvements (30+ minutes)

Content expansion opportunities
Structural reorganization
Additional research needed
Competitive gap filling

Optimized Meta Options

**Meta Title Options** (pick one):

1. Content Marketing Strategies for B2B SaaS | YourBrand (58 chars)
   ✓ Keyword front-loaded
   ✓ Clear target audience
   ✓ Brand included

2. 15 Content Marketing Strategies That Drive B2B SaaS Growth (59 chars)
   ✓ Number creates curiosity
   ✓ Benefit-focused
   - No brand name

3. B2B SaaS Content Marketing: 15 Strategies That Work (54 chars)
   ✓ Keyword present
   ✓ Specific and actionable
   - Shorter (could expand)

Link Enhancement

Internal Links to Add
External Links to Add

## Internal Links to Add

1. Link to "Complete Guide to B2B Marketing" in Section 2
   - Anchor text: "comprehensive B2B marketing strategy"
   - Location: After mentioning broader marketing context

2. Link to "Content Calendar Templates" in Section 5
   - Anchor text: "download our free content calendar template"
   - Location: When discussing planning process

3. Link to "SEO for SaaS Companies" in Section 4
   - Anchor text: "optimizing content for search engines"
   - Location: In SEO content strategy subsection

## External Links to Add

1. Add source for statistic in Section 1
   - Claim: "72% of B2B marketers say content marketing increases engagement"
   - Missing source: Content Marketing Institute 2024 Report
   - URL: https://contentmarketinginstitute.com/research/

2. Add authority link in Section 3
   - Topic: Email marketing benchmarks
   - Suggested source: Mailchimp Email Marketing Benchmarks
   - URL: https://mailchimp.com/resources/email-marketing-benchmarks/

Keyword Distribution Map

Visual representation of keyword placement:

## Keyword Distribution Map

Primary Keyword: "content marketing strategies"
Target Density: 1-2%
Current Density: 1.6% ✓

**Placement Checklist**:
- H1: ✓ Present
- First 100 words: ✓ Present
- H2 sections: 2/5 (need 1-2 more) ⚠️
- Body paragraphs: 18 instances ✓
- Conclusion: ✓ Present
- Meta title: ✓ Present
- Meta description: ✓ Present

**Recommendation**: Add keyword to "Planning Your Content" H2 (Section 4)
and "Measuring Content Success" H2 (Section 6)

Final Checklist

## Final Checklist

### Content
- [ ] Primary keyword in H1
- [ ] Primary keyword in first 100 words
- [ ] Primary keyword in 2+ H2 headings
- [ ] Keyword density 1-2%
- [ ] Article 2000+ words
- [ ] Proper H1/H2/H3 hierarchy
- [ ] 2-3 mini-stories with specific details
- [ ] 2-3 contextual CTAs throughout

### Links
- [ ] 3-5+ internal links included
- [ ] 2-3+ external authority links
- [ ] No broken links
- [ ] Descriptive anchor text

### Meta
- [ ] Meta title 50-60 characters
- [ ] Meta description 150-160 characters
- [ ] URL slug optimized

### Quality
- [ ] Readability optimized (8th-10th grade)
- [ ] Images have alt text
- [ ] CTA included
- [ ] Brand voice maintained
- [ ] Ready to publish

Agent Integration

The optimize command triggers final review from all agents:

Content Analyzer

Comprehensive analysis: search intent, keyword clustering, length comparison, readability, SEO quality (0-100)

SEO Optimizer

Technical SEO final check with specific recommendations

Meta Creator

Best meta title/description options with testing recommendations

Internal Linker

Last opportunity internal linking suggestions with placement

Keyword Mapper

Final keyword distribution analysis with heatmap

Real Example

Example: Optimizing a Content Marketing Article

# Optimization Report: Content Marketing Strategies
Date: 2025-03-04
File: drafts/content-marketing-strategies-2025-03-04.md

## SEO Score: 82/100

- Keyword Optimization: 21/25 ⚠️
- Technical SEO: 23/25 ✓
- Content Quality: 22/25 ✓
- User Experience: 16/25 ⚠️

**Status**: Good - Minor fixes recommended
**Publishing Readiness**: 90%
**Estimated Time to Publish**: 15 minutes

## Priority Fixes (High)

1. Add primary keyword to 1 more H2 heading
   - Current: 2/7 H2s have keyword
   - Target: 3/7 H2s (minimum)
   - Suggestion: Change "Planning Your Strategy" to "Planning Your Content Marketing Strategy"

2. Improve meta description
   - Current: 148 characters (too short)
   - Target: 155-160 characters
   - Add benefit statement to end

## Quick Wins (Medium)

3. Add 1 more internal link
   - Currently: 4 internal links
   - Target: 5+ links
   - Suggestion: Link to "SaaS Marketing Guide" in Section 3

4. Expand conclusion
   - Currently: 120 words
   - Target: 150-200 words
   - Add 2-3 more key takeaways

## Keyword Distribution: 1.6% ✓

Target keyword "content marketing strategies" appears 18 times in 2,450 words.
Distribution is natural and well-balanced across sections.

## Publishing Recommendation

✓ Address 2 high-priority fixes (10 minutes)
✓ Apply quick wins (5 minutes)
✓ Ready to publish

**Next Step**: Move to `published/` folder after fixes

Next Steps

After optimization:

Review the report - Read all recommendations
Address priority fixes - Fix high-priority issues
Apply quick wins - Make fast improvements
Publish - Move to WordPress or published/ folder

/publish-draft drafts/content-marketing-strategies-2025-03-04.md

Tips

Run Before Publishing

Always optimize before publishing to catch final issues.

Fix Priority Items

Address high-priority fixes first for maximum impact.

Test All Links

Verify all internal and external links work.

Review Meta Options

Test meta titles/descriptions in SERP preview tool.

/write

Create articles to optimize

/publish-draft

Publish optimized articles to WordPress

Getting Started

Core Concepts

Workflows

Commands

Advanced Commands

Agents

Data Sources

Integrations

​Usage

​Examples

​What It Does

​Comprehensive SEO Audit

​Link Optimization

​Meta Element Optimization

​Advanced SEO Analysis

Search Intent

Keyword Density & Clustering

Content Length Comparison

Readability Score

SEO Quality Rating

Featured Snippet

​Output

​SEO Score (0-100)

​Priority Fixes

​Optimization Recommendations

​Optimized Meta Options

​Link Enhancement

​Keyword Distribution Map

​Final Checklist

​Agent Integration

Content Analyzer

SEO Optimizer

Meta Creator

Internal Linker

Keyword Mapper

​Real Example

​Next Steps

​Tips

Run Before Publishing

Fix Priority Items

Test All Links

Review Meta Options

​Related Commands

/write

/publish-draft

Build docs developers (and LLMs) love

Usage

Examples

What It Does

Comprehensive SEO Audit

Link Optimization

Meta Element Optimization

Advanced SEO Analysis

Output

SEO Score (0-100)

Priority Fixes

Optimization Recommendations

Optimized Meta Options

Link Enhancement

Keyword Distribution Map

Final Checklist

Agent Integration

Real Example

Next Steps

Tips

Related Commands