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

schema · fcakyon — скилл для Claude Code: что делает и как установить

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

MIT ★ 1 216 обновлён 2026-11-09

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install seo-skills@claude-settings
Открыть на GitHub

Что делает schema

Скилл помогает добавлять, исправлять и проверять JSON-LD для статей, товаров, FAQ, хлебных крошек, организаций и локальных компаний. Для нескольких сущностей предлагает использовать один @graph, где объекты связываются через @id.

Внутри есть таблица обязательных свойств, примеры схем в references/schema-examples.md и валидатор scripts/validate_schema.mjs. Команда проверяет JSON, обязательные поля, даты в ISO 8601 и абсолютные URL. Чистый результат валидатора подтверждает синтаксис, но не то, что разметка описывает видимое содержимое страницы.

Скилл также подсказывает, как проверить JSON-LD через Rich Results Test и валидатор schema.org. Он различает ошибки структуры, неподдерживаемые типы расширенных результатов и разметку, которая не соответствует странице.

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

  • выбрать тип JSON-LD для страницы
  • добавить обязательные свойства в разметку
  • найти ошибку в датах и URL
  • проверить готовый JSON-LD перед публикацией
  • разобраться, почему разметка не даёт расширенный результат

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

  • Проверь JSON-LD в article.json и найди отсутствующие обязательные свойства.
  • Создай разметку Product для страницы товара и подставь реальные значения страницы.
  • Разбери, почему этот JSON-LD не даёт расширенный результат, и предложи исправление.

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

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install seo-skills@claude-settings

Команда ставит плагин seo-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill schema -a claude-code

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

~/.claude/skills/schema/SKILL.md

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

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

Вопросы о schema

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

Добавьте маркетплейс командой /plugin marketplace add fcakyon/claude-codex-settings, затем установите плагин командой /plugin install seo-skills@claude-settings.

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

Он помогает создавать и проверять JSON-LD для статей, товаров, FAQ, организаций и других типов страниц. Скилл также разбирает ошибки свойств, форматов значений и доступности расширенного результата.

Почему валидный JSON-LD может не дать расширенный результат?

Тип может не поддерживать расширенный результат, обязательное свойство может быть пропущено, а разметка может описывать то, чего нет на странице. Валидатор проверяет структуру, но не соответствие содержимому страницы.

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

SKILL.md · MIT
---
name: schema
description: "Use when adding, fixing, or reviewing structured data: JSON-LD for articles, products, FAQs, breadcrumbs, organizations, and local businesses, and what to do when markup doesn't earn a rich result."
license: MIT
---

# Schema markup

Structured data tells a search engine what a page is rather than making it rank. Done right it earns a richer result and makes the page easier for an engine to summarize. Done wrong it earns a manual action.

Four rules govern everything below:

- Mark up only what the page visibly shows. Schema describing content a reader can't see is a spam signal, and it's the single most common reason markup gets penalized rather than ignored.
- Use JSON-LD, in a `<script type="application/ld+json">` in the head or at the end of the body. Google recommends it, and it's the only format you can add without touching the page's markup.
- Only claim types and properties the engine actually supports for a rich result. Valid schema.org markup with no supported result does nothing for search, which is fine, but don't promise a rich result it can't produce.
- Validate before it ships, then watch Search Console. Markup that validates can still be wrong about the page.

## Choosing the type

| Type | Use on | Required |
| --- | --- | --- |
| Organization | Homepage, about page | `name`, `url` |
| WebSite | Homepage, to declare a site search | `name`, `url` |
| Article, BlogPosting | Posts and news | `headline`, `image`, `datePublished`, `author` |
| Product | Product pages | `name`, `image`, `offers` |
| SoftwareApplication | App and SaaS pages | `name`, `offers` |
| FAQPage | A page with real questions and answers | `mainEntity` |
| HowTo | Step-by-step instructions | `name`, `step` |
| BreadcrumbList | Any page with breadcrumbs | `itemListElement` |
| LocalBusiness | A location page | `name`, `address` |
| Event | Events and webinars | `name`, `startDate`, `location` |

`references/schema-examples.md` has a complete, valid block for each of these plus a combined `@graph` and a Next.js pattern. `references/required-properties.json` is the same table in the form the bundled validator reads, so adding a type means editing both.

When a page needs several types, prefer one `@graph` array over several separate script tags: entities can then reference each other by `@id` instead of repeating themselves.

## Reviewing existing markup

A fetch of the page shows only server-rendered JSON-LD. CMS SEO plugins commonly inject it client side, so absence in fetched HTML is not absence on the page. Report what the server HTML contained, then send them to the Rich Results Test, which renders JavaScript.

When markup exists but earns nothing, check in this order: a required property missing, a value in the wrong shape (dates must be ISO 8601, URLs absolute, enumerations exact), the type having no rich result to earn, or the markup describing something the page doesn't show.

From this skill directory, run `node scripts/validate_schema.mjs <jsonld-file>` on any block before you hand it over. It parses the JSON, checks each type against the required properties in `references/required-properties.json`, and catches the two value shapes that fail most often: a date that isn't ISO 8601 and a relative URL. It's mechanical, so a clean result means the syntax is right and nothing more.

Then point the user at the Rich Results Test at https://search.google.com/test/rich-results for eligibility, and the schema.org validator at https://validator.schema.org/ for correctness against the vocabulary. Those answer different questions from each other and from the tool, so a block can pass one and fail another. None of the three can tell you whether the markup describes what the page actually shows, which is the accuracy rule above and still yours to check.

## Handing it over

Give the complete block, ready to paste, with the page's real values filled in rather than placeholders. Say where it goes, name any property you had to leave out and why, and note which rich result it makes the page eligible for, with eligible being the honest word. Google decides whether to show one.

## Rich result limits and entity identity

These rules decide whether markup is safe and whether it can earn anything:

- Retired rich results: Google [stopped showing FAQ rich results for every site on May 7, 2026](https://developers.google.com/search/updates) and removed their documentation, after [dropping HowTo results in 2023](https://developers.google.com/search/blog/2023/08/howto-faq-changes) and the [sitelinks search box in November 2024](https://developers.google.com/search/blog/2024/10/sitelinks-search-box). `FAQPage`, `HowTo`, and a `WebSite` `SearchAction` earn nothing in Google Search, so add them only for other consumers and never promise the rich result. `WebSite` with `name` and `url` still sets the [site name](https://developers.google.com/search/docs/appearance/site-names).
- Required properties: Google lists [no required properties for Article](https://developers.google.com/search/docs/appearance/structured-data/article) or Organization, so treat the bundled validator's Article, BlogPosting, and Organization errors as recommendations. [Software apps](https://developers.google.com/search/docs/appearance/structured-data/software-app) need `offers.price` and either `aggregateRating` or `review`, and [events](https://developers.google.com/search/docs/appearance/structured-data/event) need a physical `Place` with an address, since online-only events aren't eligible.
- Inline JSON-LD: `JSON.stringify` doesn't escape `</script>`, so [Next.js recommends](https://nextjs.org/docs/app/guides/json-ld) `JSON.stringify(schema).replace(/</g, "\\u003c")` before `dangerouslySetInnerHTML`.
- Ratings from other sites: Google's review snippet guidelines say [don't aggregate reviews or ratings from other websites](https://developers.google.com/search/docs/appearance/structured-data/review-snippet), so IMDb, Rotten Tomatoes, or app store scores never go into `aggregateRating`. Show them as attributed text instead.
- Organization logo: Google [may show the logo on a purely white background](https://developers.google.com/search/docs/appearance/structured-data/organization), where a white or light-gray wordmark vanishes. Point `logo` at a version that reads on white, at least 112x112 px, at a crawlable URL.
- Profile pages: a [`ProfilePage`](https://developers.google.com/search/docs/appearance/structured-data/profile-page) needs a `mainEntity` Person or Organization with a `name`, or an `alternateName` when no name is available. Google recommends the real name in `name` and social handles in `alternateName`, plus `dateCreated` and `dateModified` on the page, where `dateModified` ideally changes only when a person edits the profile.
- Entity identity: schema.org defines [`sameAs`](https://schema.org/sameAs) as a page that unambiguously identifies the item, such as its Wikipedia page, Wikidata entry, or official website. On a movie or show page, the IMDb title URL does the same job and tells apart remakes that share a name.

## Sources

- Google Search Central, Intro to how structured data works: https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data
- Google Search Central, Structured data general guidelines: https://developers.google.com/search/docs/appearance/structured-data/sd-policies
- Google Search Central, Search gallery of supported result types: https://developers.google.com/search/docs/appearance/structured-data/search-gallery
- schema.org: https://schema.org/

© fcakyon · MIT · fcakyon/claude-codex-settings

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

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

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

schema coreyhaines31 Помогает добавлять и проверять разметку Schema.org в формате JSON-LD. Он разбирает тип страницы, текущую разметку и подходящие поисковые функции Google. CX Codex +1 91 700установок schema-markup OpenClaudia Скилл schema-markup для Claude Code генерирует структурированные данные Schema.org в формате JSON-LD. Он включается по запросам о schema-разметке, rich results и SEO. CX Codex +1 459установок seo-geo ReScienceLab Скилл seo-geo проверяет техническое SEO, подбирает ключевые слова и готовит разметку JSON-LD, чтобы страницы цитировали поисковики и ИИ-ответы. CX Codex +1 57 400установок seo-schema AgriciDaniel Скилл seo-schema для Claude Code и Codex извлекает, проверяет и создаёт микроразметку Schema.org в формате JSON-LD. Инструмент сканирует страницу по переданному адресу или размечает сущности с нуля. CX Codex +1 8 200установок blog-schema AgriciDaniel Скилл blog-schema создаёт граф JSON-LD для статьи блога с привязкой автора и организации. Пригодится при подготовке микроразметки публикаций. CX Codex +1 2 600установок geo-schema geo-seo-claude Скилл geo-schema проверяет разметку JSON-LD, Microdata и RDFa на страницах сайта и генерирует готовые блоки данных под требования поисковых систем и нейросетей. CX Codex +1 1 100установок seo affaan-m Проверяет техническое SEO, разметку и Core Web Vitals, а потом предлагает конкретные правки по страницам. CX Codex +1 6 900установок

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

Весь набор →
list-performance-function-references Правило list-performance-function-references запрещает трансформировать массивы перед передачей в виртуализированные списки. Оно заставляет переносить вычисления внутрь элементов, сохраняя стабильные ссылки на данные. CX Codex +1 ★ 1 216звёзд репо server-hoist-static-io Правило server-hoist-static-io для Claude Code и Codex, которое помогает избежать повторных операций чтения файлов и сетевых запросов. CX Codex +1 ★ 1 216звёзд репо slides Скилл slides собирает PowerPoint-презентации через PptxGenJS с хелперами для вёрстки, рендером в PNG и проверкой на переполнение слайдов. CX Codex +1 ★ 1 216звёзд репо ui-menus Правило ui-menus для Claude Code и Codex, которое переключает кодогенерацию меню с кастомных JS-компонентов на нативные платформенные элементы через zeego. Срабатывает при создании выпадающих списков и контекстных меню. CX Codex +1 ★ 1 216звёзд репо python-guidelines Скилл python-guidelines задаёт правила написания и ревью Python-кода: интеграция в существующий код, запрет на лишние абстракции и единый формат докстрингов. CX Codex +1 ★ 1 216звёзд репо simplify Скилл simplify запускает параллельный разбор свежего diff по четырём направлениям и сразу вносит правки для упрощения кода перед коммитом. CX Codex +1 ★ 1 216звёзд репо navigation-native-navigators Правило navigation-native-navigators для Claude Code направляет выбор навигации в React Native на нативные компоненты. Оно охватывает стеки, вкладки и заголовки экранов. CX Codex +1 ★ 1 216звёзд репо frontend-testing-debugging Скилл frontend-testing-debugging ведёт агента по циклу визуальной отладки: воспроизвести взаимодействие, посмотреть консоль и вёрстку, поправить причину и перезапустить упавший journey. CX Codex +1 ★ 1 216звёзд репо

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

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