everything-seo-cli 1.3.0__tar.gz → 1.4.0__tar.gz

{everything_seo_cli-1.3.0 → everything_seo_cli-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: everything-seo-cli
-Version: 1.3.0
+Version: 1.4.0
 Summary: Universal CLI and progressive skill manager for Everything SEO by Mushfiqur Rahman Aayan & DevCenterPoint
 Author-email: Mushfiqur Rahman Aayan <admin@devcenterpoint.com>, DevCenterPoint <maintainers@devcenterpoint.com>
 Maintainer-email: DevCenterPoint <maintainers@devcenterpoint.com>
@@ -36,10 +36,11 @@ Dynamic: license-file
 <p align="center">
   <a href="https://www.npmjs.com/package/@devcenterpoint/everything-seo"><img src="https://img.shields.io/npm/v/@devcenterpoint/everything-seo.svg?logo=npm&color=CB3837" alt="npm CLI"></a>
   <a href="https://www.npmjs.com/package/@devcenterpoint/mcp-server-seo"><img src="https://img.shields.io/npm/v/@devcenterpoint/mcp-server-seo.svg?logo=npm&label=mcp-server&color=CB3837" alt="npm MCP"></a>
-  <a href="https://pypi.org/project/everything-seo-cli/1.2.1/"><img src="https://img.shields.io/pypi/v/everything-seo-cli.svg?logo=pypi&logoColor=white&color=3775A9" alt="PyPI Package"></a>
-  <a href="https://github.com/beingmushfiq/Everything-SEO/releases/tag/v1.2.1"><img src="https://img.shields.io/badge/release-v1.2.1-10B981.svg?logo=github" alt="Release: v1.2.1"></a>
+  <a href="https://pypi.org/project/everything-seo-cli/"><img src="https://img.shields.io/pypi/v/everything-seo-cli.svg?logo=pypi&logoColor=white&color=3775A9" alt="PyPI Package"></a>
+  <a href="https://github.com/beingmushfiq/Everything-SEO/releases/tag/v1.3.0"><img src="https://img.shields.io/badge/release-v1.3.0-10B981.svg?logo=github" alt="Release: v1.3.0"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
   <a href="SEO/SKILL_INDEX.md"><img src="https://img.shields.io/badge/skills-55%20operational-emerald.svg" alt="55 Operational Skills"></a>
+  <a href="https://github.com/beingmushfiq"><img src="https://img.shields.io/badge/creator-Mushfiqur%20Rahman%20Aayan-F59E0B.svg" alt="Creator: Mushfiqur Rahman Aayan"></a>
   <a href="https://devcenterpoint.com"><img src="https://img.shields.io/badge/maintainer-DevCenterPoint-2563EB.svg" alt="Maintainer: DevCenterPoint"></a>
 </p>
 
@@ -66,9 +67,9 @@ Whether you are using Cursor, Claude Code, Antigravity, or developing custom web
 
 | Package | Registry | Install / Run Command | Capabilities |
 | :--- | :--- | :--- | :--- |
-| **`@devcenterpoint/everything-seo`** | [npm](https://www.npmjs.com/package/@devcenterpoint/everything-seo) | `npx @devcenterpoint/everything-seo init` | Universal CLI, 55 offline skills, presets, Cursor rule generator |
-| **`@devcenterpoint/mcp-server-seo`** | [npm](https://www.npmjs.com/package/@devcenterpoint/mcp-server-seo) | `npx @devcenterpoint/mcp-server-seo` | Official MCP server (JSON-RPC tools, resources, offline schema validator) |
-| **`everything-seo-cli`** | [PyPI](https://pypi.org/project/everything-seo-cli/1.2.1/) | `pip install everything-seo-cli==1.2.1` | Standalone Python CLI, agent adapters & verification tooling |
+| **`@devcenterpoint/everything-seo`** | [npm](https://www.npmjs.com/package/@devcenterpoint/everything-seo) | `npx @devcenterpoint/everything-seo init` | Universal CLI, interactive installer, 55 offline skills, presets, Cursor rules |
+| **`@devcenterpoint/mcp-server-seo`** | [npm](https://www.npmjs.com/package/@devcenterpoint/mcp-server-seo) | `npx @devcenterpoint/mcp-server-seo` | Official MCP server (JSON-RPC tools, resources, forensic triage, validator) |
+| **`everything-seo-cli`** | [PyPI](https://pypi.org/project/everything-seo-cli/) | `pip install everything-seo-cli` | Standalone Python CLI with full 55-skill offline bundle & triage |
 
 ### 1. Global System Installation (Install Once, Available to All Agents)
 Install skills globally so your AI coding agents discover them automatically across all projects:
@@ -91,19 +92,26 @@ irm https://raw.githubusercontent.com/beingmushfiq/Everything-SEO/main/scripts/i
 Add only the specific SEO skills your application requires directly into your project repository. No token bloat, fully customizable, and version-controlled with your code:
 
 ```bash
-# Initialize SEO capabilities in your active project workspace
+# Initialize SEO capabilities (Interactive selection menu by default)
 everything-seo init
 
+# Or deploy the complete fleet of all 55 skills + 56 Cursor rules immediately
+everything-seo init --all
+
+# Run forensic triage on any search issue or GSC error message
+everything-seo triage "crawled currently not indexed"
+everything-seo triage "INP failing on mobile"
+
 # Initialize with a curated domain preset
 everything-seo init --preset nextjs       # Technical Crawling + SSR Schema + Core Web Vitals
 everything-seo init --preset ecommerce    # Product Schema + Faceted Nav + Category Optimization
 everything-seo init --preset saas         # Competitor Pages + AI Citation + B2B Lead Gen
 everything-seo init --preset publisher    # Google News + Entity Coverage + NLP Optimization
 
-# Progressively add individual skills as requirements expand
-everything-seo add technical-seo/indexing
-everything-seo add on-page-seo/schema-markup
-everything-seo add ai-seo/ai-search-visibility
+# Progressively add individual skills anytime (supports natural aliases)
+everything-seo add canonical              # Resolves to Technical SEO/Indexing
+everything-seo add schema                 # Resolves to On-page SEO/Schema Markup
+everything-seo add "ai-search-visibility"
 
 # Scaffold a custom, compliant SEO skill for your company's proprietary rules
 everything-seo scaffold --name custom-internal-routing --category "Technical SEO"
@@ -248,6 +256,7 @@ python -m unittest discover -s tests -p "test_*.py" -v
 ## 📚 Community, Governance & Links
 
 - **Universal Integration & Guides**:
+  - [Master SEO Triage & Routing Guide](docs/SEO_TRIAGE_AND_ROUTING_GUIDE.md)
   - [Universal Agent Integration Guide](docs/UNIVERSAL_AGENT_INTEGRATION_GUIDE.md)
   - [Strategic Roadmap](ROADMAP.md)
   - [SEO-Eval Benchmark Report](docs/EVAL_BENCHMARK_REPORT.md)
@@ -258,6 +267,7 @@ python -m unittest discover -s tests -p "test_*.py" -v
   - [Security Policy](SECURITY.md)
   - [Support & FAQ](FAQ.md)
 - **Project Governance & Release**:
+  - [v1.3.0 Release Notes](docs/RELEASE_NOTES_v1.3.0.md)
   - [v1.2.1 Release Notes](docs/RELEASE_NOTES_v1.2.1.md)
   - [v1.2.0 Release Notes](docs/RELEASE_NOTES_v1.2.0.md)
   - [v1.1.0 Release Notes](docs/RELEASE_NOTES_v1.1.0.md)
@@ -274,6 +284,7 @@ python -m unittest discover -s tests -p "test_*.py" -v
 
 ## ⚖️ License & Attribution
 
+Created & Led by **[Mushfiqur Rahman Aayan (@beingmushfiq)](https://github.com/beingmushfiq)**  
 Maintained with pride by **[DevCenterPoint](https://devcenterpoint.com)** under the **[MIT License](LICENSE)**.  
 Repository: **[`beingmushfiq/Everything-SEO`](https://github.com/beingmushfiq/Everything-SEO)**  
 Built for deterministic, repeatable, and verifiable organic search excellence.

{everything_seo_cli-1.3.0 → everything_seo_cli-1.4.0}/README.md

@@ -12,10 +12,11 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/@devcenterpoint/everything-seo"><img src="https://img.shields.io/npm/v/@devcenterpoint/everything-seo.svg?logo=npm&color=CB3837" alt="npm CLI"></a>
   <a href="https://www.npmjs.com/package/@devcenterpoint/mcp-server-seo"><img src="https://img.shields.io/npm/v/@devcenterpoint/mcp-server-seo.svg?logo=npm&label=mcp-server&color=CB3837" alt="npm MCP"></a>
-  <a href="https://pypi.org/project/everything-seo-cli/1.2.1/"><img src="https://img.shields.io/pypi/v/everything-seo-cli.svg?logo=pypi&logoColor=white&color=3775A9" alt="PyPI Package"></a>
-  <a href="https://github.com/beingmushfiq/Everything-SEO/releases/tag/v1.2.1"><img src="https://img.shields.io/badge/release-v1.2.1-10B981.svg?logo=github" alt="Release: v1.2.1"></a>
+  <a href="https://pypi.org/project/everything-seo-cli/"><img src="https://img.shields.io/pypi/v/everything-seo-cli.svg?logo=pypi&logoColor=white&color=3775A9" alt="PyPI Package"></a>
+  <a href="https://github.com/beingmushfiq/Everything-SEO/releases/tag/v1.3.0"><img src="https://img.shields.io/badge/release-v1.3.0-10B981.svg?logo=github" alt="Release: v1.3.0"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
   <a href="SEO/SKILL_INDEX.md"><img src="https://img.shields.io/badge/skills-55%20operational-emerald.svg" alt="55 Operational Skills"></a>
+  <a href="https://github.com/beingmushfiq"><img src="https://img.shields.io/badge/creator-Mushfiqur%20Rahman%20Aayan-F59E0B.svg" alt="Creator: Mushfiqur Rahman Aayan"></a>
   <a href="https://devcenterpoint.com"><img src="https://img.shields.io/badge/maintainer-DevCenterPoint-2563EB.svg" alt="Maintainer: DevCenterPoint"></a>
 </p>
 
@@ -42,9 +43,9 @@ Whether you are using Cursor, Claude Code, Antigravity, or developing custom web
 
 | Package | Registry | Install / Run Command | Capabilities |
 | :--- | :--- | :--- | :--- |
-| **`@devcenterpoint/everything-seo`** | [npm](https://www.npmjs.com/package/@devcenterpoint/everything-seo) | `npx @devcenterpoint/everything-seo init` | Universal CLI, 55 offline skills, presets, Cursor rule generator |
-| **`@devcenterpoint/mcp-server-seo`** | [npm](https://www.npmjs.com/package/@devcenterpoint/mcp-server-seo) | `npx @devcenterpoint/mcp-server-seo` | Official MCP server (JSON-RPC tools, resources, offline schema validator) |
-| **`everything-seo-cli`** | [PyPI](https://pypi.org/project/everything-seo-cli/1.2.1/) | `pip install everything-seo-cli==1.2.1` | Standalone Python CLI, agent adapters & verification tooling |
+| **`@devcenterpoint/everything-seo`** | [npm](https://www.npmjs.com/package/@devcenterpoint/everything-seo) | `npx @devcenterpoint/everything-seo init` | Universal CLI, interactive installer, 55 offline skills, presets, Cursor rules |
+| **`@devcenterpoint/mcp-server-seo`** | [npm](https://www.npmjs.com/package/@devcenterpoint/mcp-server-seo) | `npx @devcenterpoint/mcp-server-seo` | Official MCP server (JSON-RPC tools, resources, forensic triage, validator) |
+| **`everything-seo-cli`** | [PyPI](https://pypi.org/project/everything-seo-cli/) | `pip install everything-seo-cli` | Standalone Python CLI with full 55-skill offline bundle & triage |
 
 ### 1. Global System Installation (Install Once, Available to All Agents)
 Install skills globally so your AI coding agents discover them automatically across all projects:
@@ -67,19 +68,26 @@ irm https://raw.githubusercontent.com/beingmushfiq/Everything-SEO/main/scripts/i
 Add only the specific SEO skills your application requires directly into your project repository. No token bloat, fully customizable, and version-controlled with your code:
 
 ```bash
-# Initialize SEO capabilities in your active project workspace
+# Initialize SEO capabilities (Interactive selection menu by default)
 everything-seo init
 
+# Or deploy the complete fleet of all 55 skills + 56 Cursor rules immediately
+everything-seo init --all
+
+# Run forensic triage on any search issue or GSC error message
+everything-seo triage "crawled currently not indexed"
+everything-seo triage "INP failing on mobile"
+
 # Initialize with a curated domain preset
 everything-seo init --preset nextjs       # Technical Crawling + SSR Schema + Core Web Vitals
 everything-seo init --preset ecommerce    # Product Schema + Faceted Nav + Category Optimization
 everything-seo init --preset saas         # Competitor Pages + AI Citation + B2B Lead Gen
 everything-seo init --preset publisher    # Google News + Entity Coverage + NLP Optimization
 
-# Progressively add individual skills as requirements expand
-everything-seo add technical-seo/indexing
-everything-seo add on-page-seo/schema-markup
-everything-seo add ai-seo/ai-search-visibility
+# Progressively add individual skills anytime (supports natural aliases)
+everything-seo add canonical              # Resolves to Technical SEO/Indexing
+everything-seo add schema                 # Resolves to On-page SEO/Schema Markup
+everything-seo add "ai-search-visibility"
 
 # Scaffold a custom, compliant SEO skill for your company's proprietary rules
 everything-seo scaffold --name custom-internal-routing --category "Technical SEO"
@@ -224,6 +232,7 @@ python -m unittest discover -s tests -p "test_*.py" -v
 ## 📚 Community, Governance & Links
 
 - **Universal Integration & Guides**:
+  - [Master SEO Triage & Routing Guide](docs/SEO_TRIAGE_AND_ROUTING_GUIDE.md)
   - [Universal Agent Integration Guide](docs/UNIVERSAL_AGENT_INTEGRATION_GUIDE.md)
   - [Strategic Roadmap](ROADMAP.md)
   - [SEO-Eval Benchmark Report](docs/EVAL_BENCHMARK_REPORT.md)
@@ -234,6 +243,7 @@ python -m unittest discover -s tests -p "test_*.py" -v
   - [Security Policy](SECURITY.md)
   - [Support & FAQ](FAQ.md)
 - **Project Governance & Release**:
+  - [v1.3.0 Release Notes](docs/RELEASE_NOTES_v1.3.0.md)
   - [v1.2.1 Release Notes](docs/RELEASE_NOTES_v1.2.1.md)
   - [v1.2.0 Release Notes](docs/RELEASE_NOTES_v1.2.0.md)
   - [v1.1.0 Release Notes](docs/RELEASE_NOTES_v1.1.0.md)
@@ -250,6 +260,7 @@ python -m unittest discover -s tests -p "test_*.py" -v
 
 ## ⚖️ License & Attribution
 
+Created & Led by **[Mushfiqur Rahman Aayan (@beingmushfiq)](https://github.com/beingmushfiq)**  
 Maintained with pride by **[DevCenterPoint](https://devcenterpoint.com)** under the **[MIT License](LICENSE)**.  
 Repository: **[`beingmushfiq/Everything-SEO`](https://github.com/beingmushfiq/Everything-SEO)**  
 Built for deterministic, repeatable, and verifiable organic search excellence.

{everything_seo_cli-1.3.0 → everything_seo_cli-1.4.0}/everything_seo_cli/__init__.py

@@ -3,5 +3,5 @@ Everything SEO CLI Package
 Maintained by DevCenterPoint (https://devcenterpoint.com)
 """
 
-__version__ = "1.2.0"
+__version__ = "1.4.0"
 

{everything_seo_cli-1.3.0 → everything_seo_cli-1.4.0}/everything_seo_cli/cli.py

@@ -7,7 +7,9 @@ Maintained by DevCenterPoint (https://devcenterpoint.com)
 
 import sys
 import os
+import re
 import json
+import shutil
 import argparse
 import subprocess
 from pathlib import Path
@@ -111,11 +113,15 @@ SKILL_ALIASES = {
     "conversion": "Growth/Conversion Optimization",
     "cro": "Growth/Conversion Optimization",
     "leads": "Growth/Lead Generation",
-    "traffic": "Growth/Organic Traffic"
+    "traffic": "Growth/Organic Traffic",
+    "orchestrator": "SEO Tools/SEO Orchestrator",
+    "triage": "SEO Tools/SEO Orchestrator",
+    "doctor": "SEO Tools/SEO Orchestrator",
+    "seo-orchestrator": "SEO Tools/SEO Orchestrator"
 }
 
 BANNER = """===================================================
-Everything SEO CLI (Python) v1.3.0
+Everything SEO CLI (Python) v1.4.0
 Author: Mushfiqur Rahman Aayan (@beingmushfiq)
 Maintainer: DevCenterPoint (https://devcenterpoint.com)
 Universal Skill Manager for AI Agents & Developers
@@ -158,7 +164,8 @@ def cmd_install_global():
         target_dir.mkdir(parents=True, exist_ok=True)
         count = 0
         for s in skills:
-            slug = f"seo-{s['name'].lower().replace(' ', '-').replace('+', '')}"
+            clean_name = re.sub(r'^seo[-\s]+', '', s['name'], flags=re.IGNORECASE)
+            slug = f"seo-{clean_name.lower().replace(' ', '-').replace('+', '')}"
             dest_dir = target_dir / slug
             dest_dir.mkdir(parents=True, exist_ok=True)
             (dest_dir / "SKILL.md").write_text(s["path"].read_text(encoding="utf-8"), encoding="utf-8")
@@ -171,8 +178,8 @@ def cmd_install_global():
 
 def prompt_preset_choice() -> str:
     print("Select SEO capabilities to install in this workspace:\n")
-    print("  1) Complete Library (All 55 Skills)  — All 11 disciplines + Cursor rules (Recommended)")
-    print("  2) Essential Starter Pack (5 Skills) — Indexing, RobotsTXT, Page Speed, Schema, AI Visibility")
+    print("  1) Complete Library (All 56 Skills)  — All 11 disciplines + Cursor rules (Recommended)")
+    print("  2) Essential Starter Pack (6 Skills) — Master Orchestrator, Indexing, RobotsTXT, Page Speed, Schema, AI Visibility")
     print("  3) Next.js / Jamstack (5 Skills)    — Technical Crawling, SSR Schema, Indexing, Speed, Sitemaps")
     print("  4) E-Commerce Preset (5 Skills)     — Product Schema, Faceted URLs, Digital PR, Speed")
     print("  5) B2B SaaS Preset (5 Skills)       — AI Visibility, Entity Coverage, Content Gap, Leads")
@@ -230,27 +237,43 @@ def cmd_init(preset_name=None, is_all=False):
             src = ROOT_DIR / skill_rel / "SKILL.md"
 
         skill_name = Path(skill_rel).name
-        dest = agent_skills / skill_name / "SKILL.md"
+        clean_name = re.sub(r'^seo[-\s]+', '', skill_name, flags=re.IGNORECASE)
+        slug = f"seo-{clean_name.lower().replace(' ', '-').replace('+', '')}"
+        dest = agent_skills / slug / "SKILL.md"
         dest.parent.mkdir(parents=True, exist_ok=True)
 
         if src.exists():
             content = src.read_text(encoding="utf-8")
             dest.write_text(content, encoding="utf-8")
-            print(f" + Installed skill: .agent/skills/{skill_name}/SKILL.md")
+            print(f" + Installed skill: .agent/skills/{slug}/SKILL.md")
+
+            # Extract rich description and Section B triggers
+            desc = f"SEO operational skill for {skill_name}"
+            desc_m = re.search(r'description:\s*["\']?([^"\']+)["\']?', content)
+            if desc_m:
+                desc = desc_m.group(1).strip()
+            trigger_m = re.search(r'##\s*B\.\s*Trigger Conditions([\s\S]*?)(?=\n##\s*[A-Z]\.|\Z)', content, re.IGNORECASE)
+            if trigger_m:
+                trig_raw = trigger_m.group(1)
+                trig_raw = re.sub(r'Invoke this skill when:?', '', trig_raw, flags=re.IGNORECASE)
+                trig_raw = re.sub(r'Upstream dependencies:[\s\S]*', '', trig_raw, flags=re.IGNORECASE)
+                clean_trig = " ".join(trig_raw.split())[:250]
+                if clean_trig:
+                    desc = f"{desc} Trigger when: {clean_trig}"
+            safe_desc = desc.replace('"', "'")
 
             # Generate Cursor rule
-            slug = skill_name.lower().replace(" ", "-").replace("+", "")
             cursor_rule_content = f"""---
-description: "SEO operational skill for {skill_name}"
+description: "{safe_desc}"
 globs: "**/*"
 alwaysApply: false
 ---
 
 # {skill_name} Rules
-Follow operational procedures in .agent/skills/{skill_name}/SKILL.md
+Follow operational procedures in .agent/skills/{slug}/SKILL.md
 """
-            (cursor_rules / f"seo-{slug}.mdc").write_text(cursor_rule_content, encoding="utf-8")
-            installed_skills.append(skill_name)
+            (cursor_rules / f"{slug}.mdc").write_text(cursor_rule_content, encoding="utf-8")
+            installed_skills.append(slug)
 
     # Master Router Rule
     router_rule = """---
@@ -260,32 +283,36 @@ alwaysApply: true
 ---
 
 # Everything SEO Master Router & Triage Engine
-When the user asks an SEO-related question, use this triage matrix to apply the exact operational manual from .agent/skills/<skill>/SKILL.md:
+When the user asks an SEO-related question, use this triage matrix to apply the exact operational manual from .agent/skills/seo-<slug>/SKILL.md:
 
 - Indexation, Crawl Status, Canonical Loops, 404s, Noindex Directives:
-  -> Read .agent/skills/Indexing/SKILL.md or Crawling/SKILL.md
+  -> Read .agent/skills/seo-indexing/SKILL.md or .agent/skills/seo-crawling/SKILL.md
 - Robots.txt Errors, Bot Blocking, RFC 9309 Directive Syntax:
-  -> Read .agent/skills/RobotsTXT/SKILL.md
+  -> Read .agent/skills/seo-robotstxt/SKILL.md
 - Schema.org, JSON-LD, Rich Results, Structured Data Errors:
-  -> Read .agent/skills/Schema Markup/SKILL.md
+  -> Read .agent/skills/seo-schema-markup/SKILL.md
 - Core Web Vitals, LCP, INP, CLS, Asset Optimization:
-  -> Read .agent/skills/Page Speed/SKILL.md
+  -> Read .agent/skills/seo-page-speed/SKILL.md
 - AI Overviews, Perplexity Citations, ChatGPT Search, GEO Entity Gain:
-  -> Read .agent/skills/AI Search Visibility/SKILL.md
+  -> Read .agent/skills/seo-ai-search-visibility/SKILL.md
 - Organic Traffic Decay, Stale Content, SERP Rank Decline:
-  -> Read .agent/skills/Content Refresh/SKILL.md
+  -> Read .agent/skills/seo-content-refresh/SKILL.md
 - Hreflang, Multilingual Sites, Multi-Region Targeting:
-  -> Read .agent/skills/Hreflang/SKILL.md
+  -> Read .agent/skills/seo-hreflang/SKILL.md
 - Internal Linking, Orphan Pages, PageRank Distribution:
-  -> Read .agent/skills/Internal Linking/SKILL.md
+  -> Read .agent/skills/seo-internal-linking/SKILL.md
 - Title Tags, Meta Descriptions, CTR Anomaly Remediation:
-  -> Read .agent/skills/Title/SKILL.md or CTR Optimization/SKILL.md
+  -> Read .agent/skills/seo-title/SKILL.md or .agent/skills/seo-ctr-optimization/SKILL.md
+- URL Structure, Slugs, Faceted Navigation Parameters:
+  -> Read .agent/skills/seo-url-optimization/SKILL.md
 - Redirect Chains, 301/302 Rules, HTTP-to-HTTPS Loops:
-  -> Read .agent/skills/Redirects/SKILL.md
+  -> Read .agent/skills/seo-redirects/SKILL.md
 - XML Sitemaps, Sitemap Indexing, Lastmod Hygeine:
-  -> Read .agent/skills/XML Sitemaps/SKILL.md
+  -> Read .agent/skills/seo-xml-sitemaps/SKILL.md
 - Search Console Performance, GSC Coverage Errors, Query Clicks:
-  -> Read .agent/skills/Search Console/SKILL.md
+  -> Read .agent/skills/seo-search-console/SKILL.md
+- Master Triage, Multi-Symptom Diagnostics, or Ambiguous Ranking Losses:
+  -> Read .agent/skills/seo-orchestrator/SKILL.md
 
 Follow the 5-phase procedure in the referenced skill manual.
 """
@@ -294,7 +321,7 @@ Follow the 5-phase procedure in the referenced skill manual.
 
     manifest = cwd / ".everything-seo.json"
     manifest.write_text(json.dumps({
-        "version": "1.3.0",
+        "version": "1.4.0",
         "preset": active_preset,
         "installed_skills": installed_skills,
         "author": "Mushfiqur Rahman Aayan (@beingmushfiq)",
@@ -315,7 +342,8 @@ def cmd_triage(query: str):
         (["ai", "geo", "perplexity", "overview", "chatgpt", "copilot", "llm", "citation"], "AI SEO/AI Search Visibility", "AI Search Visibility", "Optimizes for Generative Engine Optimization (GEO) and AI search citations."),
         (["redirect", "301", "302", "404", "loop", "chain", "migration"], "Technical SEO/Redirects", "Redirects", "Fixes 301/302 redirect loops, trailing slash anomalies, and migration maps."),
         (["hreflang", "multilingual", "international", "country", "language", "x-default"], "International SEO/Hreflang", "Hreflang", "Builds valid multi-region hreflang XML clusters and prevents regional cannibalization."),
-        (["decay", "traffic drop", "lost traffic", "refresh", "old content"], "Content Optimization/Content Refresh", "Content Refresh", "Conducts content decay triage and updates stale ranking assets.")
+        (["decay", "traffic drop", "lost traffic", "refresh", "old content"], "Content Optimization/Content Refresh", "Content Refresh", "Conducts content decay triage and updates stale ranking assets."),
+        (["triage", "orchestrator", "diagnose", "general", "audit", "everything", "traffic drop", "lost traffic", "ranking drop", "drop", "rank", "ranking", "penalty", "penalized", "decline"], "SEO Tools/SEO Orchestrator", "SEO Orchestrator", "Executes forensic diagnostic triage across all 11 disciplines to pinpoint root causes.")
     ]
 
     matches = []
@@ -354,27 +382,45 @@ def cmd_add(skill_query: str):
         print("Run 'everything-seo list' to see all 55 available skills, or 'everything-seo triage <symptom>'.")
         sys.exit(1)
 
+    clean_name = re.sub(r'^seo[-\s]+', '', match["name"], flags=re.IGNORECASE)
+    slug = f"seo-{clean_name.lower().replace(' ', '-').replace('+', '')}"
+
     cwd = Path.cwd()
-    target_dir = cwd / ".agent" / "skills" / match["name"]
+    target_dir = cwd / ".agent" / "skills" / slug
     target_dir.mkdir(parents=True, exist_ok=True)
-    (target_dir / "SKILL.md").write_text(match["path"].read_text(encoding="utf-8"), encoding="utf-8")
+    content = match["path"].read_text(encoding="utf-8")
+    (target_dir / "SKILL.md").write_text(content, encoding="utf-8")
 
     cursor_dir = cwd / ".cursor" / "rules"
     cursor_dir.mkdir(parents=True, exist_ok=True)
-    slug = match["name"].lower().replace(" ", "-").replace("+", "")
+
+    desc = f"SEO operational skill for {match['name']}"
+    desc_m = re.search(r'description:\s*["\']?([^"\']+)["\']?', content)
+    if desc_m:
+        desc = desc_m.group(1).strip()
+    trigger_m = re.search(r'##\s*B\.\s*Trigger Conditions([\s\S]*?)(?=\n##\s*[A-Z]\.|\Z)', content, re.IGNORECASE)
+    if trigger_m:
+        trig_raw = trigger_m.group(1)
+        trig_raw = re.sub(r'Invoke this skill when:?', '', trig_raw, flags=re.IGNORECASE)
+        trig_raw = re.sub(r'Upstream dependencies:[\s\S]*', '', trig_raw, flags=re.IGNORECASE)
+        clean_trig = " ".join(trig_raw.split())[:250]
+        if clean_trig:
+            desc = f"{desc} Trigger when: {clean_trig}"
+    safe_desc = desc.replace('"', "'")
+
     cursor_rule = f"""---
-description: "SEO operational skill for {match['name']}"
+description: "{safe_desc}"
 globs: "**/*"
 alwaysApply: false
 ---
 
 # {match['name']} Rules
-Follow operational procedures in .agent/skills/{match['name']}/SKILL.md
+Follow operational procedures in .agent/skills/{slug}/SKILL.md
 """
-    (cursor_dir / f"seo-{slug}.mdc").write_text(cursor_rule, encoding="utf-8")
+    (cursor_dir / f"{slug}.mdc").write_text(cursor_rule, encoding="utf-8")
     print(f"[PASS] Added skill: {match['slug']}")
-    print(f"- Agent skill: .agent/skills/{match['name']}/SKILL.md")
-    print(f"- Cursor rule: .cursor/rules/seo-{slug}.mdc\n")
+    print(f"- Agent skill: .agent/skills/{slug}/SKILL.md")
+    print(f"- Cursor rule: .cursor/rules/{slug}.mdc\n")
 
 def cmd_search(query):
     print_banner()

everything_seo_cli-1.4.0/everything_seo_cli/data/SEO/SEO Tools/SEO Orchestrator/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: seo-orchestrator
+description: Master SEO orchestrator, symptom triage engine, and multi-skill dispatch director. Diagnoses organic traffic drops, Google Search Console indexing anomalies, Core Web Vitals regressions, Schema.org structured data errors, and directs queries to specialized Everything SEO skills.
+metadata:
+  category: SEO Tools
+  discipline: Technical Auditing & Autonomous Routing
+  version: "1.0.0"
+---
+
+# Master SEO Orchestrator & Autonomous Triage Engine
+
+## A. Purpose
+The Master SEO Orchestrator skill establishes the Level-1 supervisory intelligence and automated routing engine for the Everything SEO library. In enterprise environments and multi-disciplinary development workflows, search engine anomalies rarely present as isolated single-variable problems. A sudden decline in organic traffic or search impressions could stem from server-level rendering timeouts, accidental `noindex` injections, canonical loops, robots.txt blocking, Core Web Vitals degradation, or Google algorithmic updates. The SEO Orchestrator provides a deterministic, citational diagnostic framework that analyzes user symptoms, inspects codebase artifacts, resolves ambiguity, and dispatches the exact specialized operational manual from the 55-skill Everything SEO catalog.
+
+## B. Trigger Conditions
+Invoke this skill when:
+1. The user presents an open-ended, ambiguous, or multi-symptom SEO inquiry (e.g., *"Our organic traffic dropped 40% after Tuesday's deploy"*, *"How do I optimize our Next.js application for search?"*).
+2. Auditing a website prior to launch, domain migration, or major architectural rewrite where multiple disciplines intersect.
+3. Multiple conflicting diagnostic signals exist (e.g., Google Search Console reports "Indexed, though blocked by robots.txt" or "Page with redirect has canonical conflict").
+4. An automated CI/CD pipeline or pull request requires a holistic SEO health check across technical, structural, and performance boundaries.
+5. The operator explicitly invokes the master triage command `/seo-orchestrator` or `/seo-triage`.
+
+Upstream dependencies: None (Acts as the Level-1 entrypoint). Downstream dependencies: All 55 specialist skills across Technical SEO, On-page SEO, Content Optimization, Link Building, AI SEO, International SEO, Analytics, SEO Tools, Keyword Research, SEO Wins, and Growth.
+
+## C. Scope and Boundaries
+- **In-Scope**:
+  - Semantic intent analysis of incoming natural language SEO queries and symptoms.
+  - Multi-tier diagnostic decision matrix mapping symptoms to primary and secondary specialist skills.
+  - Codebase artifact inspection (e.g., checking `robots.txt`, `sitemap.xml`, `<meta name="robots">`, `next.config.js`, `package.json`, `.cursor/rules/`).
+  - Formulating prioritized, sequential action plans that chain multiple specialist skills in logical order.
+  - Continuous alignment with Google Search Essentials, RFC 9309, Schema.org, and W3C Web Performance standards.
+- **Out-of-Scope**:
+  - Deep single-domain remediation procedures (Delegated directly to specialized skills such as [Indexing](../../Technical%20SEO/Indexing/SKILL.md), [Schema Markup](../../On-page%20SEO/Schema%20Markup/SKILL.md), or [Page Speed](../../Technical%20SEO/Page%20Speed/SKILL.md)).
+  - Direct execution of destructive codebase operations without operator consent.
+
+## D. Required Inputs
+1. **User Problem Statement or Symptom**: Description of the issue, observed anomaly, or desired optimization goal.
+2. **Target Domain or Repository Context**: Live URL, staging environment, or local workspace file tree.
+3. **Observability Evidence (If Available)**:
+   - Google Search Console performance / coverage CSV exports.
+   - Server access logs or HTTP response status codes.
+   - Core Web Vitals field data (CrUX) or Lighthouse performance traces.
+   - Git commit history or release changelogs surrounding the observed drop.
+
+## E. Required Tools and Data Sources
+- **Everything SEO CLI**: `everything-seo triage <symptom>` (Node.js) or `python -m everything_seo_cli.cli triage <symptom>` (Python).
+- **Everything SEO MCP Server**: Tool `triage_seo_problem` and `list_seo_skills`.
+- **Zero-Cost Inspection Utilities**:
+  - `curl -I -s -A "Googlebot" https://example.com` (inspecting HTTP response headers and `X-Robots-Tag`).
+  - Chrome DevTools Network and Performance panels.
+  - Google Search Console URL Inspection API.
+
+## F. Core Concepts and Decision Principles
+1. **The 5-Phase Diagnostic Lifecycle**:
+   - *Phase 1: Ingestion & Symptom Extraction* — Parse the user prompt for explicit error codes (404, 500, 301), metrics (LCP, INP, CTR), entities, and timeframe.
+   - *Phase 2: Signal Triangulation* — Check whether the symptom is Technical (infrastructure/crawling/indexing), On-Page (metadata/structure), Content (quality/decay), or Off-Page (backlinks/penalties).
+   - *Phase 3: Specialist Skill Dispatch* — Load the exact `.agent/skills/seo-<slug>/SKILL.md` manual.
+   - *Phase 4: Remediation Plan Formulation* — Produce atomic, auditable code or configuration diffs.
+   - *Phase 5: Pre-Flight Verification* — Test changes against the specialist skill's Section E checklist.
+2. **The Fundamental Crawling vs. Indexing Distinction**:
+   - `robots.txt` governs *crawling* (bot bandwidth access). It does NOT prevent indexing.
+   - Meta `noindex` and HTTP `X-Robots-Tag` govern *indexing* (presence in Google's database). Googlebot must crawl a page to read the `noindex` directive.
+3. **Root Cause Hierarchy (The Waterflow Principle)**:
+   - Technical infrastructure errors (DNS, 5xx server errors, robots.txt bot blocking) supersede content and keyword optimization. Never optimize keywords on a page that Googlebot cannot crawl or index.
+
+## G. Operational Workflow
+
+```
+                  [User Prompt / Diagnostic Inquiry]
+                                  │
+                                  ▼
+                [Phase 1: Parse Symptom & Context]
+                                  │
+                 ┌────────────────┴────────────────┐
+                 ▼                                 ▼
+      [Exact Symptom Match]             [Ambiguous / Broad Query]
+      - 404 / Redirect Loop             - "Traffic dropped 40%"
+      - Schema JSON-LD error            - "Improve our SEO"
+      - LCP / INP > 2.5s                - "Audit website"
+                 │                                 │
+                 │                                 ▼
+                 │                   [Run Forensic Triage Engine]
+                 │                   - Check GSC coverage dates
+                 │                   - Check robots.txt & headers
+                 │                   - Triangulate blast radius
+                 │                                 │
+                 └────────────────┬────────────────┘
+                                  ▼
+                 [Phase 3: Dispatch Specialist Skill]
+        - Technical: seo-indexing, seo-crawling, seo-robotstxt, seo-redirects
+        - On-Page:   seo-schema-markup, seo-title, seo-internal-linking
+        - Content:   seo-content-refresh, seo-entity-optimization
+        - AI Search: seo-ai-search-visibility, seo-ai-citations
+        - Speed:     seo-page-speed, seo-search-console
+                                  │
+                                  ▼
+                [Phase 4: Execute Section D Protocol]
+                                  │
+                                  ▼
+                [Phase 5: Pre-Flight Verification Audit]
+```
+
+### Step 1: Execute Forensic Symptom Triage
+Evaluate the user inquiry against the Symptom Triage Decision Matrix (Section H). If using the CLI or MCP server, run:
+```bash
+everything-seo triage "<symptom description>"
+```
+
+### Step 2: Formulate Multi-Skill Execution Chain
+When multiple disciplines are implicated, order the skills by technical dependency:
+1. **Infrastructure Gate**: `seo-robotstxt` -> `seo-crawling` -> `seo-redirects`
+2. **Indexation Gate**: `seo-indexing` -> `seo-xml-sitemaps` -> `seo-search-console`
+3. **Rendering & Speed Gate**: `seo-page-speed` -> `seo-screaming-frog`
+4. **Semantic Gate**: `seo-schema-markup` -> `seo-internal-linking` -> `seo-title`
+5. **Growth & AI Gate**: `seo-ai-search-visibility` -> `seo-content-refresh`
+
+## H. Analysis and Decision Framework (Triage Mapping Table)
+
+| Observed Symptom / Query String | Primary Skill Slug | Secondary Skill Slug | Action Protocol |
+| :--- | :--- | :--- | :--- |
+| **"Discovered - currently not indexed"** | `seo-indexing` | `seo-internal-linking` | Audit internal link equity and content quality thresholds. |
+| **"Crawled - currently not indexed"** | `seo-indexing` | `seo-content-refresh` | Inspect duplicate content, thin value, and canonical tags. |
+| **"Googlebot blocked" or "robots.txt error"** | `seo-robotstxt` | `seo-crawling` | Validate RFC 9309 directive syntax and Disallow patterns. |
+| **"Traffic dropped after redesign / migration"**| `seo-redirects` | `seo-indexing` | Audit 301 redirect map coverage, 404 logs, and canonical drift. |
+| **"Core Web Vitals failing" or "Slow LCP / INP"**| `seo-page-speed` | `seo-screaming-frog` | Profile server TTFB, render-blocking JS, and main-thread tasks. |
+| **"Rich Results not showing" / "Schema error"** | `seo-schema-markup` | `seo-title` | Validate JSON-LD syntax against Schema.org and Google Rich Results. |
+| **"How to appear in ChatGPT / Perplexity"** | `seo-ai-search-visibility`| `seo-ai-citations` | Optimize information gain, authoritative citations, and entities. |
+| **"Orphan pages" or "Pellucid internal structure"**| `seo-internal-linking` | `seo-xml-sitemaps` | Map sitewide click depth and inject contextual contextual inlinks. |
+| **"Hreflang errors" or "Multilingual targeting"** | `seo-hreflang` | `seo-international-seo`| Audit bidirectional hreflang tags, self-referencing and x-default. |
+| **"Organic traffic decay" / "Outdated articles"** | `seo-content-refresh` | `seo-entity-optimization`| Identify rotting URLs and re-anchor with contemporary statistics. |
+| **"Keyword cannibalization"** | `seo-keyword-discovery` | `seo-internal-linking` | Consolidate competing pages or delineate distinct search intents. |
+
+## I. Prioritization Framework
+Score triage findings using the **SEO Urgency-Impact Coefficient (UIC)**:
+
+$$\text{UIC} = \frac{\text{Severity Score (1 to 10)} \times \text{Organic Revenue Share (\%)}}{\text{Engineering Remediation Hours}}$$
+
+- **P0 Critical (UIC $\ge$ 5.0)**: Sitewide crawl blockages, accidental `noindex` on money pages, broken checkout redirects. Must fix within 4 hours.
+- **P1 High (UIC 2.0 to 4.9)**: Severe Core Web Vitals regressions, broken Schema on high-CTR product pages, high-value 404 links. Fix in current sprint.
+- **P2 Medium (UIC 1.0 to 1.9)**: Title tag truncation, missing alt attributes, stale blog posts. Schedule for maintenance cycle.
+
+## J. Deliverables & Specifications
+When acting as the SEO Orchestrator, deliver a structured **Forensic SEO Triage & Remediation Plan**:
+1. **Executive Summary**: Identified root cause, affected URLs, and revenue/traffic blast radius.
+2. **Skill Dispatch Map**: Explicit declaration of primary and secondary skills loaded (`seo-<slug>`).
+3. **Step-by-Step Remediation Sequence**: Ordered atomic actions referencing exact sections of each specialist skill.
+4. **Pre-Flight Verification Protocol**: Deterministic checklist to execute before deploying changes.
+
+## K. Quality Assurance Checklist
+- [ ] Root cause verified against live HTTP headers or Google Search Console exports.
+- [ ] Crawling vs. Indexing separation explicitly confirmed (did not confuse robots.txt with noindex).
+- [ ] Primary and secondary skills loaded from `.agent/skills/seo-<slug>/SKILL.md`.
+- [ ] Remediation steps avoid destructive file overwrites without operator approval.
+- [ ] Changes validated using test suites or mock HTTP requests.
+
+## L. Failure Modes and Anti-Patterns
+- **The Blind Prescriber**: Guessing the root cause of a traffic drop without inspecting HTTP status codes, GSC coverage data, or robots.txt.
+- **The Monolithic Dump**: Dumping all 55 skill manuals into the AI context simultaneously, overflowing token windows and confusing the agent.
+- **The Premature Optimizer**: Tuning meta descriptions or keyword density on pages that are returning HTTP 500 or blocked in `robots.txt`.
+
+## M. AI-Agent Operating Instructions
+1. When an open-ended SEO question is received, immediately evaluate the prompt against Section H.
+2. If the inquiry is clear, load the specific `.agent/skills/seo-<slug>/SKILL.md` directly.
+3. If the inquiry is multi-faceted or ambiguous, execute a diagnostic triage run, cite the primary candidate skills, and present the structured diagnosis to the user.
+4. Always prefix slash command recommendations with `/seo-` (e.g. `/seo-indexing`, `/seo-schema-markup`).
+
+## N. Success Metrics & Verification Windows
+- **Triage Accuracy**: >95% first-pass correlation between diagnosed root cause and actual technical resolution.
+- **Zero Hallucinated Standards**: 100% adherence to official RFC 9309, Google Search Essentials, and Schema.org specifications.
+
+## O. Related Skills
+- **Core Triage Suite**: [Indexing](../../Technical%20SEO/Indexing/SKILL.md), [Crawling](../../Technical%20SEO/Crawling/SKILL.md), [RobotsTXT](../../Technical%20SEO/RobotsTXT/SKILL.md), [Redirects](../../Technical%20SEO/Redirects/SKILL.md)
+- **On-Page Suite**: [Schema Markup](../../On-page%20SEO/Schema%20Markup/SKILL.md), [Title](../../On-page%20SEO/Title/SKILL.md), [Internal Linking](../../On-page%20SEO/Internal%20Linking/SKILL.md)
+- **Performance & AI Suite**: [Page Speed](../../Technical%20SEO/Page%20Speed/SKILL.md), [AI Search Visibility](../../AI%20SEO/AI%20Search%20Visibility/SKILL.md)
+
+## P. Authoritative References
+- [Google Search Central Documentation](https://developers.google.com/search/docs) — Official search developer guidelines.
+- [RFC 9309: Robots Exclusion Protocol](https://www.rfc-editor.org/rfc/rfc9309.html) — Authoritative robots.txt specification.
+- [Schema.org Community Vocabulary](https://schema.org) — Structured data standards.
+
+## Q. Maintenance and Review Cycle
+- **Quarterly Algorithm Review**: Update triage decision trees whenever Google announces core algorithm updates or introduces new search features (e.g., AI Overviews, Search Generative Experience).

{everything_seo_cli-1.3.0 → everything_seo_cli-1.4.0}/everything_seo_cli/data/presets/all.json

@@ -1,7 +1,7 @@
 {
   "name": "Complete Everything SEO Library",
   "slug": "all",
-  "description": "Complete operational fleet of all 55 SEO capability manuals across all 11 disciplines.",
+  "description": "Complete operational fleet of all 56 SEO capability manuals across all 11 disciplines.",
   "target_frameworks": [
     "All Web Frameworks"
   ],
@@ -49,7 +49,8 @@
     "SEO/SEO Tools/Ahrefs",
     "SEO/SEO Tools/Keywords Everywhere",
     "SEO/SEO Tools/Screaming Frog",
-    "SEO/SEO Tools/SEMrush",
+    "SEO/SEO Tools/SEMrush",
+    "SEO/SEO Tools/SEO Orchestrator",
     "SEO/SEO Wins/150+ SEO Hacks",
     "SEO/SEO Wins/AI SEO Hacks",
     "SEO/SEO Wins/Backlinks Hacks",

{everything_seo_cli-1.3.0 → everything_seo_cli-1.4.0}/everything_seo_cli/data/presets/ecommerce.json

@@ -16,7 +16,8 @@
     "SEO/On-page SEO/Image SEO",
     "SEO/On-page SEO/URL Optimization",
     "SEO/Link Building/Digital PR",
-    "SEO/Growth/Conversion Optimization"
+    "SEO/Growth/Conversion Optimization",
+    "SEO/SEO Tools/SEO Orchestrator"
   ],
   "recommended_globs": [
     "templates/**/*.liquid",