feat: v1.6.1 - plugin marketplace compliance and structural refactor

Restructure plugin to comply with Anthropic's official Claude Code plugin
specification for marketplace submission. All skills and agents now use
standard auto-discovery from default directories.

Changes:
- Move seo/ orchestrator to skills/seo/ (standard auto-discovery)
- Copy extension skills (seo-dataforseo, seo-image-gen) to skills/
- Copy extension agents to agents/ (11 total, all auto-discovered)
- Rewrite plugin.json: remove non-standard entry_point and file-path
  arrays, add keywords, rely on directory auto-discovery
- Create .claude-plugin/marketplace.json for marketplace distribution
- Add model: sonnet and maxTurns to all 11 agents
- Convert allowed-tools from YAML arrays to comma-separated strings
- Add license, metadata blocks to all 17 SKILL.md frontmatters
- Update all cross-references (seo/references/ -> skills/seo/references/)
- Update .gitignore for site-specific analysis outputs
- Update CLAUDE.md architecture tree

Install: /plugin marketplace add AgriciDaniel/claude-seo

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: AgriciDaniel

.claude-plugin/marketplace.json

@@ -0,0 +1,24 @@
+{
+  "name": "claude-seo-marketplace",
+  "owner": {
+    "name": "AgriciDaniel",
+    "email": "agricidaniel@users.noreply.github.com"
+  },
+  "metadata": {
+    "description": "SEO analysis tools for Claude Code",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "claude-seo",
+      "source": "./",
+      "description": "Comprehensive SEO analysis skill for Claude Code. Covers technical SEO, content quality (E-E-A-T), schema markup, image optimization, sitemap architecture, AI search optimization (GEO), local SEO, maps intelligence, and strategic planning across all industries.",
+      "homepage": "https://github.com/AgriciDaniel/claude-seo",
+      "repository": "https://github.com/AgriciDaniel/claude-seo",
+      "license": "MIT",
+      "keywords": ["seo", "technical-seo", "e-e-a-t", "schema-markup", "local-seo", "geo", "ai-search"],
+      "category": "seo",
+      "tags": ["seo", "audit", "technical", "content", "schema", "local", "geo"]
+    }
+  ]
+}

.claude-plugin/plugin.json

@@ -1,39 +1,26 @@
 {
   "name": "claude-seo",
-  "version": "1.6.0",
-  "description": "Comprehensive SEO analysis skill for Claude Code. Covers technical SEO, content quality (E-E-A-T), schema markup, image optimization, sitemap architecture, AI search optimization (GEO), local SEO (GBP, citations, reviews, map pack), and strategic planning across all industries.",
-  "author": "AgriciDaniel",
+  "version": "1.6.1",
+  "description": "Comprehensive SEO analysis skill for Claude Code. Covers technical SEO, content quality (E-E-A-T), schema markup, image optimization, sitemap architecture, AI search optimization (GEO), local SEO (GBP, citations, reviews, map pack), maps intelligence, and strategic planning across all industries.",
+  "author": {
+    "name": "AgriciDaniel",
+    "url": "https://github.com/AgriciDaniel"
+  },
   "license": "MIT",
   "homepage": "https://github.com/AgriciDaniel/claude-seo",
-  "entry_point": "seo/SKILL.md",
-  "skills": [
-    "seo/SKILL.md",
-    "skills/seo-audit/SKILL.md",
-    "skills/seo-page/SKILL.md",
-    "skills/seo-technical/SKILL.md",
-    "skills/seo-content/SKILL.md",
-    "skills/seo-schema/SKILL.md",
-    "skills/seo-sitemap/SKILL.md",
-    "skills/seo-images/SKILL.md",
-    "skills/seo-geo/SKILL.md",
-    "skills/seo-plan/SKILL.md",
-    "skills/seo-programmatic/SKILL.md",
-    "skills/seo-competitor-pages/SKILL.md",
-    "skills/seo-hreflang/SKILL.md",
-    "skills/seo-local/SKILL.md",
-    "extensions/dataforseo/skills/seo-dataforseo/SKILL.md",
-    "extensions/banana/skills/seo-image-gen/SKILL.md"
-  ],
-  "agents": [
-    "agents/seo-technical.md",
-    "agents/seo-content.md",
-    "agents/seo-schema.md",
-    "agents/seo-sitemap.md",
-    "agents/seo-performance.md",
-    "agents/seo-visual.md",
-    "agents/seo-geo.md",
-    "agents/seo-local.md",
-    "extensions/dataforseo/agents/seo-dataforseo.md",
-    "extensions/banana/agents/seo-image-gen.md"
+  "repository": "https://github.com/AgriciDaniel/claude-seo",
+  "keywords": [
+    "seo",
+    "technical-seo",
+    "content-quality",
+    "e-e-a-t",
+    "schema-markup",
+    "core-web-vitals",
+    "local-seo",
+    "geo",
+    "ai-search",
+    "sitemap",
+    "image-optimization",
+    "hreflang"
   ]
 }

.gitignore

@@ -85,3 +85,17 @@ Cover Image.jpeg
 seo audit demo.gif
 seo command demo.gif
 .github-audit/
+
+# Site-specific analysis outputs
+LOCAL-SEO-ANALYSIS-*.md
+LOCAL-SEO-ANALYSIS-*.html
+GEO-ANALYSIS-*.md
+MAPS-ANALYSIS-*.md
+RELEASE-*.md
+dirigo-seo-images-review.html
+
+# Site-specific scripts
+indexnow-submit.sh
+
+# Generated site builds
+site/

CLAUDE.md

@@ -4,62 +4,70 @@
 
 This repository contains **Claude SEO**, a Tier 4 Claude Code skill for comprehensive
 SEO analysis across all industries. It follows the Agent Skills open standard and the
-3-layer architecture (directive, orchestration, execution). 13 sub-skills, 8 parallel
-subagents, and an extensible reference system cover technical SEO, content quality,
+3-layer architecture (directive, orchestration, execution). 14 core sub-skills (+ 2
+extensions), 9 core subagents (+ 2 extension agents), and an extensible reference
+system cover technical SEO, content quality,
 schema markup, image optimization, sitemap architecture, AI search optimization,
-and local SEO (GBP, citations, reviews, map pack).
+local SEO (GBP, citations, reviews, map pack), and maps intelligence (geo-grid
+rank tracking, GBP auditing, review intelligence, competitor radius mapping).
 
 ## Architecture
 
 ```
 claude-seo/
   CLAUDE.md                          # Project instructions (this file)
-  .claude-plugin/plugin.json         # Plugin manifest v1.5.0
-  seo/                               # Main orchestrator skill
-    SKILL.md                         # Entry point, routing table, core rules
-    references/                      # On-demand knowledge files
-  scripts/                           # Python execution scripts
-  hooks/                             # Quality gate hooks
-  schema/                            # Schema.org JSON-LD templates
-  skills/                            # 13 specialized sub-skills
-    seo-audit/SKILL.md              # Full site audit with parallel agents
-    seo-page/SKILL.md              # Deep single-page analysis
-    seo-technical/SKILL.md         # Technical SEO (9 categories)
-    seo-content/SKILL.md           # E-E-A-T and content quality
-    seo-schema/SKILL.md            # Schema.org markup detection/generation
-    seo-sitemap/SKILL.md           # XML sitemap analysis/generation
-    seo-images/SKILL.md            # Image optimization analysis
-    seo-geo/SKILL.md               # AI search / GEO optimization
-    seo-local/SKILL.md             # Local SEO (GBP, citations, reviews, map pack)
-    seo-plan/SKILL.md              # Strategic SEO planning
-    seo-programmatic/SKILL.md      # Programmatic SEO at scale
-    seo-competitor-pages/SKILL.md  # Competitor comparison pages
-    seo-hreflang/SKILL.md         # International SEO / hreflang
-  agents/                            # 8 parallel subagents
-    seo-technical.md               # Crawlability, indexability, security
-    seo-content.md                 # E-E-A-T, readability, thin content
-    seo-schema.md                  # Structured data validation
-    seo-sitemap.md                 # Sitemap quality gates
-    seo-performance.md             # Core Web Vitals, page speed
-    seo-visual.md                  # Screenshots, mobile rendering
-    seo-geo.md                     # AI crawler access, GEO, citability
-    seo-local.md                   # GBP, NAP, citations, reviews, local schema
-  extensions/                          # Optional add-on capabilities
-    dataforseo/                    # Live SEO data via DataForSEO MCP
-    banana/                        # AI image generation via Gemini MCP (see github.com/AgriciDaniel/banana-claude)
-  docs/                              # Extended documentation
-    ARCHITECTURE.md                # System design overview
-    COMMANDS.md                    # Full command reference
-    INSTALLATION.md                # Install guide
-    MCP-INTEGRATION.md            # DataForSEO MCP setup
-    TROUBLESHOOTING.md            # Common issues
+  .claude-plugin/
+    plugin.json                    # Plugin manifest (v1.7.0)
+    marketplace.json               # Marketplace catalog for distribution
+  skills/                            # 17 skills (auto-discovered)
+    seo/                           # Main orchestrator skill
+      SKILL.md                     # Entry point, routing table, core rules
+      references/                  # On-demand knowledge files (10 files)
+    seo-audit/SKILL.md            # Full site audit with parallel agents
+    seo-page/SKILL.md            # Deep single-page analysis
+    seo-technical/SKILL.md       # Technical SEO (9 categories)
+    seo-content/SKILL.md         # E-E-A-T and content quality
+    seo-schema/SKILL.md          # Schema.org markup detection/generation
+    seo-sitemap/SKILL.md         # XML sitemap analysis/generation
+    seo-images/SKILL.md          # Image optimization analysis
+    seo-geo/SKILL.md             # AI search / GEO optimization
+    seo-local/SKILL.md           # Local SEO (GBP, citations, reviews, map pack)
+    seo-maps/SKILL.md            # Maps intelligence (geo-grid, GBP audit, reviews, competitors)
+    seo-plan/SKILL.md            # Strategic SEO planning
+    seo-programmatic/SKILL.md    # Programmatic SEO at scale
+    seo-competitor-pages/SKILL.md # Competitor comparison pages
+    seo-hreflang/SKILL.md       # International SEO / hreflang
+    seo-dataforseo/SKILL.md     # Live SEO data via DataForSEO MCP
+    seo-image-gen/              # AI image generation for SEO assets
+      SKILL.md
+      references/                # Image gen reference files (7 files)
+  agents/                          # 11 subagents (auto-discovered)
+    seo-technical.md             # Crawlability, indexability, security
+    seo-content.md               # E-E-A-T, readability, thin content
+    seo-schema.md                # Structured data validation
+    seo-sitemap.md               # Sitemap quality gates
+    seo-performance.md           # Core Web Vitals, page speed
+    seo-visual.md                # Screenshots, mobile rendering
+    seo-geo.md                   # AI crawler access, GEO, citability
+    seo-local.md                 # GBP, NAP, citations, reviews, local schema
+    seo-maps.md                  # Geo-grid, GBP audit, reviews, competitor radius
+    seo-dataforseo.md            # DataForSEO data analyst
+    seo-image-gen.md             # SEO image audit analyst
+  hooks/                           # Quality gate hooks
+    hooks.json                   # PostToolUse schema validation
+  scripts/                         # Python execution scripts
+  schema/                          # Schema.org JSON-LD templates
+  extensions/                      # Optional add-on install helpers
+    dataforseo/                  # DataForSEO MCP install scripts
+    banana/                      # Banana MCP install scripts
+  docs/                            # Extended documentation
 ```
 
 ## Commands
 
 | Command | Purpose |
 |---------|---------|
-| `/seo audit <url>` | Full site audit with 8 parallel subagents |
+| `/seo audit <url>` | Full site audit with 9 parallel subagents |
 | `/seo page <url>` | Deep single-page analysis |
 | `/seo technical <url>` | Technical SEO audit (9 categories) |
 | `/seo content <url>` | E-E-A-T and content quality analysis |
@@ -71,6 +79,7 @@ claude-seo/
 | `/seo programmatic` | Programmatic SEO analysis and planning |
 | `/seo competitor-pages` | Competitor comparison page generation |
 | `/seo local <url>` | Local SEO analysis (GBP, citations, reviews, map pack) |
+| `/seo maps [command] [args]` | Maps intelligence (geo-grid, GBP audit, reviews, competitors) |
 | `/seo hreflang <url>` | International SEO / hreflang audit |
 | `/seo image-gen [use-case] <desc>` | AI image generation for SEO assets (extension) |
 
@@ -80,7 +89,7 @@ claude-seo/
 - Reference files should be focused and under 200 lines
 - Scripts must have docstrings, CLI interface, and JSON output
 - Follow kebab-case naming for all skill directories
-- Agents invoked via Task tool with `context: fork`, never via Bash
+- Agents invoked via Agent tool, never via Bash
 - Python dependencies install into `~/.claude/skills/seo/.venv/`
 - Test with `python -m pytest tests/` after changes (if applicable)
 
@@ -94,5 +103,5 @@ Part of the Claude Code skill family:
 
 1. **Progressive Disclosure**: Metadata always loaded, instructions on activation, resources on demand
 2. **Industry Detection**: Auto-detect SaaS, e-commerce, local, publisher, agency
-3. **Parallel Execution**: Full audits spawn 8 subagents simultaneously
+3. **Parallel Execution**: Full audits spawn up to 11 subagents simultaneously
 4. **Extension System**: DataForSEO MCP for live data, Banana MCP for AI image generation

TODO.md

@@ -60,7 +60,7 @@ Remaining phases (deferred):
 
 - [ ] **Phase 3: Screenshot DOM export** (Priority: Medium):Add `--export-html` flag to `capture_screenshot.py` so rendered DOM is available to other agents without a second browser launch.
 
-- [ ] **Phase 4: Orchestrator SPA detection** (Priority: High):Add 6 SPA detection signals to `seo/SKILL.md` (empty root div, minimal body, prerenderReady, framework markers, large JS bundles, React/Vue/Angular attributes). Route agents to raw vs rendered HTML based on detection result.
+- [ ] **Phase 4: Orchestrator SPA detection** (Priority: High):Add 6 SPA detection signals to `skills/seo/SKILL.md` (empty root div, minimal body, prerenderReady, framework markers, large JS bundles, React/Vue/Angular attributes). Route agents to raw vs rendered HTML based on detection result.
 
 - [ ] **Phase 5: Agent updates** (Priority: High):Update seo-technical, seo-content, seo-schema, seo-performance, seo-visual to use rendered DOM when SPA detected. Add WRS (Web Rendering Service) dependency risk deductions.
 

agents/seo-content.md

@@ -1,6 +1,8 @@
 ---
 name: seo-content
 description: Content quality reviewer. Evaluates E-E-A-T signals, readability, content depth, AI citation readiness, and thin content detection.
+model: sonnet
+maxTurns: 15
 tools: Read, Bash, Write, Grep
 ---
 

agents/seo-dataforseo.md

@@ -0,0 +1,36 @@
+---
+name: seo-dataforseo
+description: DataForSEO data analyst. Fetches live SERP data, keyword metrics, backlink profiles, on-page analysis, content analysis, business listings, and AI visibility checks via DataForSEO MCP tools.
+model: sonnet
+maxTurns: 25
+tools: Read, Bash, Write, Glob, Grep
+---
+
+You are a DataForSEO data analyst. When delegated tasks during an SEO audit or analysis:
+
+1. Check that DataForSEO MCP tools are available before attempting calls
+2. Use the most efficient tool combination for the requested data
+3. Apply default parameters: location_code=2840 (US), language_code=en unless specified
+4. Format output to match claude-seo conventions (tables, priority levels, scores)
+
+## Efficient Tool Usage
+
+- **Prefer bulk endpoints** over multiple single calls to minimize API credits
+- **Don't re-fetch** data already retrieved in the same session
+- **Warn before expensive operations** (full backlink crawls, large keyword lists)
+- **Use limits**: default to limit=100 for list endpoints unless user needs more
+
+## Error Handling
+
+- If a DataForSEO tool returns an error, report the error clearly to the user
+- If credentials are invalid, suggest running the extension installer again
+- If a module is not enabled, note which module is needed
+
+## Output Format
+
+Match existing claude-seo patterns:
+- Tables for comparative data
+- Scores as XX/100
+- Priority: Critical > High > Medium > Low
+- Note data source as "DataForSEO (live)" to distinguish from static HTML analysis
+- Include timestamps for time-sensitive data (SERP positions, backlink counts)

agents/seo-geo.md

@@ -1,6 +1,8 @@
 ---
 name: seo-geo
 description: GEO and AI search specialist. Analyzes AI crawler accessibility, llms.txt compliance, passage-level citability, brand mention signals, and platform-specific optimization for Google AI Overviews, ChatGPT, Perplexity, and Bing Copilot.
+model: sonnet
+maxTurns: 20
 tools: Read, Bash, WebFetch, Glob, Grep
 ---
 

agents/seo-image-gen.md

@@ -0,0 +1,61 @@
+---
+name: seo-image-gen
+description: SEO image analyst. Audits existing OG/social preview images, identifies missing or low-quality images, and creates an image generation plan with prompts for key pages. Does NOT auto-generate images.
+model: sonnet
+maxTurns: 15
+tools: Read, Bash, Glob, Grep
+---
+
+You are an SEO image analyst. When delegated tasks during an SEO audit:
+
+1. Check that nanobanana-mcp tools are available before including generation recommendations
+2. Analyze the site's existing image strategy for SEO impact
+3. Output a structured generation plan. Never auto-generate (cost control)
+
+## Analysis Scope
+
+For each audited page, evaluate:
+- **OG image presence**:Does `og:image` meta tag exist? Is it valid?
+- **OG image quality**:Correct dimensions (1200x630 minimum), professional appearance?
+- **Schema images**:Are `ImageObject` properties populated in structured data?
+- **Alt text quality**:Descriptive, keyword-rich, not stuffed?
+- **Image format**:Using modern formats (WebP, AVIF) vs legacy (PNG, JPEG)?
+- **Image file size**:Under 200KB for hero, under 100KB for thumbnails?
+
+## Output Format
+
+Match existing claude-seo patterns:
+
+### Image Audit Summary
+
+| Metric | Value | Status |
+|--------|-------|--------|
+| Pages with OG images | X/Y | Pass/Fail |
+| OG images correct size | X/Y | Pass/Fail |
+| Schema ImageObject usage | X/Y | Pass/Fail |
+| WebP/AVIF adoption | X% | Pass/Fail |
+| Average image file size | XKB | Pass/Fail |
+
+### Image Generation Plan
+
+For each page missing or having low-quality images:
+
+| Page | Issue | Suggested Use Case | Prompt Idea | Priority |
+|------|-------|-------------------|-------------|----------|
+| /homepage | Missing OG image | og | Professional SaaS dashboard overview | Critical |
+| /blog/post-1 | Low-res hero | hero | [contextual suggestion] | High |
+
+Priority levels: Critical > High > Medium > Low
+
+### Recommendations
+
+- Prioritize pages by traffic volume (highest traffic = fix first)
+- Note estimated cost for full generation plan
+- Suggest batch generation for efficiency
+- Recommend WebP conversion pipeline for all generated assets
+
+## Error Handling
+
+- If nanobanana-mcp is not available, still audit existing images but note that generation requires the banana extension
+- Report errors clearly with actionable next steps
+- Note data source as "Image Audit (static analysis)" to distinguish from live checks

agents/seo-local.md

@@ -1,6 +1,8 @@
 ---
 name: seo-local
 description: Local SEO specialist. Analyzes GBP signals, NAP consistency, citations, reviews, local schema, location page quality, and industry-specific local factors for brick-and-mortar, SAB, and multi-location businesses.
+model: sonnet
+maxTurns: 20
 tools: Read, Bash, WebFetch, Glob, Grep, Write
 ---
 
@@ -51,7 +53,7 @@ You are a Local SEO specialist. When given a URL:
 
 ## Industry-Specific Checks
 
-Load `seo/references/local-schema-types.md` for:
+Load `skills/seo/references/local-schema-types.md` for:
 - Correct schema subtype per vertical (e.g., `Restaurant` not `LocalBusiness`, `LegalService` not deprecated `Attorney`)
 - Industry-specific citation source recommendations
 - Schema pattern templates (Menu for restaurants, Physician for healthcare, etc.)