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

meta-description — скилл для Claude Code: аудит и написание meta

Скилл для написания, аудита и оптимизации мета-описаний. Пригодится, когда надо собрать сниппет для конкретной страницы, а не переписать шаблон по всему сайту.

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

Что делает meta-description

Скилл владеет правилами для <meta name="description">: что писать, какой длины, как проверять специфичность. Он читает корневой contextus.md, если тот есть, и запрашивает тип страницы, поисковую интенцию, локаль, факты о странице, текущее описание, покрытие текста и описания соседних страниц.

Из правил стоит выделить Swap Test: если описание можно перенести на соседнюю страницу без изменений, оно недостаточно конкретное. Длина трактуется как предупреждение, а не жёсткий лимит, потому что Google обрезает сниппеты под устройство и контекст выдачи. CTA допускается только там, где он уместен по задаче страницы, в юридических и справочных страницах его быть не должно.

Скилл не обещает роста CTR, позиций или трафика: мета-описание не является прямым фактором ранжирования. В выдаче он рекомендует текст описания, предупреждение о длине, обоснование и флаг о расхождении с текстом страницы, если H2 и тело не подтверждают заявленное. Для сквозного цикла метаданных с внедрением и проверкой в проде есть отдельный скилл page-metadata, этот про отдельную страницу.

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

  • Написать мета-описание под конкретную страницу
  • Проверить, не дублирует ли описание соседние страницы
  • Отловить описание, которое нельзя подтвердить текстом страницы
  • Оценить длину описания без жёсткого лимита символов
  • Адаптировать описание под локаль и поисковую интенцию

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

  • Проанализируй мета-описание для этой страницы и предложи вариант
  • Проверь описания соседних страниц на дубли и дай рекомендации
  • Перепиши это мета-описание под испанский рынок, не переводя дословно

Как установить meta-description

1Через Skills CLI (Vercel)

npx skills add kostja94/marketing-skills --skill meta-description -a claude-code
npx skills add kostja94/marketing-skills --skill description -a claude-code

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

~/.claude/skills/description/SKILL.md

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

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

Вопросы о meta-description

Как установить meta-description в Claude Code?

Выполни npx skills add kostja94/marketing-skills --skill meta-description -a claude-code. Скилл попадёт в ~/.claude/skills/description/SKILL.md. Есть и алиас: npx skills add kostja94/marketing-skills --skill description -a claude-code.

Чем meta-description отличается от page-metadata?

meta-description работает с описанием одной страницы: написать, проверить, переписать. page-metadata покрывает весь жизненный цикл метаданных сайта, включая внедрение и проверку в проде.

Есть ли у мета-описания жёсткий лимит длины?

Скилл трактует длину как предупреждение, а не как жёсткий порог. Google не фиксирует лимит и обрезает сниппеты в зависимости от устройства и контекста выдачи. Флаг поднимается, когда описание слишком короткое, чтобы объяснить ценность, или раздуто повторами.

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

SKILL.md · MIT
---
name: meta-description
description: When the user wants to write, audit, or optimize a meta description, SEO description, SERP snippet candidate, duplicate description, description length, or description rewrite issue. For a sitewide metadata lifecycle including implementation and production validation, use page-metadata.
metadata:
  version: 2.0.0
---

# SEO On-Page: Meta Description

Owns writing and review rules for `<meta name="description">`. It is a candidate source for search snippets, not a guarantee of the text Google will display.

## Inputs

Read root `contextus.md` when present. Confirm page type, primary search intent, locale, verified page-specific facts, current description, body coverage, sibling-page descriptions, and the intended next action when one exists.

## Rules

- Write an accurate, useful summary or pitch for the specific page.
- Lead with information that distinguishes this page from sibling pages.
- Use query-relevant language naturally, without a keyword list.
- Length is a warning, not a hard gate. Google has no fixed meta-description length limit and truncates snippets as needed for the device and result context.
- A description may exceed traditional character guidance when it remains concise and useful. Flag descriptions too short to explain value or too long because of filler, repetition, or boilerplate.
- Use a CTA only when it suits the page task. Do not force marketing CTAs into legal, documentation, status, or informational pages.
- Include price, author, date, availability, or compatibility only when present and current on the page.
- Apply the **Swap Test**: if a description can move unchanged to a sibling page, it is not specific enough.
- Localize from the target market's query language and intent; do not translate and truncate.
- Google primarily creates snippets from page content and may show different text for different queries. Ensure the H2/body can substantiate the description's promise.
- Do not claim a fixed CTR, ranking, or traffic increase. A meta description is not a direct ranking control.

## Output

- Recommended description and a non-binding length warning when useful.
- Brief rationale tied to intent and page-specific facts.
- Body-coverage warning if the page cannot substantiate the proposed description.
- Sibling duplication or cannibalization warning when applicable; do not restructure pages.

## Primary reference

- [Google: snippets and meta descriptions](https://developers.google.com/search/docs/appearance/snippet)

## Related Skills

- **page-metadata**, **title-tag**, **heading-structure**
- **localization-strategy**, **translation**, **google-search-console**

© kostja94 · MIT · kostja94/marketing-skills

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

Всё по теме «SEO и GEO» →
meta-tags-optimizer aaron-he-zhu Скилл для работы с метатегами и разметкой выдачи. Репозиторий стал указателем: активная версия переехала в другой набор. CX Codex +1 5 000установок find-keywords calm-north Составляет приоритетный список поисковых запросов для сайта или темы. Помогает оценить сложность фраз, отсеять каннибализацию и распределить интенты. CX Codex +1 7 000установок competitor-analysis every-app Скилл для разбора одного конкурента: ключевые слова, контент, ссылки, слабые места. Собирает данные и готовит отчёт с планом действий. CX Codex +1 6 600установок link-prospecting every-app Ищет доноров ссылок через поисковую выдачу и бэклинки конкурентов, находит контакты авторов и готовит черновики писем. Пригодится для точечного аутрича. CX Codex +1 6 500установок brief calm-north Скилл готовит подробные ТЗ для авторов и SEO-копирайтеров с анализом выдачи, структурой заголовков и требованиями E-E-A-T. CX Codex +1 6 400установок serp-analysis aaron-he-zhu Скилл для анализа выдачи поисковых систем (SERP) и SEO-исследований. Помогает разбирать результаты поиска прямо через команды ассистента. CX Codex +1 4 900установок

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

indie-hacker-strategy Скилл для ИИ-агента, который помогает выстроить маркетинг и рост продукта без внешних инвестиций: первые пользователи, Build in Public, каналы. CX Codex +1 1 200установок xml-sitemap Скилл собирает XML-карту сайта по списку страниц, проверяет её и подсказывает, что делать с lastmod и разбивкой на индекс. CX Codex +1 1 200установок title-tag Скилл для подготовки, аудита и оптимизации HTML-тега title с проверкой на каннибализацию и согласованность с H1. CX Codex +1 1 200установок shipping-page-generator Скилл-заглушка для генерации страницы Shipping Policy. Сама страница теперь живёт в другом скилле — page-builder из Pagina. CX Codex +1 1 200установок refund-page-generator Устаревшая заглушка совместимости для генерации страниц условий возврата. Перенаправляет на новый скилл page-builder из Pagina. CX Codex +1 1 200установок paid-ads-strategy Помогает спланировать платное продвижение: выбрать каналы, распределить бюджет и понять, когда реклама вообще уместна. CX Codex +1 1 200установок link-building Скилл ведёт стратегию ссылочного: где брать бэклинки, как писать аутрич и что считать. Пригодится, когда сайт уже есть, а ссылок на него нет. CX Codex +1 1 200установок open-graph Скилл настраивает и проверяет теги Open Graph для превью в соцсетях. Помогает подготовить разметку страниц в HTML или Next.js App Router. CX Codex +1 1 200установок

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

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