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

seo · tech-leads-club — скилл для Claude Code: что делает и как установить

Скилл для Claude Code прогоняет сайт по чек-листу технического и on-page SEO: обход, canonical, sitemap, метатеги, разметка JSON-LD. Устраняет проблемы с индексацией и кривыми сниппетами в выдаче.

MIT ★ 7 191 обновлён 2026-10-24

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

Что делает seo

Скилл seo ведёт агента по технической и on-page оптимизации сайта. Основа — аудиты Lighthouse SEO и рекомендации Google Search. Внутри разобраны robots.txt и meta robots, canonical, sitemap.xml, структура URL, HTTPS, title и заголовки, alt у картинок, внутренние ссылки и JSON-LD разметка schema.org.

Устроен как один файл SKILL.md: таблица факторов ранжирования с пометками, что скилл закрывает, а что нет, готовые шаблоны robots.txt и sitemap, HTML-сниппеты для canonical, robots meta и изображений. Ссылочный профиль в таблице отмечен крестиком, так что на внешние ссылки и авторитетность он не влияет. Доступность и скорость загрузки отданы другим скиллам каталога: web-accessibility и core-web-vitals. Просьбу «заодно поправить доступность» он не выполнит.

Ставится одной командой npx skills add tech-leads-club/agent-skills --skill seo -a claude-code, файл ложится в ~/.claude/skills/seo/SKILL.md. Лицензия MIT.

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

  • собрать robots.txt и не закрыть от индексации нужные разделы
  • убрать дубли страниц через canonical
  • проверить лимиты sitemap.xml и разбить его на индекс
  • переписать title и meta description под длину сниппета
  • добавить JSON-LD разметку организации и статей

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

  • Проверь техническое SEO каталога: robots.txt, canonical и sitemap.xml на всех страницах.
  • Добавь JSON-LD разметку Organization на главную и проверь, что она валидна.
  • Исправь title и meta description у карточек товаров, они дублируются.

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

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill seo -a claude-code

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

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

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

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

Вопросы о seo

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

Одной командой: npx skills add tech-leads-club/agent-skills --skill seo -a claude-code. Файл скилла появится в ~/.claude/skills/seo/SKILL.md.

Что делает скилл seo?

Проводит агента по техническому и on-page SEO: обход и индексация, canonical, sitemap, метатеги, заголовки, картинки, внутренние ссылки, JSON-LD.

Чем seo отличается от web-accessibility и core-web-vitals?

Это разные скиллы одного каталога. seo про видимость в поиске, web-accessibility про доступность, core-web-vitals про скорость и page experience — в таблице факторов эта зона отдана именно ему.

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

SKILL.md · MIT
---
name: seo
description: Optimize for search engine visibility and ranking. Use when asked to "improve SEO", "optimize for search", "fix meta tags", "add structured data", "sitemap optimization", or "search engine optimization". Do NOT use for accessibility (use web-accessibility), performance (use core-web-vitals), or comprehensive site audits covering multiple areas (use web-quality-audit).
license: MIT
metadata:
  author: web-quality-skills
  version: '1.0'
---

# SEO optimization

Search engine optimization based on Lighthouse SEO audits and Google Search guidelines. Focus on technical SEO, on-page optimization, and structured data.

## SEO fundamentals

Search ranking factors (approximate influence):

| Factor                            | Influence | This Skill                                         |
| --------------------------------- | --------- | -------------------------------------------------- |
| Content quality & relevance       | ~40%      | Partial (structure)                                |
| Backlinks & authority             | ~25%      | ✗                                                  |
| Technical SEO                     | ~15%      | ✓                                                  |
| Page experience (Core Web Vitals) | ~10%      | See [Core Web Vitals](../core-web-vitals/SKILL.md) |
| On-page SEO                       | ~10%      | ✓                                                  |

---

## Technical SEO

### Crawlability

**robots.txt:**

```text
# /robots.txt
User-agent: *
Allow: /

# Block admin/private areas
Disallow: /admin/
Disallow: /api/
Disallow: /private/

# Don't block resources needed for rendering
# ❌ Disallow: /static/

Sitemap: https://example.com/sitemap.xml
```

**Meta robots:**

```html
<!-- Default: indexable, followable -->
<meta name="robots" content="index, follow" />

<!-- Noindex specific pages -->
<meta name="robots" content="noindex, nofollow" />

<!-- Indexable but don't follow links -->
<meta name="robots" content="index, nofollow" />

<!-- Control snippets -->
<meta name="robots" content="max-snippet:150, max-image-preview:large" />
```

**Canonical URLs:**

```html
<!-- Prevent duplicate content issues -->
<link rel="canonical" href="https://example.com/page" />

<!-- Self-referencing canonical (recommended) -->
<link rel="canonical" href="https://example.com/current-page" />

<!-- For paginated content -->
<link rel="canonical" href="https://example.com/products" />
<!-- Or use rel="prev" / rel="next" for explicit pagination -->
```

### XML sitemap

```xml
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com/</loc>
    <lastmod>2024-01-15</lastmod>
    <changefreq>daily</changefreq>
    <priority>1.0</priority>
  </url>
  <url>
    <loc>https://example.com/products</loc>
    <lastmod>2024-01-14</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>
```

**Sitemap best practices:**

- Maximum 50,000 URLs or 50MB per sitemap
- Use sitemap index for larger sites
- Include only canonical, indexable URLs
- Update `lastmod` when content changes
- Submit to Google Search Console

### URL structure

```
✅ Good URLs:
https://example.com/products/blue-widget
https://example.com/blog/how-to-use-widgets

❌ Poor URLs:
https://example.com/p?id=12345
https://example.com/products/item/category/subcategory/blue-widget-2024-sale-discount
```

**URL guidelines:**

- Use hyphens, not underscores
- Lowercase only
- Keep short (< 75 characters)
- Include target keywords naturally
- Avoid parameters when possible
- Use HTTPS always

### HTTPS & security

```html
<!-- Ensure all resources use HTTPS -->
<img src="https://example.com/image.jpg" />

<!-- Not: -->
<img src="http://example.com/image.jpg" />
```

**Security headers for SEO trust signals:**

```
Strict-Transport-Security: max-age=31536000; includeSubDomains
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
```

---

## On-page SEO

### Title tags

```html
<!-- ❌ Missing or generic -->
<title>Page</title>
<title>Home</title>

<!-- ✅ Descriptive with primary keyword -->
<title>Blue Widgets for Sale | Premium Quality | Example Store</title>
```

**Title tag guidelines:**

- 50-60 characters (Google truncates ~60)
- Primary keyword near the beginning
- Unique for every page
- Brand name at end (unless homepage)
- Action-oriented when appropriate

### Meta descriptions

```html
<!-- ❌ Missing or duplicate -->
<meta name="description" content="" />

<!-- ✅ Compelling and unique -->
<meta
  name="description"
  content="Shop premium blue widgets with free shipping. 30-day returns. Rated 4.9/5 by 10,000+ customers. Order today and save 20%."
/>
```

**Meta description guidelines:**

- 150-160 characters
- Include primary keyword naturally
- Compelling call-to-action
- Unique for every page
- Matches page content

### Heading structure

```html
<!-- ❌ Poor structure -->
<h2>Welcome to Our Store</h2>
<h4>Products</h4>
<h1>Contact Us</h1>

<!-- ✅ Proper hierarchy -->
<h1>Blue Widgets - Premium Quality</h1>
<h2>Product Features</h2>
<h3>Durability</h3>
<h3>Design</h3>
<h2>Customer Reviews</h2>
<h2>Pricing</h2>
```

**Heading guidelines:**

- Single `<h1>` per page (the main topic)
- Logical hierarchy (don't skip levels)
- Include keywords naturally
- Descriptive, not generic

### Image SEO

```html
<!-- ❌ Poor image SEO -->
<img src="IMG_12345.jpg" />

<!-- ✅ Optimized image -->
<img
  src="blue-widget-product-photo.webp"
  alt="Blue widget with chrome finish, side view showing control panel"
  width="800"
  height="600"
  loading="lazy"
/>
```

**Image guidelines:**

- Descriptive filenames with keywords
- Alt text describes the image content
- Compressed and properly sized
- WebP/AVIF with fallbacks
- Lazy load below-fold images

### Internal linking

```html
<!-- ❌ Non-descriptive -->
<a href="/products">Click here</a>
<a href="/widgets">Read more</a>

<!-- ✅ Descriptive anchor text -->
<a href="/products/blue-widgets">Browse our blue widget collection</a>
<a href="/guides/widget-maintenance">Learn how to maintain your widgets</a>
```

**Linking guidelines:**

- Descriptive anchor text with keywords
- Link to relevant internal pages
- Reasonable number of links per page
- Fix broken links promptly
- Use breadcrumbs for hierarchy

---

## Structured data (JSON-LD)

### Organization

```html
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "Example Company",
    "url": "https://example.com",
    "logo": "https://example.com/logo.png",
    "sameAs": ["https://twitter.com/example", "https://linkedin.com/company/example"],
    "contactPoint": {
      "@type": "ContactPoint",
      "telephone": "+1-555-123-4567",
      "contactType": "customer service"
    }
  }
</script>
```

### Article

```html
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "How to Choose the Right Widget",
    "description": "Complete guide to selecting widgets for your needs.",
    "image": "https://example.com/article-image.jpg",
    "author": {
      "@type": "Person",
      "name": "Jane Smith",
      "url": "https://example.com/authors/jane-smith"
    },
    "publisher": {
      "@type": "Organization",
      "name": "Example Blog",
      "logo": {
        "@type": "ImageObject",
        "url": "https://example.com/logo.png"
      }
    },
    "datePublished": "2024-01-15",
    "dateModified": "2024-01-20"
  }
</script>
```

### Product

```html
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Product",
    "name": "Blue Widget Pro",
    "image": "https://example.com/blue-widget.jpg",
    "description": "Premium blue widget with advanced features.",
    "brand": {
      "@type": "Brand",
      "name": "WidgetCo"
    },
    "offers": {
      "@type": "Offer",
      "price": "49.99",
      "priceCurrency": "USD",
      "availability": "https://schema.org/InStock",
      "url": "https://example.com/products/blue-widget"
    },
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "4.8",
      "reviewCount": "1250"
    }
  }
</script>
```

### FAQ

```html
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "What colors are available?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Our widgets come in blue, red, and green."
        }
      },
      {
        "@type": "Question",
        "name": "What is the warranty?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "All widgets include a 2-year warranty."
        }
      }
    ]
  }
</script>
```

### Breadcrumbs

```html
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://example.com"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Products",
        "item": "https://example.com/products"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Blue Widgets",
        "item": "https://example.com/products/blue-widgets"
      }
    ]
  }
</script>
```

### Validation

Test structured data at:

- [Google Rich Results Test](https://search.google.com/test/rich-results)
- [Schema.org Validator](https://validator.schema.org/)

---

## Mobile SEO

### Responsive design

```html
<!-- ❌ Not mobile-friendly -->
<meta name="viewport" content="width=1024" />

<!-- ✅ Responsive viewport -->
<meta name="viewport" content="width=device-width, initial-scale=1" />
```

### Tap targets

```css
/* ❌ Too small for mobile */
.small-link {
  padding: 4px;
  font-size: 12px;
}

/* ✅ Adequate tap target */
.mobile-friendly-link {
  padding: 12px;
  font-size: 16px;
  min-height: 48px;
  min-width: 48px;
}
```

### Font sizes

```css
/* ❌ Too small on mobile */
body {
  font-size: 10px;
}

/* ✅ Readable without zooming */
body {
  font-size: 16px;
  line-height: 1.5;
}
```

---

## International SEO

### Hreflang tags

```html
<!-- For multi-language sites -->
<link rel="alternate" hreflang="en" href="https://example.com/page" />
<link rel="alternate" hreflang="es" href="https://example.com/es/page" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
<link rel="alternate" hreflang="x-default" href="https://example.com/page" />
```

### Language declaration

```html
<html lang="en">
  <!-- or -->
  <html lang="es-MX"></html>
</html>
```

---

## SEO audit checklist

### Critical

- [ ] HTTPS enabled
- [ ] robots.txt allows crawling
- [ ] No `noindex` on important pages
- [ ] Title tags present and unique
- [ ] Single `<h1>` per page

### High priority

- [ ] Meta descriptions present
- [ ] Sitemap submitted
- [ ] Canonical URLs set
- [ ] Mobile-responsive
- [ ] Core Web Vitals passing

### Medium priority

- [ ] Structured data implemented
- [ ] Internal linking strategy
- [ ] Image alt text
- [ ] Descriptive URLs
- [ ] Breadcrumb navigation

### Ongoing

- [ ] Fix crawl errors in Search Console
- [ ] Update sitemap when content changes
- [ ] Monitor ranking changes
- [ ] Check for broken links
- [ ] Review Search Console insights

---

## Tools

| Tool                      | Use                           |
| ------------------------- | ----------------------------- |
| Google Search Console     | Monitor indexing, fix issues  |
| Google PageSpeed Insights | Performance + Core Web Vitals |
| Rich Results Test         | Validate structured data      |
| Lighthouse                | Full SEO audit                |
| Screaming Frog            | Crawl analysis                |

## References

- [Google Search Central](https://developers.google.com/search)
- [Schema.org](https://schema.org/)
- [Core Web Vitals](../core-web-vitals/SKILL.md)
- [Web Quality Audit](../web-quality-audit/SKILL.md)

© web-quality-skills · MIT · tech-leads-club/agent-skills

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

Все скиллы по теме «SEO и GEO» →

Сначала — seo от других авторов.

seo affaan-m Проверяет техническое SEO, разметку и Core Web Vitals, а потом предлагает конкретные правки по страницам. CX Codex +1 6 900установок seo AgriciDaniel Скилл seo запускает аудит сайта, проверку E-E-A-T, разметку Schema.org и оптимизацию под AI-поисковики. Помогает подготовить страницы к выдаче Google и ранжированию в AI Overviews. CX Codex +1 10 500установок seo iannuttall Скилл seo для Claude Code подключает к агенту реальные данные Search Console, веб-аналитики и краулинга сайтов. Запускается при поисковом аудите, падении трафика или проверке индексации страниц. CX Codex +1 34 500установок seo mblode Скилл проверяет техническое SEO, помогает исследовать поисковый спрос и измерять видимость в поиске и ИИ-ответах. Подключайте его для аудита, исправления индексации или подготовки брифа. CX Codex +1 391установок seo a5c-ai Скилл seo настраивает метатеги и карту сайта прямо в коде проекта. Помогает подготовить страницы к поисковой индексации. CX Codex +1 3установок nextjs-seo laguagu Скилл nextjs-seo для Claude Code помогает внедрять SEO в Next.js App Router и проверять уже настроенные страницы. Включается для работы с метаданными, индексацией, структурированными данными и политикой обхода сайта. CX Codex +1 2 600установок seo-local-business jezweb Скилл seo-local-business для Claude Code, Cursor, Codex и других платформ: генерирует полный SEO-пакет для сайтов локального бизнеса — теги <head>, JSON-LD схему LocalBusiness, robots.txt и sitemap.xml. CX Codex +1 1 900установок seo-optimizer ailabs-393 Скилл seo-optimizer для Claude Code проверяет HTML/CSS-страницы на SEO-ошибки, правит мета-теги, разметку и sitemap. Устраняет причины, по которым поисковики игнорируют готовый сайт. CX Codex +1 1 300установок seo-schema AgriciDaniel Скилл seo-schema для Claude Code и Codex извлекает, проверяет и создаёт микроразметку Schema.org в формате JSON-LD. Инструмент сканирует страницу по переданному адресу или размечает сущности с нуля. CX Codex +1 8 200установок blog-seo-check AgriciDaniel Скилл blog-seo-check проверяет готовую статью по SEO-чек-листу и выдаёт список исправлений. Нужен перед публикацией одного поста. CX Codex +1 2 800установок seo-best-practices Mindrally Скилл seo-best-practices задаёт правила поисковой оптимизации для веб-приложений. Помогает настроить метатеги, разметку JSON-LD, рендеринг и показатели Core Web Vitals. CX Codex +1 906установок

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

Весь набор →
mermaid-studio Скилл mermaid-studio для Claude Code и других платформ: создаёт диаграммы Mermaid, проверяет синтаксис и рендерит в SVG, PNG или ASCII. Покрывает архитектуру систем и схемы баз данных. CX Codex +1 344установок perf-lighthouse Скилл perf-lighthouse запускает аудит Lighthouse через консоль или Node API, считывает метрики и настраивает бюджеты производительности. Помогает внедрить проверки скорости в CI и разобрать JSON-отчёты. CX Codex +1 341установок codenavi Скилл codenavi помогает исследовать незнакомый код, точечно вносить правки и сохранять знания о проекте в папку .notebook/. Пригодится при отладке и рефакторинге сложных систем. CX Codex +1 327установок decomposition-planning-roadmap Скилл decomposition-planning-roadmap для Claude Code создаёт план декомпозиции монолита и дорожную карту миграции. Он подключается к задачам по выбору порядка выделения сервисов и отслеживанию работ. CX Codex +1 322установок best-practices Скилл best-practices для Claude Code проверяет веб-код на проблемы безопасности, совместимости с браузерами и качества. Запускается по запросу на аудит или модернизацию кода. CX Codex +1 ★ 7 191звёзд репо js-index-maps Правило js-index-maps заменяет повторные .find() по одному ключу на индекс Map. Оно пригодится при частых поисках в массивах. CX Codex +1 ★ 7 191звёзд репо rendering-hydration-suppress-warning Правило rendering-hydration-suppress-warning гасит предупреждения гидратации там, где сервер и клиент намеренно показывают разное: даты, случайные ID, форматирование по локали. CX Codex +1 ★ 7 191звёзд репо bundle-defer-third-party Правило bundle-defer-third-party запрещает прямо импортировать сторонние трекеры в начальный бандл. Агент оборачивает аналитику и логирование в динамическую загрузку после гидратации. CX Codex +1 ★ 7 191звёзд репо

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

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