Skip to content

Open-source SEO, GEO, and marketing skills for AI agents.

Merge pull request #94 from teamdolly506-dev/feat/seo-skills-local-intl-commerce

Yuting Zhong06ad006da431
diff --cc CHANGELOG.md
index c488bed4,261803f8..d7b1a852
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -11,13 -11,43 +11,50 @@@ The format follows [Keep a Changelog](h
---
+ ## [0.25.7] — 2026-06-29
+
+ ### Added — ten new SEO skills (local, international, technical, commerce, off-page)
+
+ Major expansion of the SEO suite. All native skills built to repo conventions
+ (frontmatter triggers, `seo/shared/preamble.md` integration):
+
+ - **`local-seo`** — Local pack / Google Business Profile audit: NAP consistency,
+ GBP completeness, review health, local & service-area pages, `LocalBusiness` schema.
+ - **`hreflang-international`** — Hreflang correctness (return tags, x-default,
+ codes, hreflang↔canonical conflicts) + international URL-structure strategy.
+ - **`sitemap-audit`** — XML sitemap discovery, structural limits, lastmod accuracy,
+ and a URL reality cross-check (non-200 / noindex / canonicalized-away listed).
+ - **`image-seo`** — Alt text, WebP/AVIF, compression, srcset, CLS width/height,
+ lazy-load (incl. lazy-loaded-LCP), image sitemaps, `ImageObject` schema.
+ - **`ecommerce-seo`** — PLP/PDP, faceted-navigation crawl-budget traps, variant
+ canonicals, out-of-stock handling, `Product`/`Offer`/`Review` schema.
+ - **`programmatic-seo`** — Templated pages at scale: demand validation, a
+ uniqueness/value gate, internal-link hubs, indexation mgmt, doorway-page guardrails.
+ - **`competitor-pages`** — Coverage matrix + intent/depth/schema/E-E-A-T comparison
+ vs. top-ranking URLs, producing a brief handable to `content-writer`.
+ - **`sxo`** — Search Experience Optimization: SERP click factors + post-click
+ experience/conversion (above-the-fold intent match, CWV, CTAs, anti-pogo-sticking).
+ - **`seo-drift`** — Baseline + compare to catch regressions (lost rankings,
+ deindexed pages, overwritten titles, flipped noindex/canonical).
+ - **`backlink-audit`** — Off-page audit from the free GSC Links report by default
+ (or a paid Ahrefs/Semrush/DataForSEO export); explicit about data limits.
+
+ All registered in `AGENTS.md`, `.claude-plugin/plugin.json`,
+ `.claude-plugin/marketplace.json`, and `README.md`.
+
+ Skills that would duplicate existing skills were intentionally not added (to avoid
+ skill-routing collisions); the pure paid-data MCP wiring was skipped in favor of
+ `backlink-audit` consuming such data when present.
+
+ ---
+
+## [0.25.7] — 2026-07-14
+
+### Changed
+
+- Updated the public skill catalog to include the GSC-driven content planner and NotFair upgrade skill, and clarified that compatible coding agents can discover the host-agnostic skills through `AGENTS.md`.
+- Brought the local NotFair app documentation in line with the shipped goal lifecycle, Codex account and model UI, platform selection, pull-request workflow, supported npm platform, and lowercase CLI commands.
+- Documented the app's current trust boundaries accurately: Codex runs as trusted unsandboxed local automation, workflow and pull-request limits are behavioral guardrails, and OAuth credentials are not yet encrypted at the application layer.
---
diff --cc README.md
index 5f1067c3,e320d7e0..d8564520
--- a/README.md
+++ b/README.md
@@@ -293,9 -190,19 +293,19 @@@ Your data is preserved — the runtime
| [`seo-page`](seo/seo-page/) | Single-page deep analysis. Focused audit of a specific URL for content quality, structure, and keyword optimization. |
| [`broken-link-checker`](seo/broken-link-checker/) | Scans websites to find and report broken internal and external links (404s/5xx). |
| [`geo-optimizer`](seo/geo-optimizer/) | Generative Engine Optimization (GEO) for AI search engines. Audits content with a 0–100 GEO Score, rewrites for AI citation, and produces per-engine strategy for ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews. |
+ | [`local-seo`](seo/local-seo/) | Local pack / Google Business Profile audit. NAP consistency, GBP completeness, review health, local & service-area pages, and LocalBusiness schema. |
+ | [`hreflang-international`](seo/hreflang-international/) | International / multilingual SEO. Validates hreflang (return tags, x-default, codes), catches hreflang↔canonical conflicts, and reviews URL-structure strategy. |
+ | [`sitemap-audit`](seo/sitemap-audit/) | XML sitemap audit. Discovery, structural limits, lastmod accuracy, and a URL reality cross-check (non-200 / noindex / canonicalized-away listed; indexable pages missing). |
+ | [`image-seo`](seo/image-seo/) | Image SEO audit. Alt text, file names, WebP/AVIF, compression, srcset, CLS width/height, lazy-load, image sitemaps, ImageObject schema. |
+ | [`ecommerce-seo`](seo/ecommerce-seo/) | E-commerce SEO. Category/product pages, faceted-navigation crawl traps, variant canonicals, out-of-stock handling, Product/Offer schema. |
+ | [`programmatic-seo`](seo/programmatic-seo/) | Programmatic / templated pages at scale. Demand validation, uniqueness/value gate, internal linking, indexation management, doorway-page guardrails. |
+ | [`competitor-pages`](seo/competitor-pages/) | Competitor page gap analysis. Coverage matrix, intent/depth/schema comparison vs. top-ranking URLs, and a brief to beat the SERP. |
+ | [`sxo`](seo/sxo/) | Search Experience Optimization. SERP click factors + post-click experience/conversion (intent match, CWV, CTAs, anti-pogo-stick). |
+ | [`seo-drift`](seo/seo-drift/) | SEO drift monitoring. Baseline + compare to catch regressions (lost rankings, deindexed pages, overwritten titles, flipped noindex/canonical). |
+ | [`backlink-audit`](seo/backlink-audit/) | Backlink / off-page audit. Works from the GSC Links report or a paid export; referring domains, anchor text, internal-linking wins, toxic-link verdict. |
| [`setup-cms`](seo/setup-cms/) | Connect WordPress, Strapi, Contentful, or Ghost for automated SEO field audits. |
-### Cross-Model
+#### Cross-Model
| Skill | What it does |
|-------|-------------|