Input Format

{
  "topic": "string — the main subject of the article",
  "primary_keyword": "string — exact keyword to rank for",
  "secondary_keywords": ["string", "string"],
  "target_audience": "string — who is reading this",
  "tone": "informational | conversational | authoritative | persuasive",
  "word_count": "integer — minimum 800, maximum 3000, default 1500",
  "cluster_context": "string — optional, paste content cluster output here",
  "internal_link_targets": ["string — page/post titles to link to"],
  "product_cta": "string — optional CTA and destination",
  "search_intent_evidence": "string — optional observed SERP/API evidence",
  "distribution_platforms": ["string — optional external platforms"]
}

Write to the dominant search intent, not merely the keyword. The article should solve a recognizable problem and make the next product action clear without turning an informational article into an unsupported sales pitch.

Output Structure

The skill must always produce a blog post in this exact section order:

# [H1: Primary Keyword-Optimised Title]

> **TL;DR:** [2–3 sentence direct answer to the article's core question.
> This is the AEO extraction block — write it to be lifted by AI engines.]

## Introduction
[Hook sentence. State the problem or question clearly in the first 2 lines.
Mention the primary keyword naturally within the first 100 words.]

---

## [H2: What Is {Topic}]
[Definition block — write a single, clean, extractable definition sentence
as the very first line of this section. Follow with 2–3 paragraphs of context.]

---

## [H2: Why {Topic} Matters / The Core Problem]
[Establish relevance. Use bullet points or a numbered list in this section.]

---

## [H2: How {Topic} Works / Main Body Section]
[Deepest section. Use H3 subheadings for sub-concepts. Include at least
one comparison block formatted as a table if comparing two or more things.]

### [H3: Sub-concept 1]
### [H3: Sub-concept 2]
### [H3: Sub-concept 3]

---

## [H2: Practical Steps / How To Section — if applicable]
[Numbered list of steps. Each step max 2 sentences. Scannable.]

---

## [H2: Common Mistakes / What To Avoid — if applicable]
[Bullet list format. Short, punchy, extractable by AI.]

---

## Frequently Asked Questions

**Q: [Question using a long-tail keyword]**
A: [Direct answer, 2–3 sentences max. No fluff.]

**Q: [Question using a secondary keyword]**
A: [Direct answer.]

**Q: [Question the target audience commonly asks]**
A: [Direct answer.]

**Q: [Question about cost, time, or comparison]**
A: [Direct answer.]

**Q: [Question about a common misconception]**
A: [Direct answer.]

---

## Conclusion
[Restate the core answer from the TL;DR in new words.
One call to action sentence at the end.]

---

## Internal Links
[INTERNAL LINK: {internal_link_target_1}]
[INTERNAL LINK: {internal_link_target_2}]

## External Links
[EXTERNAL LINK: authoritative source relevant to primary keyword]

## Product CTA
[CTA: relevant product action and destination]

## External Distribution Notes
- [Platform]: [adaptation angle, canonical-link decision, and backlink target]

AEO Requirements

Every blog post produced by this skill MUST contain:

A TL;DR block immediately after the H1
A clean definition sentence as the first line of the "What Is" section
At least one comparison table (if topic involves comparing options)
Exactly 5 FAQ entries with direct, concise answers
Bullet or numbered lists in at least 2 sections
Primary keyword in: H1, first 100 words, at least one H2, meta description
A relevant product CTA or next step is present when the article supports conversion
Internal links connect the article to a foundational page and, where relevant, the product

SEO Requirements

H1: appears exactly once, contains primary keyword
H2s: fit the article and optional sections; avoid keyword stuffing
H3s: used only inside H2 sections, not standalone
Word count: stay within the range specified in input; default 1500 words
Keyword use: natural and intent-aligned; do not force a density percentage
No duplicate headings

Execution Steps

Read cluster_context if provided — use it to decide which sub-topics to cover and which to leave for linked cluster articles
Review search_intent_evidence if provided and state the problem the article solves
Write the TL;DR block first — this anchors the whole article's direction
Build the heading skeleton before writing body content
Write the definition block in the "What Is" section as a single sentence
Write the FAQ section using long-tail and secondary keywords as questions
Insert internal links at natural transition points, including a foundational page and product CTA where appropriate
Verify factual claims against authoritative sources; label unavailable links as suggestions, never invent quotations, statistics, testimonials or URLs. Mark internal-link placeholders for replacement before publication.
Do a final keyword placement check against the SEO Requirements checklist
Do a final AEO, conversion, and claim-verification pass before outputting

Connected Skills

Receives output from: seo-aeo-content-cluster
Feeds output to: seo-aeo-content-quality-auditor, seo-aeo-internal-linking

When to Use

Use when creating or revising a long-form article intended to capture a specific search intent and guide readers toward a relevant next step.

Limitations

Answer-first formatting cannot guarantee AI extraction or citation. Drafting does not authorize publication or external distribution.
Search performance depends on the actual site, competition, content quality, and indexing; this skill cannot guarantee rankings or traffic.

seo-aeo-blog-writer

Blog Writer Skill

Description