Skip to content

Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.

fix(extensions): keep the dataforseo and image-gen mirrors identical

Agrici Daniel37b521789e5d
diff --git a/extensions/banana/agents/seo-image-gen.md b/extensions/banana/agents/seo-image-gen.md
index 6ac0c12..2b47e1a 100644
--- a/extensions/banana/agents/seo-image-gen.md
+++ b/extensions/banana/agents/seo-image-gen.md
@@ -1,6 +1,8 @@
---
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
---
diff --git a/extensions/dataforseo/agents/seo-dataforseo.md b/extensions/dataforseo/agents/seo-dataforseo.md
index b990230..23b3937 100644
--- a/extensions/dataforseo/agents/seo-dataforseo.md
+++ b/extensions/dataforseo/agents/seo-dataforseo.md
@@ -1,6 +1,8 @@
---
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: 35
tools: Read, Write, Glob, Grep, mcp__dataforseo__*
---
diff --git a/extensions/dataforseo/skills/seo-dataforseo/SKILL.md b/extensions/dataforseo/skills/seo-dataforseo/SKILL.md
index 8cd8bd1..d38f408 100644
--- a/extensions/dataforseo/skills/seo-dataforseo/SKILL.md
+++ b/extensions/dataforseo/skills/seo-dataforseo/SKILL.md
@@ -345,7 +345,7 @@ Search business listings for local SEO competitive analysis.
### `/seo dataforseo ai-scrape <query>`
-Scrape what ChatGPT web search returns for a query. ChatGPT visibility check: see which sources ChatGPT cites for your target keywords.
+Scrape what ChatGPT web search returns for a query. ChatGPT visibility check: see which sources ChatGPT cites for your target keywords. Check Google AI Overviews and AI Mode with GSC gen-AI reports when available.
**MCP tools:** `ai_optimization_chat_gpt_scraper`
diff --git a/skills/seo-dataforseo/SKILL.md b/skills/seo-dataforseo/SKILL.md
index d3c4eaf..d38f408 100644
--- a/skills/seo-dataforseo/SKILL.md
+++ b/skills/seo-dataforseo/SKILL.md
@@ -121,7 +121,7 @@ Fetch YouTube search results. Valuable for GEO. YouTube mentions correlate most
### `/seo dataforseo youtube <video_id>`
-Deep analysis of a specific YouTube video: info, comments, and subtitles. Some third-party studies report a 0.737 correlation between YouTube mentions and AI visibility, so treat this as a methodology-dependent GEO signal.
+Deep analysis of a specific YouTube video: info, comments, and subtitles. Treat YouTube mentions as a useful GEO signal, but AI visibility correlations are methodology-dependent.
**MCP tools:** `serp_youtube_video_info_live_advanced`, `serp_youtube_video_comments_live_advanced`, `serp_youtube_video_subtitles_live_advanced`
diff --git a/tests/test_extension_mirrors.py b/tests/test_extension_mirrors.py
new file mode 100644
index 0000000..9f7321c
--- /dev/null
+++ b/tests/test_extension_mirrors.py
@@ -0,0 +1,74 @@
+"""Core copies and extension copies must not drift apart.
+
+The plugin ships the seo-dataforseo and seo-image-gen skills and agents in
+both the core tree and their extension folders. A manual install copies the
+extension files over the core ones (install.sh copies extension skills and
+agents after the core set), so any drift changes behaviour depending on how
+the plugin was installed.
+"""
+
+from pathlib import Path
+
+import pytest
+
+ROOT = Path(__file__).resolve().parents[1]
+
+# Agents must be byte-identical: the installed copy decides the model,
+# maxTurns, tools and prompt.
+AGENT_MIRRORS = [
+ ("agents/seo-dataforseo.md", "extensions/dataforseo/agents/seo-dataforseo.md"),
+ ("agents/seo-image-gen.md", "extensions/banana/agents/seo-image-gen.md"),
+]
+
+# The DataForSEO skill has no install-specific content, so the whole folder
+# (SKILL.md and references) must match.
+DATAFORSEO_CORE = ROOT / "skills/seo-dataforseo"
+DATAFORSEO_EXT = ROOT / "extensions/dataforseo/skills/seo-dataforseo"
+
+# The image-gen skill differs on purpose: the core copy has no scripts and
+# points at the installed Banana MCP, while the extension copy ships
+# presets.py, cost_tracker.py and generate.py and resolves them through
+# ${CLAUDE_SKILL_DIR}. These files may differ; every other reference must not.
+IMAGE_GEN_CORE_REFS = ROOT / "skills/seo-image-gen/references"
+IMAGE_GEN_EXT_REFS = ROOT / "extensions/banana/references"
+IMAGE_GEN_ALLOWED_DIFFERENCES = {
+ "cost-tracking.md",
+ "gemini-models.md",
+ "mcp-tools.md",
+ "prompt-engineering.md",
+ "seo-image-presets.md",
+}
+
+
[email protected]("core, ext", AGENT_MIRRORS)
+def test_agent_mirrors_are_identical(core, ext):
+ assert (ROOT / core).read_bytes() == (ROOT / ext).read_bytes(), (
+ f"{ext} has drifted from {core}; edit both together"
+ )
+
+
+def _files(root: Path) -> set[str]:
+ return {p.relative_to(root).as_posix() for p in root.rglob("*") if p.is_file()}
+
+
+def test_dataforseo_skill_mirror_is_identical():
+ core, ext = _files(DATAFORSEO_CORE), _files(DATAFORSEO_EXT)
+ assert core == ext, f"file sets differ: {sorted(core ^ ext)}"
+ drifted = [
+ name
+ for name in sorted(core)
+ if (DATAFORSEO_CORE / name).read_bytes() != (DATAFORSEO_EXT / name).read_bytes()
+ ]
+ assert not drifted, f"seo-dataforseo copies have drifted: {drifted}"
+
+
+def test_image_gen_references_differ_only_where_documented():
+ core, ext = _files(IMAGE_GEN_CORE_REFS), _files(IMAGE_GEN_EXT_REFS)
+ assert core == ext, f"reference file sets differ: {sorted(core ^ ext)}"
+ drifted = {
+ name
+ for name in core
+ if (IMAGE_GEN_CORE_REFS / name).read_bytes() != (IMAGE_GEN_EXT_REFS / name).read_bytes()
+ }
+ unexpected = drifted - IMAGE_GEN_ALLOWED_DIFFERENCES
+ assert not unexpected, f"undocumented image-gen reference drift: {sorted(unexpected)}"