--- name: seo-blog-images description: Plan, generate, compress, verify, and wire high-CTR cover images and inline proof visuals into blog posts (MDX, Astro, Next.js, Hugo, HTML) with strict image SEO checks. Use when adding a blog cover or OG image, generating inline visuals without dark icon-box AI slop, capturing real product screenshots or data charts, or auditing image alt text, filenames, and Core Web Vitals attributes. metadata: author: illyism source: https://il.ly/skills/seo-blog-images version: 1.0.0 --- # Blog images and image SEO The default AI blog visual hurts the post: a dark background with 5 glowing wireframe icons, garbled infographic labels, a `2.4 MB` PNG named `image-1.png`, and no `width`/`height`, so the layout jumps on load. This workflow picks the right visual type per slot, produces it (real capture, deterministic chart, or a short-prompt generation), reads every letter back, and wires SEO-complete tags into the post. ## Step 0: Find where images live ``` Which framework is the repo? ├── `next.config.*`, `astro.config.*`, `vite.config.*`, Remix -> files in `public/blog//`, src `/blog//.webp` ├── Hugo (`hugo.toml` / `config.toml`) -> page bundle next to `index.md`, or `static/blog//` ├── Jekyll (`_config.yml`) -> `assets/blog//` └── Other -> match the path pattern of an existing image in a published post ``` Never invent a new image directory when the repo already has one; mixed locations break the size audit and CDN caching rules. ## Step 1: Pick the visual type per slot Walk this for the cover and for each `

` that needs a visual: ``` What is this slot for? ├── Software product review or UI tutorial (`### 1. ToolName`)? │ └── Path B: real Playwright screenshot or short `