blog-write

What it does

Writes complete blog articles from a topic, brief, or outline. Every article follows the 6 pillars of dual optimization (Google rankings + AI citations).

How it works

• Phase 1 (Topic Understanding): Determine topic details such as target audience, primary keyword, and word count; load brief if present.
• Phase 1.5 (Template Selection): Choose a content template from skills/blog/templates/ based on content type detected from topic/search intent; load the matching template and adapt outline accordingly.
• Phase 2 (Research): Spawn a blog-researcher or perform inline research to gather 8-12 statistics (2025-2026 preferred), find a cover image via stock APIs or generate SVG cover with blog-chart, locate 3-5 inline images, plan 2-4 data visualizations, optionally perform AI image generation, and optionally query NotebookLM and YouTube videos with quality checks.
• Phase 3 (Outline Generation): Create a structured outline aligned to the loaded template, with an initial Title as Question and sections such as Introduction, multiple H2s, a CTA, optional FAQ, and Conclusion. Visual markers are inserted every 300-500 words and CTA rules are followed.
• Phase 4 (Chart Generation): When data warrants, generate charts using blog-chart and embed SVGs in a <figure> wrapper, targeting 2-4 charts per ~2000-word post.
• Phase 5 (Content Writing): Produce full article with frontmatter, a Key Takeaways box immediately after the Introduction, and Purpose-First Formatting in each section. Include evidence-backed explanations, information-gain markers when applicable, internal-link placeholders, and comply with the project's frontmatter naming conventions. Insert visual markers for images, charts, videos, or callouts at the specified cadence. Present the outline to the user for approval before writing.

When to use it

Use when the user requests actions like "write blog", "new blog post", "create article", "write about", "draft blog", or "generate blog post".

What it can touch

Not applicable in this summary; the skill references tools such as claude-code for execution within the workflow when needed.

Caveats

Licensed under MIT. The workflow relies on external research sources and template-driven structure; verify model outputs against current data and templates. The skill outlines a lengthy, multi-phase process with conditional steps (research, template selection, outline approval, chart generation, and final writing).