--- name: seo-aeo-blog-writer description: "Writes search-intent-led long-form articles with answer-first structure, FAQ coverage, internal links, and conversion paths for SEO and AEO." risk: safe source: community date_added: "2026-04-01" --- # Blog Writer Skill ## Description Activate this skill when the user wants to write a blog post, article, or long-form content piece for SEO and AEO purposes. Trigger phrases include: "write a blog post", "create an article", "generate blog content", "write a long-form post about", "blog writer". ## Input Format ```json { "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: ```markdown # [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: 4–6 per article, no 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 1. Read `cluster_context` if provided — use it to decide which sub-topics to cover and which to leave for linked cluster articles 2. Review `search_intent_evidence` if provided and state the problem the article solves 3. Write the TL;DR block first — this anchors the whole article's direction 4. Build the heading skeleton before writing body content 5. Write the definition block in the "What Is" section as a single sentence 6. Write the FAQ section using long-tail and secondary keywords as questions 7. Insert internal links at natural transition points, including a foundational page and product CTA where appropriate 8. Add external-source suggestions only when they are authoritative and relevant 9. Do a final keyword placement check against the SEO Requirements checklist 10. 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 - Search performance depends on the actual site, competition, content quality, and indexing; this skill cannot guarantee rankings or traffic.