К основному содержанию
скилл CX Codex

seo-onpage — скилл для Claude Code: аудит страницы по 8 пунктам

Скилл seo-onpage проверяет одну страницу по восьми направлениям: title, meta description, заголовки, текст, внутренние ссылки, картинки, URL и schema. На выходе — отчёт с правками.

MIT 347 установок ★ 1 107 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add rampstackco/claude-skills --skill seo-onpage -a claude-code
Открыть на GitHub

Что делает seo-onpage

Скилл берёт один URL или черновик и разбирает восемь вещей: title, meta description, структуру заголовков, текст, внутренние ссылки, изображения, slug и Schema.org. По каждому пункту ставит Pass, Needs work или Fail и называет конкретную правку. Стек не важен: CMS, фреймворк, статическая сборка.

Порядок работы: сначала подтверждает целевой запрос, потом смотрит отрендеренную страницу и её HTML, потом раскладывает правки на критичные, важные и косметические. Итог — markdown-файл seo-audit-[page-slug].md в корне проекта, до 1500 слов. Рядом лежат шаблон аудита, чек-лист и памятка по title и meta в references/.

Целевой запрос обязателен: без него скилл отправляет сначала прогнать seo-keyword. Страницу под noindex он оптимизировать не станет — там нужен seo-technical, потому что переписанные заголовки такую страницу в выдачу не вернут.

Какие задачи решает

  • собрать отчёт по одной странице в восемь блоков
  • переписать title и meta description под целевой запрос
  • найти два H1 и пропущенные уровни заголовков
  • проверить alt у картинок и имена файлов
  • разложить правки на критичные и косметические

Примеры запросов агенту

  • Проведи аудит страницы по восьми параметрам, целевой запрос: купить кофемолку
  • Перепиши title и meta description у страницы услуги, главный запрос: монтаж кондиционера
  • Проверь заголовки и внутренние ссылки на этой странице, отчёт сохрани в seo-audit-[page-slug].md

Как установить seo-onpage

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/seo-onpage/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о seo-onpage

Как установить seo-onpage в Claude Code?

Выполните npx skills add rampstackco/claude-skills --skill seo-onpage -a claude-code. Файл скилла появится по пути ~/.claude/skills/seo-onpage/SKILL.md.

Что делает seo-onpage?

Прогоняет одну страницу по восьми направлениям on-page SEO, ставит оценку каждому и выдаёт markdown-отчёт с приоритетами правок.

Что нужно подготовить перед запуском?

URL страницы или черновик текста, один целевой запрос и роль страницы: коммерческая, информационная или навигационная. Если запрос не назван, скилл попросит сначала пройти seo-keyword.

Исходный текст

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

Похожие скиллы

Все скиллы по теме «SEO и GEO» →
seo-optimizer davila7 Скилл seo-optimizer помогает готовить метатеги, разметку Schema.org и планы статей под поисковые системы прямо в кодовой базе проекта. CX Codex +1 11 415установок seo-technical-optimization Seth Hobson Плагин seo-technical-optimization для Claude Code помогает оптимизировать сайт под поисковики: мета-теги, ключевые слова, структура страниц, разметка для сниппетов. Нужен при настройке технической части SEO в проекте. CX Codex ★ 42 780звёзд репо claude-seo AgriciDaniel Плагин для Claude, который прогоняет полный SEO-аудит сайта и выдаёт план правок по приоритету. ★ 31 421звёзд репо ultimate-seo-geo mykpono Плагин ultimate-seo-geo для Claude Code проверяет сайт и готовит план улучшений для SEO и видимости в поиске с ИИ. Запускает аудит по запросу сайта или задачи с органическим поиском. ★ 105звёзд репо serp-markup-builder aaron-he-zhu Скилл serp-markup-builder собирает содержимое <head>: варианты title и description, блок Open Graph и Twitter Card, валидный JSON-LD под расширенные сниппеты. CX Codex +1 1 600установок seo-geo ReScienceLab Скилл seo-geo проверяет техническое SEO, подбирает ключевые слова и готовит разметку JSON-LD, чтобы страницы цитировали поисковики и ИИ-ответы. CX Codex +1 57 400установок

Из того же набора102

Весь набор →
accessibility-audit Скилл accessibility-audit проводит аудит доступности интерфейса по стандарту WCAG 2.1 AA и формирует план исправления ошибок. Пригодится перед релизом и при подготовке к проверкам ADA или Section 508. CX Codex +1 364установок information-architecture Скилл information-architecture проектирует структуру сайта или продукта: карту страниц, навигацию, URL, типы контента и таксономию. Нужен при создании и перестройке IA. CX Codex +1 354установок creative-brief Скилл creative-brief для Claude Code превращает смутную идею в конкретный брифинг. Задаёт вопросы, чтобы выровнять команду и зафиксировать требования до первой строки кода. CX Codex +1 354установок seo-technical Скилл seo-technical проводит технический SEO-аудит: краулинг, индексация, рендеринг, архитектура, структурированные данные, Core Web Vitals, безопасность и мультиязычность. CX Codex +1 347установок quiz-and-assessment-design Скилл quiz-and-assessment-design для Claude Code проектирует квизы и оценки, распределяет людей по категориям и связывает результат с рекомендацией. Используется для лид-магнитов и диагностики. CX Codex +1 345установок multi-step-form-design Скилл multi-step-form-design помогает спроектировать многошаговые формы с прогрессом, условной логикой и сохранением заполнения. Нужен при аудите длинной формы или запуске новой. CX Codex +1 338установок qa-testing Скилл qa-testing трёхуровневого тестирования веб-страниц через консоль браузера перед запуском или сразу после деплоя. CX Codex +1 335установок editorial-qa Скилл editorial-qa проверяет контент перед публикацией: бриф, факты, голос бренда, структуру, SEO и признаки AI-текста. Подходит для одиночных материалов и серий. CX Codex +1 333установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой