on-page-seo-audit

$npx mdskill add Significant-Gravitas/skills-catalog/on-page-seo-audit

Use this when someone asks why a page is not ranking, or before a page goes live.

SKILL.md

.github/skills/on-page-seo-auditView on GitHub ↗
---
name: "on-page-seo-audit"
description: "Audit a page the way a search engine reads it: what it is about, whether that is obvious, and the three fixes worth doing before anything else."
triggers: ["seo audit", "why doesn't this rank", "check this page", "meta description", "title tag", "on-page"]
version: "1"
---

# On-page SEO audit

Use this when someone asks why a page is not ranking, or before a page goes
live.

## Read the page as a machine would

Strip the design away and ask what the page is about using only the title, the
URL, the H1, the first paragraph and the subheads. If those five disagree with
each other, that is the finding — nothing further matters until they agree.

## The checks that pay

Work down this list. Stop when you have three real problems; a list of twenty
never gets actioned.

- **Title** — the phrase near the front, under about 60 characters, and
  different from the H1. A title that reads like a filename is a fix.
- **H1** — one of them, and it says what the page does for the reader.
- **First paragraph** — answers the query, does not warm up to it.
- **Subheads** — scannable alone. If the H2s read as a table of contents that
  makes sense without the body, the page is structured.
- **Internal links** — does anything on the site point here, using words that
  describe the page? An orphan page is a ranking problem disguised as a content
  problem.
- **Meta description** — not a ranking factor; it is the ad. Write it as the
  reason to click, under about 155 characters.
- **Images** — alt text that describes the image, file sizes that do not stall
  the page.
- **One page per intent** — if two pages target the same phrase, they compete.
  Say which one should win and what happens to the other.

## How to report it

Three findings, each with the current state quoted, the fix written out ready to
paste, and one line on why it matters. Then a short list of everything else you
noticed, unranked, so nothing is hidden.

## What not to do

Never guess at traffic, ranking positions or search volume — if the data is not
in front of you, say what you would need. Never recommend a rewrite of a page
that is ranking; find the specific gap instead. Never report a checklist of
passes; the user asked what is wrong.

More from Significant-Gravitas/skills-catalog

SkillDescription
account-health-and-qbrsUse when a support account wobbles or a quarterly business review looms: read the health signals, run the success plan, and prep the review from evidence.
accounts-receivable-follow-upReview open receivables and draft factual, staged payment follow-ups without inventing status or contacting a customer.
ad-copy-variantsWrite ad variants that each test one idea, within platform limits and supported claims.
alex-getting-startedUse on the first conversation with Alex, or whenever their memory has no product preferences yet: learn what the user is building and who for, where specs, roadmap and numbers live, who decides dates and scope, and get them to a first real product deliverable.
alliance-co-commercializationUse when a strategic alliance needs joint selling governance: operating model, joint targeting, steering prep, and milestone accountability.
anika-getting-startedUse on the first conversation with Anika, or whenever their memory has no partnership preferences yet: learn which partners and alliances the user owns, what motion they run, and get one real partner read on screen in the same session.
assure-partner-led-deliveryUse when partners deliver client work in your name: own the in-flight book, run the weekly delivery review, and rescue engagements before clients feel it.
automate-finance-reportingUse to connect a number source, map an export into the finance ledger, or QA a sheet: the column mapping, the dedupe key, the load summary, and the checks that must pass before a read ships.
billing-refunds-and-exceptionsUse when money is on the table: verify the charge, check the policy, and stage a refund or exception draft that stops at the owner's yes.
board-and-investor-metrics-briefPrepare a concise board or investor metrics brief with definitions, sources, comparisons, drivers, risks, and decisions needed.