blog-write

What it does

Writes complete blog articles from a topic, brief, or outline, following dual optimization for Google rankings and AI citations. Produces articles with template selection, answer-first formatting, Key Takeaways summary box, information gain markers, citation capsules, sourced statistics, Pixabay/Unsplash images, built-in SVG chart generation, FAQ schema, internal linking zones, and proper heading hierarchy. Supports MDX, markdown, and HTML output. Trigger phrases include: "write blog", "new blog post", "create article", "write about", "draft blog", and "generate blog post".

How it works

• Phase 0/1: Surface targeting and topic understanding to determine audience, primary keyword, and word count, then template selection from 12 templates in skills/blog/templates/ and loading the matching template from skills/blog/templates/<type>.md. If none fits, use a generic outline and inform the user which template was selected.
• Phase 2: Research via a blog-researcher agent or inline WebSearch to collect 8-12 current statistics (2025-2026 preferred), acquire a cover image from Pixabay/Unsplash/Pexels or generate an SVG cover via blog-chart or an AI image via blog-image sub-skill, and collect 3-5 inline images. Plan 2-4 data visualizations and optional NotebookLM data if configured. Retrieve 2-3 YouTube videos per post with quality criteria.
• Phase 3: Outline generation using the loaded template’s structure, adapting headings and sections accordingly. Present the outline to the user for approval before writing.
• Phase 4: Chart generation (built-in). When data is chart-worthy, invoke blog-chart with chart type, title, data values, source, and platform format, embedding SVG within a <figure> wrapper (2-4 charts per 2,000-word post).
• Phase 5: Content writing with frontmatter, a Key Takeaways box immediately after the introduction, and 5c (Answer-First Formatting) for each H2 header. Include FLOW-compliant statistical statements with year anchoring, inline publisher/source citations, and a bottom source block. Add 5d Information Gain Markers and 5e Citation Capsules within each major H2 section. Use 5f Internal Linking Zones throughout the article and ensure the outline/sections align with the selected template. Visual markers should appear every 300-500 words and CTA rules referenced in the content rules.

When to use it

Use when the user says: "write blog", "new blog post", "create article", "write about", "draft blog", or "generate blog post".

What it can touch

• Tools: claude-code (as declared in the skill to perform tasks)
• Outputs include: frontmatter YAML, Markdown/MDX/HTML content, SVG charts, image references, and internal link placeholders like [INTERNAL-LINK: anchor text → target description].

Caveats

• License: MIT
• The process requires external data sources and templates; all statistics must be verifiable with inline citations following the FLOW drafting requirements. If a statistic cannot be verified, it should be dropped.
• The agent must present the article outline for approval before proceeding to full writing.