SEO-Optimized Technical Blog Generator
Generate a production-ready, fully SEO/AEO/GEO optimized technical blog post.
Input
User will provide: $ARGUMENTS
This can be:
- A blog topic (e.g., "web application security best practices")
- A keyword from research (e.g., "digital marketing services in Bahrain")
- A full brief with keywords (e.g., "topic: X, primary keyword: Y, target: Z")
If no topic is provided, ask the user for a blog topic. If the topic seems broad, suggest running /blog-research first.
Process
Step 1: Keyword Research (GEO + SEO)
If user provides keywords from /blog-research: Use those directly, skip to Step 2.
If user provides only a topic: Do quick keyword research:
- Web search: "[topic] 2026 keywords", "[topic] people also ask"
- Web search: "[topic] trending subtopics"
- Identify: 1 primary keyword, 3-5 secondary keywords, 2-3 long-tail keywords
- Check what's currently ranking and what AI engines (ChatGPT, Perplexity, Google AI Overview) cite for this topic
- If a target region is mentioned, add geo-modifiers to keywords
Present keyword plan to user before writing:
Primary Keyword: [keyword]
Secondary Keywords: [kw1], [kw2], [kw3]
Long-tail: [lt1], [lt2]
Search Intent: [Informational/Commercial/Transactional]
Target Region: [if applicable]
Proceed with writing? (Y/n)
Step 2: Content Directory Detection
Check the project for where blogs are stored:
- Look for
content/blogs/, src/content/, blog/, posts/ directories
- Match the existing frontmatter format of other blog files
- If no blog directory exists, ask the user where to save
Step 3: Write the Blog Post
Create a markdown file with this exact structure:
Frontmatter (Programmatic SEO)
---
title: "[Primary Keyword near start] — [Compelling hook under 60 chars]"
description: "[Under 160 chars, includes primary keyword, creates curiosity]"
date: "[YYYY-MM-DD]"
image: "/blogs/[slug].jpg"
tags: ["Tag1", "Tag2", "Tag3", "Tag4", "Tag5", "Tag6"]
---
Note: Match frontmatter fields to existing blogs in the project. Some projects use category, author, draft, slug etc.
Content Structure
1. TL;DR (AEO)
- 2-3 sentence direct answer to the topic
- Include 1 key statistic with source
- This is what AI engines will extract — make it citation-worthy
2. Introduction / What is [Topic]?
- Clear definition in first sentence (featured snippet bait)
- Why it matters — real statistic with citation ("According to [Source], ...")
- Image reference:
3. Core Sections (3-5 sections with H2 headings)
Each section must include:
- H2 heading with a secondary keyword
- Opening sentence that directly answers "what is this" (AEO)
- A table OR code block OR comparison (linkable asset for off-page SEO)
- At least 1 statistic with source attribution (GEO — AI engines cite sourced claims)
- Practical example or code snippet where relevant
- Use H3 subsections to break down complex topics
4. Practical Section
- Real-world workflow, implementation guide, or "how to get started" steps
- Code examples with comments (TypeScript/JavaScript preferred for tech blogs)
- Before/after comparisons where applicable
- For non-tech/marketing blogs: step-by-step guides, checklists, templates
5. Trade-offs / When to Use What
- Honest comparison (builds E-E-A-T trust signals)
- Table format preferred (featured snippet + linkable asset)
6. FAQ Section (SEO Rich Snippets + AEO)
- 4-5 questions in
### Question? format
- Each answer: 2-4 sentences, direct, starts with the answer (not "Well..." or "It depends...")
- Include questions people actually search for (use "People Also Ask" patterns)
- For geo-targeted blogs, include region-specific questions
7. Resources Section (GEO + Off-page SEO)
- 5-6 real, authoritative links (official docs, research papers, reputable blogs)
- Use format:
[Descriptive Anchor Text](URL)
- Prefer: official documentation, GitHub repos, research from known companies
Step 4: SEO Checklist (verify before saving)
Step 5: Internal Linking (if existing blogs found)
- Check other blog files in the project
- Add 1-2 internal links to related existing posts where natural
- Suggest which existing posts should link back to this new post
Writing Rules
- Language: English (unless user specifies otherwise)
- Tone: Professional but easy to understand (a beginner should get it)
- No fluff, no filler — every sentence adds value
- Use "you" to address the reader directly
- Bold key terms on first use
- Keep paragraphs short (3-4 sentences max)
- Total length: 1500-2500 words (optimal for SEO)
Geo-Targeted Blog Rules (for regional businesses)
When writing for a specific region (e.g., Bahrain, Dubai, USA):
- Include city/country in title and at least 2 headings
- Reference local market conditions, regulations, or trends
- Use local business examples where possible
- Include region-specific statistics
- Add "in [Region]" to FAQ questions
- Consider local search intent (may differ from global)
SEO Optimization Summary
| Type | What It Covers | How This Blog Does It |
|---|
| SEO | Google ranking | Keywords in title/headings, meta description, heading hierarchy, internal links |
| AEO | Answer engines, featured snippets | TL;DR, FAQ section, direct definitions, concise answers |
| GEO | AI search (ChatGPT, Perplexity, Gemini) | Cited statistics, "According to" patterns, authoritative sources |
| Programmatic SEO | Scalable content structure | Consistent frontmatter, tags, structured format, slug pattern |
| Off-page SEO | Linkability and shareability | Tables, comparisons, quotable stats, resource links to authority sites |
