Blog seo standards
Skill ProstDev/skills/plugins/content/skills/blog-seo-standards
Agent skills for Claude Code and 80+ other AI coding agents — content authoring, dev workflow, and general session helpers. Install via /plugin or npx skills add.
npx -y skills add ProstDev/skills --skill blog-seo-standardsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 12 days oldThe repository was created 12 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
SEO + AEO standards for writing or reviewing a technical blog post — title, meta description, headings, images, structured data, and the frontmatter that feeds them. Use when the user asks whether a post is "SEO-friendly", wants a title/description/heading/alt-text check, or is drafting an article to be found by search + AI answer engines. Separates EDITORIAL guidelines from the actual 2026 SEO numbers for word count, title length, and meta-description length. This is the SEO source of truth; for readability/structure see [[technical-content-structure]], for numbered walkthroughs [[tutorial-writing]].
SKILL.md
6.5 KB, as published. Nobody here has run it
SEO + AEO standards for a technical blog post
The findability half of writing a post: will search rank it, and can an AI answer engine (ChatGPT, Perplexity, Google AI Overviews) quote it? Pairs with [[technical-content-structure]] (readability) and [[tutorial-writing]] (numbered walkthroughs).
Two kinds of rules — keep them apart when you report:
- Editorial — craft choices (length, voice). Fine for UX, NOT ranking rules.
- SEO facts — verified against Google Search Central + Ahrefs/Backlinko/Moz (2025-2026).
The numbers that matter
| Field | The 2026 number | Why |
|---|---|---|
| Post length | No SEO target | Google doesn't rank on word count — length is a readability choice, not a ranking factor. |
| Title | ~50-60 characters | Google truncates the title link at ~600 px; longer titles get cut off in results. |
| Meta description | ~155-160 chars (~120 mobile) | The snippet truncates past that; the rest never shows. |
Title (the H1 + browser/tab title)
- ~50-60 characters — the safe zone before Google's ~600 px truncation.
- Front-load the primary keyword — the phrase a reader types. One primary + a natural secondary is plenty; don't stuff 2-5 keywords. Keyword-in-title is a "ticket to entry," not a boost, and stuffing reads as spam.
- Match the title to the actual format. A conceptual headline on a hands-on walkthrough is a scope mismatch — searchers and AI won't connect it to the direct query. If the body is a walkthrough, say so in the H1; save the clever framing for the lede.
- Write for the click, and keep every title unique. Positive framing out-clicks clickbait.
Meta description (the search + social snippet)
This ONE field usually feeds the search snippet, the social card, AND the post card — it's what a person reads in Google before clicking.
- ~155-160 characters (~120 mobile). Past that it's truncated.
- It must accurately summarize the page. "It doesn't need to be in the article" is a clickbait trap — a mismatch tanks dwell time and trust. Describe what's genuinely there.
- Phrase it as the reader's search — state the concrete outcome, not just the topic. Google bolds matching query terms, so natural keywords help CTR. Not a ranking factor; a click factor.
- Keywords that belong to the topic but didn't fit the title can live here — if the post covers them.
Structure & headings
- One H1 (the title), then H2 → H3, never skip a level. Body sections start at H2 (the title is the only H1). A H3-led post skips H2 → breaks WCAG 1.3.1 + the table of contents.
- Land the primary keyword in at least one H2, not only the H1 — a common gap. Section headers double as topic signals for search and AI section-identification.
- Descriptive, standalone headings ("Handling the timeout error"), not bare "Step 1" — readers skim headings first.
- Lead each section with the answer. Buried answers don't win featured snippets or get quoted.
Images & code
- Explain what an image/code block shows BEFORE you show it — inverted-pyramid; the reader knows what they're looking at and AI reads the lead-in prose for context.
- Descriptive alt text on every meaningful image (WCAG 1.1.1 + image search) — describe what's IN it ("the settings page with the API-key field highlighted"), don't keyword-stuff; empty alt for purely decorative images.
- Optimize the file: descriptive filename (
user-settings.png, notDSC_4536.png), compressed, explicit dimensions (avoids layout shift), lazy-load offscreen images.
Modern additions (what the classic checklist missed)
- E-E-A-T — show a real author. Google asks "is it self-evident who wrote this?" Set a per-post author byline + Article JSON-LD. First-hand experience — your own screenshots, "I hit this error and fixed it" — is what AI can't fabricate and E-E-A-T rewards. State first-party authority in one first-person sentence near the top when you built/operate the thing.
- Match search intent. Check what already ranks for the query — an opinion piece won't win a slot the top results fill with tutorials, however clean the on-page SEO.
- Internal links, descriptive anchors. Link related posts; anchor text that names the destination ("the setup guide"), never "click here" / "read more" (Google flags them; useless to screen readers). ~2-4 internal links per 1,000 words.
- AEO. Structure for extraction: question-shaped H2s, a direct answer first, standalone quotable sentences, one extractable "X is Y that does Z" definition in the first 100 words for any named concept, and a FAQs block.
- Structured data. Emit
Article+BreadcrumbList(andFAQPage) JSON-LD — keepauthor,pubDate,updatedDateaccurate because they feed it. (Google dropped the FAQ rich result in 2026, but the visible FAQ text still helps AI + non-Google engines.) - URL slug: short, human-readable, hyphenated, keyword-bearing. Keep it stable once published — changing it 404s the old URL and drops its link equity.
- Freshness: for version-/time-sensitive posts, make substantive updates then bump the modified date — a real update, not a cosmetic date change.
How to apply
- New post: use this while drafting — title length, description length + accuracy, keyword in an H2, explain-before-show.
- Reviewing: read the post, then report findings grouped Editorial vs SEO facts. Flag: title > 60 chars, description > 160 or not reflecting the body, H3-led sections, empty alt, "click here" links, a missing author byline, an image/code block with no lead-in.
- Verify any change with a build.
Sources
Google Search Central (title link, snippet, helpful-content, images, links, URL-structure); Ahrefs & Backlinko on-page/title studies; Moz; Nielsen Norman Group. Verified 2026 — SEO numbers drift, so re-check before treating any figure as gospel.