meta-description — скилл для Claude Code: аудит и написание meta
Скилл для написания, аудита и оптимизации мета-описаний. Пригодится, когда надо собрать сниппет для конкретной страницы, а не переписать шаблон по всему сайту.
npx skills add kostja94/marketing-skills --skill meta-description -a claude-code
npx skills add kostja94/marketing-skills --skill description -a claude-codeЧто делает 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-codenpx skills add kostja94/marketing-skills --skill description -a claude-code2Вручную: положить файлы
~/.claude/skills/description/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/description/
1Через Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill description -a codex2Вручную: положить файлы
.agents/skills/description/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill description -a cursor2Вручную: положить файлы
.cursor/skills/description/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install kostja94/marketing-skills description2Вручную: положить файлы
.github/skills/description/SKILL.md1Через Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill description -a gemini-cli2Командой платформы
gemini skills install https://github.com/kostja94/marketing-skills --path skills/seo/on-page/descriptionВручную: положить файлы
.devin/skills/description/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill description -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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