seo-article-architect

Installation

$npx skills add ducquanghuy3-sys/ai-agent-skills --skill seo-article-architect

Summary

Generate publish-ready SEO articles with keyword research, content structure, full metadata (title, description, schema markup), internal linking strategy, and platform-specific optimization for Google and Baidu. Invoke this when an agent needs to create blog posts, ranking content, or long-form articles with complete SEO setup.

SKILL.MD

SEO Article Architect

One keyword → Publish-ready, SEO-optimized long-form article with complete metadata.

Language & Search Engine Detection

  • English keyword/topic → Google SEO optimization
  • Chinese keyword/topic → Baidu + Google CN dual optimization
  • User can specify target engine: "optimize for Baidu" or "optimize for Google"

Input Processing

Accept:

  • Target keyword: "best project management tools 2026"
  • Topic description: "write about how AI is changing healthcare"
  • URL to outrank: "write a better version of [competitor URL]"
  • Chinese: "写一篇关于远程办公工具的SEO文章"

From input, extract/generate:

  • Primary keyword
  • 5-10 secondary keywords (LSI / semantically related)
  • Search intent: Informational / Commercial / Transactional / Navigational
  • Target word count based on intent and competition

Article Generation Process

Phase 1: Keyword & Intent Analysis

┌─────────────────────────────────────────────┐
│  SEO BRIEF                                  │
│  Primary Keyword: [keyword]                 │
│  Search Intent: [type]                      │
│  Difficulty Estimate: [Low/Med/High]        │
│  Target Word Count: [X-Y words]             │
│  Content Type: [Guide/List/Review/How-to]   │
│  Target Audience: [Description]             │
└─────────────────────────────────────────────┘

Secondary Keywords:
1. [keyword] — [est. volume] — [use in: H2/body/meta]
2. [keyword] — [est. volume] — [use in: H2/body]
3. ...

Long-tail Variations:
1. [question format keyword]
2. [comparison keyword]
3. [location-based keyword if applicable]

Phase 2: Content Structure (Outline)

Generate a detailed outline before writing:

# [H1 Title — includes primary keyword, <60 chars]

## [H2 Section 1 — includes secondary keyword]
### [H3 Subsection if needed]

## [H2 Section 2]

## [H2 Section 3]

## [H2 FAQ Section — targets "People Also Ask"]
### [FAQ Q1 — exact question from PAA]
### [FAQ Q2]
### [FAQ Q3]

## [H2 Conclusion with CTA]

Outline rules:

  • H1: One per article, includes primary keyword naturally
  • H2s: 4-8 sections, each targets a secondary keyword
  • H3s: Use when H2 section exceeds 300 words
  • FAQ: 3-5 questions targeting "People Also Ask" featured snippets
  • Content flows logically (reader shouldn't need to jump around)

Phase 3: Full Article

Write the complete article following these SEO content rules:

Keyword Placement (Critical):

  • Primary keyword in: H1, first paragraph (first 100 words), one H2, meta title, meta description, URL slug, image alt text
  • Keyword density: 0.5-1.5% (natural, never forced)
  • Secondary keywords: distributed naturally across H2s and body
  • Semantic variations: use synonyms and related terms throughout
  • NO keyword stuffing — if it reads unnaturally, rewrite

Content Quality Signals:

  • E-E-A-T compliance: Show Experience, Expertise, Authority, Trust
    • Include first-hand experience language ("In our testing...", "Based on X years of...")
    • Cite credible sources with context
    • Acknowledge limitations and counterpoints
  • Comprehensiveness: Cover the topic more thoroughly than current top-3 results
  • Freshness signals: Reference current year, recent data, latest updates
  • Readability: Short paragraphs (2-4 sentences), varied sentence length, transition words
  • Scannable: Bold key phrases, use bullet points for lists, tables for comparisons

Engagement Elements:

  • TL;DR / Key Takeaways box at the top (helps featured snippets)
  • Comparison tables (for commercial intent keywords)
  • Step-by-step instructions (for how-to intent)
  • Expert quotes or data citations (E-E-A-T)
  • Internal linking placeholders: [INTERNAL LINK: anchor text → suggested target page topic]
  • External citations: link to authoritative sources (gov, edu, major publications)

Content Length Guidelines by Intent:

  • Informational/Guide: 1,500-3,000 words
  • Commercial comparison: 2,000-4,000 words
  • How-to: 1,000-2,000 words
  • Product review: 1,500-2,500 words
  • News/Update: 800-1,200 words

Phase 4: SEO Metadata Package

Append complete metadata after the article:

═══════════════════════════════════════════════════
SEO METADATA PACKAGE
═══════════════════════════════════════════════════

META TITLE (50-60 chars):
[Primary keyword + modifier + brand if applicable]
Character count: [X]

META DESCRIPTION (150-160 chars):
[Compelling summary with primary keyword + CTA]
Character count: [X]

URL SLUG:
/[keyword-separated-by-hyphens]

OG TITLE (for social sharing):
[Can be slightly different/more clickable than meta title]

OG DESCRIPTION:
[Social-optimized description]

SCHEMA MARKUP SUGGESTION:
- Article schema (headline, author, datePublished, dateModified)
- FAQ schema (if FAQ section present — boosts SERP real estate)
- HowTo schema (if step-by-step content)
- Review schema (if product review with rating)

IMAGE ALT TEXTS:
- Hero image: "[primary keyword] — [descriptive context]"
- Image 2: "[secondary keyword] [description]"
- ...

INTERNAL LINKING SUGGESTIONS:
1. "[anchor text]" → link to [topic/page about X]
2. "[anchor text]" → link to [topic/page about Y]
3. "[anchor text]" → link to [topic/page about Z]

EXTERNAL CITATION LINKS:
1. [Source name] — [URL] — used for [what claim]
2. ...

TARGET FEATURED SNIPPET:
Type: [Paragraph / List / Table]
Target query: "[question]"
Optimized answer (40-60 words):
[Concise answer formatted for snippet extraction]

Phase 5: Baidu-Specific Optimization (Chinese content only)

Additional metadata for Baidu:

百度SEO补充优化:

百度标题 (max 30 Chinese chars):
[标题 — 包含核心关键词]

百度描述 (max 78 Chinese chars):
[描述文案]

百度关键词标签:
[关键词1], [关键词2], [关键词3]

百度特色内容建议:
- 百家号同步发布版本(800字精简版)
- 百度知道/贴吧问答植入建议
- 百度百科引用机会

注意事项:
- 百度偏好:原创声明、发布时间、更新频率
- 避免:过度堆砌关键词、隐藏文字、大量外链
- 移动优先:百度移动端流量>70%,确保移动友好

Quality Checklist

Before final output:

  • Primary keyword appears in H1, first 100 words, one H2, meta title, meta description
  • No keyword stuffing (reads naturally when read aloud)
  • All H2s serve both readers and search engines
  • FAQ section targets real "People Also Ask" questions
  • Content is more comprehensive than a typical top-3 result
  • E-E-A-T signals present (experience, expertise, citations)
  • Current year referenced for freshness
  • Internal linking opportunities identified
  • Meta title ≤60 chars, meta description ≤160 chars
  • Featured snippet opportunity identified and optimized
  • Content matches search intent perfectly
  • Readability: short paragraphs, headers every 200-300 words

Reference Files

  • references/seo-checklist.md — Technical SEO checklist for published articles