Skip to main content
skill CX Codex

seo-onpage — Claude Code skill: single-page SEO audit, 8 checks

seo-onpage runs one page through eight on-page checks: title, meta description, headings, copy, internal links, images, slug and schema. Returns a prioritised report.

MIT 347 installs ★ 1,107 updated 2026-10-19

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rampstackco/claude-skills --skill seo-onpage -a claude-code
Open on GitHub

What seo-onpage does

Give the skill one URL or a draft. It scores eight areas: title tag, meta description, heading order, body copy, internal links, images, URL slug and Schema.org markup. Each area gets Pass, Needs work or Fail with the exact fix attached. Stack does not matter, whether that is a CMS, a framework or static output.

The run starts by pinning down the target query, then reads the rendered page alongside the served HTML, and finally sorts fixes into critical, important and polish. You get a markdown file at seo-audit-[page-slug].md in the project root, capped at 1500 words. Reference material ships with it: an audit template, a checklist and title/meta patterns.

A target query is required. Without one the skill sends you to seo-keyword first. Pages carrying noindex are a dead end here — reach for seo-technical, since rewritten headings will not pull them into results.

What it helps with

  • audit a landing page across all eight on-page areas
  • rewrite a weak title tag and meta description
  • catch duplicate H1s and skipped heading levels
  • fix alt text and unreadable image file names
  • split fixes into critical and cosmetic buckets

Example prompts for the agent

  • Audit this page against the eight on-page dimensions, target query: standing desk
  • Rewrite the title tag and meta description for the pricing page, main query: pricing plans
  • Check heading structure and internal links here, save the report to seo-audit-[page-slug].md

How to install seo-onpage

1Skills CLI (Vercel)

npx skills add rampstackco/claude-skills --skill seo-onpage -a claude-code

2Manually: put the files in place

~/.claude/skills/seo-onpage/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-onpage/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about seo-onpage

How do I install seo-onpage in Claude Code?

Run npx skills add rampstackco/claude-skills --skill seo-onpage -a claude-code. The skill lands at ~/.claude/skills/seo-onpage/SKILL.md.

What does seo-onpage do?

It audits a single page over eight on-page areas, scores each one and writes a markdown report with fixes grouped by priority.

What should I have ready before running it?

A page URL or draft copy, one target query, and the page role: commercial, informational or navigational. With no query named, the skill asks you to run seo-keyword first.

Source text

SKILL.md · MIT
---
name: seo-onpage
description: "Run a comprehensive on-page SEO audit or optimization pass covering title tags, meta descriptions, header structure, content quality, internal links, image optimization, URL hygiene, and on-page schema. Use this skill whenever the user asks to optimize a page, audit on-page SEO, fix titles or meta tags, review header structure, check internal linking, improve a single URL's search performance, or write SEO-friendly copy. Triggers on on-page SEO, page audit, title tag, meta description, H1, header structure, internal links, image alt, URL slug, page optimization, optimize this page, SEO this page. Also triggers for any single-page review where ranking, click-through, or relevance signal quality is the goal, even if the user does not say 'SEO' explicitly."
category: seo-foundation
catalog_summary: "Single-page audits and optimization across 8 dimensions"
display_order: 1
---

# On-Page SEO

Optimize a single page for search relevance, click-through, and crawler comprehension. Stack-agnostic. Works on any CMS, framework, or static site.

---

## When to use

- Auditing or optimizing a single page (homepage, product page, article, landing page)
- Writing or reviewing title tags and meta descriptions
- Fixing header structure or content hierarchy
- Reviewing internal links from or to a page
- Improving a page's CTR from search results

## When NOT to use

- Site-wide crawl, indexing, or speed issues (use `seo-technical`)
- Keyword research or intent mapping (use `seo-keyword`)
- Competitor SERP analysis (use `seo-competitor`)
- Auditing many pages at once for prune/merge decisions (use `seo-content-audit`)

---

## Required inputs

- The page URL or the draft content if pre-launch
- The primary target query (one phrase the page should rank for)
- The page's role in the site (commercial, informational, navigational)

If the target query is unknown, run `seo-keyword` first or ask the user to name one.

---

## The framework: 8 dimensions

A complete on-page audit covers eight dimensions. Score each as Pass, Needs work, or Fail. Note the specific fix.

### 1. Title tag
- One unique title per URL across the site
- Roughly 50 to 60 characters (longer gets truncated in SERPs)
- Primary query near the front
- Brand at the end if it earns inclusion
- Distinct from the H1 (often very similar, but should not be identical word-for-word)

### 2. Meta description
- One unique description per URL
- Roughly 150 to 160 characters
- Restates the value proposition, not the title
- Includes a soft CTA where natural
- Treats the description as ad copy that earns the click

### 3. Header structure
- Exactly one H1 per page
- H1 contains or paraphrases the primary query
- H2 sections cover the major sub-topics
- H3+ used only when an H2 has genuine sub-points
- No skipped levels (no H2 followed by H4)
- Headers describe sections accurately enough that a reader could navigate by them alone

### 4. Body content
- Opens with the primary user intent answered in the first paragraph
- Covers the topic comprehensively (define your competition's depth, then match or exceed it)
- Includes related entities and supporting concepts naturally
- Avoids keyword stuffing (write for the reader, not the bot)
- Reading level matches the audience (run a readability check)
- Paragraphs short enough to scan on mobile (3 to 5 lines)

### 5. Internal links
- At least 2 to 3 outbound internal links to closely related pages
- At least 2 to 3 inbound internal links from related pages
- Anchor text is descriptive, not "click here" or "learn more"
- Links to canonical URLs, not redirects
- No broken internal links

### 6. Images and media
- Every meaningful image has descriptive alt text (skip alt for purely decorative images)
- File names are descriptive ("blue-running-shoe.jpg" not "IMG_4032.jpg")
- Modern format used where supported (WebP, AVIF)
- Lazy loading on below-the-fold images
- Width and height attributes set to prevent layout shift

### 7. URL slug
- Lowercase, hyphen-separated
- Includes the primary query naturally (no stuffing)
- Short (under 60 characters where possible)
- No dates unless the page is genuinely time-bound
- No session IDs, tracking parameters, or random hashes
- Matches the site's URL pattern conventions

### 8. On-page schema
- Appropriate Schema.org type for the content (Article, Product, FAQPage, HowTo, Recipe, etc.)
- Required properties filled (review Schema.org docs for the type)
- Validates in Google's Rich Results Test or equivalent
- Matches what is visible on the page (do not lie to crawlers)
- Author and publisher schema linked correctly for content pages

---

## Workflow

1. **Confirm the target query.** If unclear, ask. Do not optimize without one.
2. **Render the page.** View it as a user would. Read the content top to bottom.
3. **View the rendered HTML.** Inspect the actual served markup, not just the visual page. Check `<title>`, `<meta>`, headers, and schema in the source.
4. **Run the 8-dimension framework.** Score each, note specific fixes.
5. **Prioritize.** Group fixes into Critical (broken or missing), Important (suboptimal), and Nice-to-have (polish).
6. **Write the report.** Use the template in [`references/audit-template.md`](references/audit-template.md).
7. **Offer to draft fixes.** If the user wants, draft the new title, meta, headers, or copy directly.

---

## Failure patterns

When you spot one of these, push back before delivering.

- **"Make it more SEO."** Vague. Ask for the target query and what's broken first.
- **"Add the keyword 5 times in the body."** Keyword density is not a real ranking signal. Prioritize relevance and topical depth instead.
- **Optimizing a page that is not crawlable or indexable.** Check `seo-technical` first. No on-page work helps a noindexed page.
- **Optimizing a page with no clear user intent.** A page that does not serve a real query will not rank no matter how well-tagged it is.
- **Targeting the same query as another page on the site.** This is cannibalization. Use `seo-content-audit` to decide which page should rank.

---

## Output format

Default output is a markdown audit at `seo-audit-[page-slug].md` in the project root. Structure:

1. Page summary (URL, target query, role)
2. Score across 8 dimensions
3. Critical fixes
4. Important fixes
5. Nice-to-have polish
6. Drafted replacements (if requested)

Keep audits under 1500 words. If a page needs more detail, link to deeper appendices.

---

## Reference files

- [`references/audit-template.md`](references/audit-template.md) - Fillable audit template, copy and use.
- [`references/onpage-checklist.md`](references/onpage-checklist.md) - Quick-reference checklist for the 8 dimensions.
- [`references/title-and-meta-patterns.md`](references/title-and-meta-patterns.md) - Patterns for writing strong titles and meta descriptions.

© rampstackco · MIT · rampstackco/claude-skills

Similar skills

All skills for SEO and GEO →

From the same set102

The whole set →
accessibility-audit accessibility-audit audits web interfaces against WCAG 2.1 AA standards and builds a prioritized remediation plan. Helps prepare sites for ADA, Section 508, or routine health checks. CX Codex +1 364installs information-architecture The information-architecture skill plans website or product structure: sitemaps, navigation, URLs, content types, and taxonomies. Use it for new IA work or a restructure. CX Codex +1 354installs creative-brief creative-brief turns a vague idea into a concrete brief that a designer or developer can pick up and run with. Use it to lock down scope, audience, and success metrics before the first line of code. CX Codex +1 354installs seo-technical seo-technical runs a technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, Core Web Vitals, security and internationalization. CX Codex +1 347installs quiz-and-assessment-design quiz-and-assessment-design is a Claude Code skill that plans quizzes and assessments, linking outcomes to recommendations. It supports lead magnets and diagnostics. CX Codex +1 345installs multi-step-form-design multi-step-form-design helps plan multi-step forms with progress, conditional fields, and save-and-resume flows. Use it when scoping a new form or reviewing a long one. CX Codex +1 338installs qa-testing qa-testing is a Claude Code skill for three-tier web page checks using browser console snippets, from post-deploy smoke tests to pre-launch QA. CX Codex +1 335installs editorial-qa editorial-qa is a skill that checks content before publication, including briefs, facts, brand voice, structure, SEO, and AI-content signals. It supports one-off pieces and sampling at scale. CX Codex +1 333installs

Project sponsors

Companies that keep this analytics open