Optimize Command

Use this command to perform a final SEO optimization pass on completed articles before publishing.

Usage

/optimize [article file]

What This Command Does

1. Performs comprehensive SEO audit of article
2. Fine-tunes keyword placement and density
3. Optimizes meta elements for SERP performance
4. Validates internal and external links
5. Ensures all SEO best practices are met

Process

Content Audit

#### Keyword Analysis

• Primary Keyword Density: Check 1-2% density throughout article
• Keyword Placement Check:
• [ ] In H1 headline
• [ ] In first 100 words
• [ ] In at least 2-3 H2 headings
• [ ] In meta title
• [ ] In meta description
• [ ] In URL slug
• Semantic Variations: Verify related keywords are used naturally
• Keyword Stuffing: Ensure no over-optimization or unnatural usage
• LSI Keywords: Confirm latent semantic keywords are present

#### Heading Structure

• H1: Only one H1, includes primary keyword
• H2s: 4-7 H2 sections, at least 2-3 with keyword variations
• H3s: Proper nesting under H2s, descriptive and keyword-rich
• Hierarchy: Logical progression, no skipped levels (H1→H3)
• Length: Headings are descriptive but concise

#### Content Quality

• Word Count: Minimum 2000 words (2500-3000+ preferred)
• Paragraph Length: Average 2-4 sentences, no walls of text
• Sentence Length: Varied, averaging under 25 words
• Readability Score: 8th-10th grade level (Flesch-Kincaid)
• Active Voice: Predominantly active voice usage
• Transition Words: Smooth flow between sections
• List Usage: Bullets/numbers for scannability
• Formatting: Bold, italics used appropriately for emphasis

Link Optimization

#### Internal Links (3-5+ required)

• Quantity: Count current internal links to your company content
• Quality: Verify links are contextually relevant
• Anchor Text: Check for keyword-rich, descriptive anchor text
• Placement: Natural integration within body content
• Variety: Links to different page types (pillar, blog, product, resources)
• Reference: Cross-check @context/internal-links-map.md for opportunities
• Broken Links: Verify all internal links work

Recommendations:

• Where to add additional internal links
• Better anchor text for existing links
• High-priority pages that should be linked

#### External Links (2-3+ required)

• Quantity: Count external authority links
• Authority: Verify links are to credible, authoritative sources
• Relevance: Ensure external links support content claims
• Freshness: Check that linked sources are current
• Broken Links: Test all external links
• Link Attributes: Verify appropriate use of nofollow where needed

Recommendations:

• Additional authoritative sources to link
• Outdated links to replace
• Statistics that need source citations

Meta Element Optimization

#### Meta Title

• Length: 50-60 characters (check current length)
• Keyword: Primary keyword included naturally
• Compelling: Attention-grabbing and click-worthy
• Brand: Consider adding "| your company" if space allows
• Uniqueness: Distinct from other your company page titles

Provide:

• Current meta title analysis
• 3-5 optimized alternative options
• Recommended best choice

#### Meta Description

• Length: 150-160 characters (check current length)
• Keyword: Primary keyword included
• Value Prop: Clear benefit to reader
• Call-to-Action: Includes action phrase (learn, discover, find out)
• Compelling: Encourages click from SERP
• Completeness: Doesn't cut off mid-sentence

Provide:

• Current meta description analysis
• 3-5 optimized alternative options
• Recommended best choice

#### URL Slug

• Length: Concise but descriptive
• Keyword: Primary keyword included
• Structure: Lowercase, hyphens between words
• Brevity: Shorter is better (3-5 words ideal)
• Clean: No stop words (a, the, and) unless necessary

Provide:

• Current URL evaluation
• Alternative if improvement needed

Technical SEO

#### Image Optimization

• Alt Text: Note where images need alt text with keywords
• File Names: Check that image file names are descriptive
• Placement: Images break up text appropriately
• Relevance: Images support content points

#### Featured Snippet Opportunity

• Question Format: Check if content answers specific question
• List Format: Identify list-based content for snippet optimization
• Table Format: Note if data could be formatted as table
• Definition: Check if concept could be featured snippet
• Optimization: Suggest how to structure for snippet capture

#### Schema Markup Suggestions

• Article Schema: Recommend article schema elements
• FAQ Schema: If Q&A format used
• How-To Schema: If step-by-step instructions included

Brand & Voice

#### your company Alignment

• Brand Voice: Verify align