Skip to content

Advance-Labs/aeo-toolkit / skills/aeo-structured-data-validation

aeo-structured-data-validation

Verified

FileKindSize
SKILL.mdskill md11.7 KB
references/nextjs.mdmarkdown999 B
references/wordpress.mdmarkdown1.7 KB

references/wordpress.md

View on GitHub
# Structured data validation in WordPress

WordPress is the stack where duplicate, conflicting markup is most common.

## Find every emitter
View-source the live page (not the editor) and list each `application/ld+json` block. Typical
sources:

- **Yoast SEO**: one `<script type="application/ld+json" class="yoast-schema-graph">` containing
  a connected `@graph` (Organization/Person, WebSite, WebPage, Article, BreadcrumbList).
- **Rank Math**: its own graph block.
- **Theme**: many themes add Article, Organization, or BreadcrumbList.
- **Schema, review, FAQ and recipe plugins** and page builders: each adds its own.
- **WooCommerce**: emits Product markup, and your SEO plugin may add its own too.

If two sources emit the same type with different data, that is the defect. Two plugins each
producing a complete graph is the classic cause of `aeo.entity-identity-consistent` failing.

## Fix
- Keep the SEO plugin as the single graph emitter, and turn off the theme's and other
  plugins' schema options (most have a toggle). Deactivating a plugin and checking view-source
  is the quickest test of who emits what.
- Extend rather than replace: add missing properties with the plugin's filters (Yoast:
  `wpseo_schema_*`; Rank Math: `rank_math/json_ld`). Replace only when the plugin cannot produce
  the right shape, and then disable its output for that type.
- Caching and optimisation plugins can serve a stale page with old markup; purge after fixing.
- Fields left blank in the editor often produce empty strings in the markup; fill them or
  remove the node.
- Multisite: check each site separately.

## Verify
Use the validator script from the main skill against saved HTML from the live URL, then the Rich
Results Test and Schema Markup Validator on the same URL.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall