blog-post

A workflow for writing and structuring long-form blog posts (tutorials, how-to guides, technical writeups, and thought-leadership pieces) with SEO optimization and an accompanying cover image. It enforces a research-first rule: before writing, delegate research to a researcher subagent via the task tool, specifying both the topic and a save path (research/[slug].md), then read the findings file before drafting.

Every post has a required two-part output: the article at blogs/<slug>/post.md and a generated cover image at blogs/<slug>/hero.png. A post is considered incomplete without its hero image.

The prescribed article structure runs Hook (a compelling question, statistic, or statement in two to three sentences), Context (why the topic matters and the problem it addresses), Main Content (three to five H2 sections, each covering one point, with code, diagrams, or screenshots as needed), Practical Application (step-by-step guidance and snippets), and a Conclusion with a clear call-to-action summarizing up to three takeaways.

Cover images are produced with the generate_cover tool, which takes a prompt and slug and saves to the hero path. It teaches how to write effective image prompts across six elements (subject, style, composition, color palette, lighting or atmosphere, and technical details like aspect ratio and negative space for text overlay) and supplies example prompts tuned for technical posts, tutorials, and thought-leadership pieces. SEO guidance covers placing the main keyword in the title and first paragraph, using it naturally three to five times, keeping the title under 60 characters, and writing a 150 to 160 character meta description. A closing quality checklist confirms the post and hero image exist, the hook lands in the first two sentences, each section has a clear purpose, and the conclusion and call-to-action are in place.