feat: add ai-seo and ai-geo plugins (v2.4.0)

- ai-seo v1.0.0: modern SEO audit with /seo-audit, /seo-fix, /seo-schema
- ai-geo v1.0.0: Generative Engine Optimization with /geo-audit, /geo-fix, /geo-llms-txt

Author: charlesjones-dev

.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "A curated list of custom Claude Code plugins, agents, and skills for developers.",
-    "version": "2.3.4",
+    "version": "2.4.0",
     "pluginRoot": "./plugins"
   },
   "plugins": [
@@ -294,6 +294,61 @@
         "url": "https://charlesjones.dev"
       },
       "repository": "https://github.com/charlesjones-dev/claude-code-plugins-dev"
+    },
+    {
+      "name": "ai-seo",
+      "source": "./plugins/ai-seo",
+      "description": "AI-powered modern SEO auditing and remediation - Identifies outdated SEO practices (deprecated keywords meta tags, IE-era patterns), validates modern best practices (Core Web Vitals, structured data, semantic HTML), and provides framework-specific remediation with Context7 MCP integration for up-to-date guidance",
+      "version": "1.0.0",
+      "keywords": [
+        "ai",
+        "seo",
+        "web",
+        "accessibility",
+        "performance",
+        "audit",
+        "meta-tags",
+        "structured-data",
+        "json-ld",
+        "schema-org",
+        "open-graph",
+        "core-web-vitals",
+        "semantic-html",
+        "skills"
+      ],
+      "author": {
+        "name": "Charles Jones",
+        "url": "https://charlesjones.dev"
+      },
+      "repository": "https://github.com/charlesjones-dev/claude-code-plugins-dev"
+    },
+    {
+      "name": "ai-geo",
+      "source": "./plugins/ai-geo",
+      "description": "Generative Engine Optimization (GEO) auditing and remediation. Optimizes web content for AI answer engines like ChatGPT, Perplexity, Claude, and Google AI Overviews. Generates llms.txt files, audits AI crawler access, validates citation-worthiness signals, and structures content for LLM extraction.",
+      "version": "1.0.0",
+      "keywords": [
+        "geo",
+        "ai-seo",
+        "llms-txt",
+        "generative-engine-optimization",
+        "ai-crawlers",
+        "citation-optimization",
+        "answer-engines",
+        "content-optimization",
+        "chatgpt",
+        "perplexity",
+        "claude",
+        "gemini",
+        "schema-org",
+        "structured-data",
+        "skills"
+      ],
+      "author": {
+        "name": "Charles Jones",
+        "url": "https://charlesjones.dev"
+      },
+      "repository": "https://github.com/charlesjones-dev/claude-code-plugins-dev"
     }
   ]
 }

CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.4.0] - 2026-04-17
+
+### Added
+
+#### AI-GEO Plugin (v1.0.0) — New plugin
+
+- `/geo-audit` — Comprehensive Generative Engine Optimization audit across 10 weighted categories (llms.txt Protocol, AI Crawler Access, Content Structure, Citation-Worthiness, AI-Friendly Structured Data, Semantic Chunking, Content Freshness, Entity Optimization, Conversational Alignment, Technical AI Accessibility)
+  - Auto-detects framework (Next.js, Nuxt, TanStack Start, Astro, SvelteKit, Remix, vanilla HTML) and emits framework-idiomatic guidance (static/SSR preference, markdown-accessible routes, modified-time propagation)
+  - Parses `robots.txt` and distinguishes training crawlers (GPTBot, ClaudeBot, Google-Extended, CCBot, Applebot-Extended, Bytespider, Amazonbot, FacebookBot, Omgilibot) from answer/citation crawlers (ChatGPT-User, OAI-SearchBot, PerplexityBot, Perplexity-User, Claude-Web) — reports per-bot status and flags inconsistent patterns rather than prescribing a blanket policy
+  - Validates `llms.txt` and `llms-full.txt` against the llmstxt.org spec (H1 title, blockquote description, markdown throughout, `.md`-companion preference, staleness vs content mtime)
+  - Citation-readiness score 0-100 with grade (A+ through F) and per-category weighted scoring
+  - Experimental 🧪 markers for emerging practices (speakable specification, DefinedTerm, ClaimReview, markdown companion routes) so users can apply judgment
+  - Context7 MCP integration for up-to-date llms.txt spec, AI bot docs (OpenAI, Anthropic, Google, Perplexity), and latest Schema.org types; falls back to training data with explicit mode indicator and liberal 🧪 flagging
+  - Timestamped reports in `/docs/geo-audit/` preserve history (never overwrites); generates `README.md` index with trend indicators (📈 📉 ➡️) and `latest.md` copy
+- `/geo-fix` — Safe remediation workflow that reads `latest.md` and applies fixes in four tiers: safe-auto (add `dateModified` + `article:modified_time`, migrate microdata/RDFa to JSON-LD, wrap existing Q&A prose with FAQPage schema), intent-requiring (separate training-bot and citation-bot prompts before modifying `robots.txt`; emits framework-idiomatic output like `app/robots.ts` for Next.js), content-requiring (prompts for `sameAs` URLs, TL;DR copy, FAQ extraction — never fabricates identity URLs), larger refactors (SSR migration, paragraph restructuring, conversational heading rewording). Supports `--dry-run`.
+- `/geo-llms-txt` — Generate, update, or validate `llms.txt` and `llms-full.txt`. Four modes (generate/update/validate/full-text companion). Framework-aware placement (`public/llms.txt` or route handlers for Next.js, Nuxt, Astro, SvelteKit, TanStack Start, Remix, vanilla). Validation covers spec compliance, link reachability, `.md`-companion opportunities, file size, and staleness vs content source mtime. Suggests markdown companion routes (`.md` suffix) as the single biggest post-llms.txt citation-quality improvement.
+- LLM knowledge-gap corrections baked into every skill prompt: GEO is not SEO; distinguish training bots from citation bots (never blanket-block); `llms.txt` is a real emerging standard; AI engines prefer markdown; FAQPage and HowTo schemas are disproportionately cited; recency matters more than for traditional SEO; SSR/static is critical (many AI crawlers don't execute JS); entity `sameAs` disambiguation is high-value (Wikipedia/Wikidata, LinkedIn, GitHub, Crunchbase, ORCID); never cloak or serve different content to AI bots; mark emerging practices with 🧪; never fabricate `sameAs` URLs
+- Cross-references the companion `ai-seo` plugin — `ai-geo` reports direct users to `/seo-audit` for traditional search coverage; overlap areas (structured data, semantic HTML, authoritativeness signals) are cross-referenced rather than duplicated
+
+#### AI-SEO Plugin (v1.0.0) — New plugin
+
+- `/seo-audit` — Comprehensive modern SEO audit across 9 weighted categories (deprecated patterns, modern meta tags, semantic HTML, structured data, performance signals, accessibility, URL structure, security headers, framework best practices)
+  - Auto-detects framework (Next.js, Nuxt, TanStack Start, Astro, SvelteKit, Remix, vanilla HTML) and emits framework-idiomatic guidance
+  - Context7 MCP integration for up-to-date Google Search Central, Schema.org, and framework SEO API docs; falls back to training data with explicit mode indicator
+  - Timestamped reports in `/docs/seo-audit/` preserve history (never overwrites); generates `README.md` index with trend indicators (📈 📉 ➡️) and `latest.md` copy
+  - Per-category 0-100 scores and overall grade (A+ through F)
+- `/seo-fix` — Safe remediation workflow that reads `latest.md` and applies fixes in three tiers: safe-auto (deprecated tag removal, `rel="noopener noreferrer"`, `loading="lazy"`, lang/viewport/charset), content-requiring (proposes meta descriptions/titles with confirm-or-edit), larger refactors (div-soup → semantic HTML5). Supports `--dry-run`.
+- `/seo-schema` — JSON-LD structured data generator and validator for Article, BlogPosting, Product, Organization, LocalBusiness, FAQPage, BreadcrumbList, Event, HowTo, Recipe, VideoObject, Person, Course, JobPosting, and composite `@graph` structures. Emits framework-idiomatic injection code.
+- LLM knowledge-gap corrections baked into every skill prompt: never generate `<meta name="keywords">` (deprecated 2009, Bing spam signal), never recommend X-UA-Compatible, IE conditionals, jQuery, `float` layouts, `<b>`/`<i>` for emphasis, XHTML doctype, FID optimization (replaced by INP March 2024), or separate mobile subdomains; always prefer JSON-LD over microdata/RDFa
+
 ## [2.3.4] - 2026-04-06
 
 ### Added
@@ -972,7 +1002,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - README.md, CLAUDE.md, individual plugin READMEs, and MIT license
 
-[Unreleased]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v2.2.2...HEAD
+[Unreleased]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v2.4.0...HEAD
+[2.4.0]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v2.3.4...v2.4.0
 [2.2.2]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v2.2.1...v2.2.2
 [2.2.1]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v2.2.0...v2.2.1
 [2.2.0]: https://github.com/charlesjones-dev/claude-code-plugins-dev/compare/v2.1.0...v2.2.0

README.md

@@ -1,6 +1,6 @@
 # Claude Code Plugins for Developers
 
-[![Version](https://img.shields.io/badge/version-2.3.4-blue.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/releases)
+[![Version](https://img.shields.io/badge/version-2.4.0-blue.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/releases)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![GitHub Issues](https://img.shields.io/github/issues/charlesjones-dev/claude-code-plugins-dev.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/issues)
 [![GitHub Stars](https://img.shields.io/github/stars/charlesjones-dev/claude-code-plugins-dev.svg)](https://github.com/charlesjones-dev/claude-code-plugins-dev/stargazers)
@@ -29,6 +29,8 @@ This Claude Code plugin marketplace provides plugins that extend Claude Code's c
 | [ai-compliance](plugins/ai-compliance/) | AI-powered license compliance auditing and attribution generation | `/compliance-license-audit`, `/compliance-notice-generate` | - |
 | [ai-knowledge](plugins/ai-knowledge/) | AI-powered knowledge base management with Obsidian compatibility | `/kb-init`, `/kb-learn`, `/kb-add`, `/kb-query`, `/kb-import`, `/kb-ingest`, `/kb-harvest`, `/kb-discover`, `/kb-absorb`, `/kb-remove`, `/kb-load`, `/kb-list`, `/kb-search`, `/kb-prune`, `/kb-auto`, `/kb-organize`, `/kb-upgrade` | - |
 | [ai-modernize](plugins/ai-modernize/) | AI-powered codebase modernization assessment for technical debt | `/modernize-audit`, `/modernize-scan` | `modernize-auditor` |
+| [ai-seo](plugins/ai-seo/) | AI-powered modern SEO auditing that catches deprecated patterns LLMs still generate | `/seo-audit`, `/seo-fix`, `/seo-schema` | - |
+| [ai-geo](plugins/ai-geo/) | Generative Engine Optimization (GEO) for AI answer engines — llms.txt, AI crawler policy, citation-worthiness | `/geo-audit`, `/geo-fix`, `/geo-llms-txt` | - |
 | [ai-writing](plugins/ai-writing/) | AI-powered writing quality tools for natural-sounding text | `/writing-humanize` | - |
 
 > **📝 Note on Audit Plugins:** The `ai-accessibility`, `ai-security`, and `ai-performance` plugins are developer-focused analysis tools designed to identify issues during development. They perform static code analysis, with `ai-accessibility` and `ai-security` also offering URL scanning capabilities (`/accessibility-audit` with Playwright MCP and `/security-scan-dependencies` respectively). These plugins are meant to **complement** (not replace) runtime testing tools, professional services, and manual testing. Use these plugins to catch issues early in the development phase, then validate with specialized testing tools and services appropriate to your domain.

plugins/ai-geo/.claude-plugin/plugin.json

@@ -0,0 +1,28 @@
+{
+  "name": "ai-geo",
+  "version": "1.0.0",
+  "description": "Generative Engine Optimization (GEO) auditing and remediation. Optimizes web content for AI answer engines like ChatGPT, Perplexity, Claude, and Google AI Overviews. Generates llms.txt files, audits AI crawler access, validates citation-worthiness signals, and structures content for LLM extraction.",
+  "author": {
+    "name": "Charles Jones",
+    "url": "https://charlesjones.dev"
+  },
+  "repository": "https://github.com/charlesjones-dev/claude-code-plugins-dev",
+  "license": "MIT",
+  "keywords": [
+    "geo",
+    "ai-seo",
+    "llms-txt",
+    "generative-engine-optimization",
+    "ai-crawlers",
+    "citation-optimization",
+    "answer-engines",
+    "content-optimization",
+    "chatgpt",
+    "perplexity",
+    "claude",
+    "gemini",
+    "schema-org",
+    "structured-data",
+    "skills"
+  ]
+}

plugins/ai-geo/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Charles Jones
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.