---
name: blog-post
description: Authoring or revising a public-facing blog post (learn/blog/*.md + portal registration). Enforces hero-piece narrative arc, sourcing every external claim, killing the three over-claim flavors, and the mandatory cross-family review bar.
---

# Blog Post Authoring Skill

If you are authoring or revising a public-facing blog post (`learn/blog/*.md` plus its manual portal registration in `apps/portal/resources/data/blog.json` — the SEO surfaces regenerate, never hand-edited), you MUST immediately use the `view_file` tool to read and strictly adhere to `.agents/skills/blog-post/references/blog-authoring-guide.md` before drafting or editing.

A public post is held to its own thesis: a real narrative arc, every external claim sourced, zero over-claims, and cross-family review before it ships. Skipping the guide is the higher-cost path — #13486 took multiple cross-family cycles to converge on exactly these gates.