codehava-agent-kit 1.0.1 → 3.0.0

package/templates/.agent/skills/seo-dataforseo/SKILL.md

@@ -0,0 +1,395 @@
+---
+name: seo-dataforseo
+description: "Use DataForSEO for live SERPs, keyword metrics, backlinks, competitor analysis, on-page checks, and AI visibility data. Trigger when the user needs real SEO data rather than static guidance."
+risk: unknown
+source: "https://github.com/AgriciDaniel/claude-seo"
+date_added: "2026-03-21"
+user-invokable: true
+argument-hint: "[command] [query]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - WebFetch
+  - Write
+---
+
+# DataForSEO: Live SEO Data (Extension)
+
+Live search data via the DataForSEO MCP server. Provides real-time SERP results,
+keyword metrics, backlink profiles, on-page analysis, content analysis, business
+listings, AI visibility checking, and LLM mention tracking across
+9 API modules with 79 MCP tools.
+
+## When to Use
+
+- Use when the user needs live SEO data instead of static best-practice guidance.
+- Use for SERP lookups, keyword volumes, backlink checks, competitor data, or AI visibility tracking.
+- Use only when the DataForSEO extension is available in the environment.
+
+## Prerequisites
+
+This skill requires the DataForSEO extension to be installed:
+```bash
+./extensions/dataforseo/install.sh
+```
+
+**Check availability:** Before using any DataForSEO tool, verify the MCP server
+is connected by checking if `serp_organic_live_advanced` or any DataForSEO tool
+is available. If tools are not available, inform the user the extension is not
+installed and provide install instructions.
+
+## API Credit Awareness
+
+DataForSEO charges per API call. Be efficient:
+- Prefer bulk endpoints over multiple single calls
+- Use default parameters (US, English) unless user specifies otherwise
+- Cache results mentally within a session; don't re-fetch the same data
+- Warn user before running expensive operations (full backlink crawls, large keyword lists)
+
+## Quick Reference
+
+| Command | What it does |
+|---------|-------------|
+| `/seo dataforseo serp <keyword>` | Google organic SERP results |
+| `/seo dataforseo serp-youtube <keyword>` | YouTube search results |
+| `/seo dataforseo youtube <video_id>` | YouTube video deep analysis |
+| `/seo dataforseo keywords <seed>` | Keyword ideas and suggestions |
+| `/seo dataforseo volume <keywords>` | Search volume for keywords |
+| `/seo dataforseo difficulty <keywords>` | Keyword difficulty scores |
+| `/seo dataforseo intent <keywords>` | Search intent classification |
+| `/seo dataforseo trends <keyword>` | Google Trends data |
+| `/seo dataforseo backlinks <domain>` | Full backlink profile |
+| `/seo dataforseo competitors <domain>` | Competitor domain analysis |
+| `/seo dataforseo ranked <domain>` | Ranked keywords for domain |
+| `/seo dataforseo intersection <domains>` | Keyword/backlink overlap |
+| `/seo dataforseo traffic <domains>` | Bulk traffic estimation |
+| `/seo dataforseo subdomains <domain>` | Subdomains with ranking data |
+| `/seo dataforseo top-searches <domain>` | Top queries mentioning domain |
+| `/seo dataforseo onpage <url>` | On-page analysis (Lighthouse + parsing) |
+| `/seo dataforseo tech <domain>` | Technology stack detection |
+| `/seo dataforseo whois <domain>` | WHOIS registration data |
+| `/seo dataforseo content <keyword/url>` | Content analysis and trends |
+| `/seo dataforseo listings <keyword>` | Business listings search |
+| `/seo dataforseo ai-scrape <query>` | ChatGPT web scraper for GEO |
+| `/seo dataforseo ai-mentions <keyword>` | LLM mention tracking for GEO |
+
+---
+
+## SERP Analysis
+
+### `/seo dataforseo serp <keyword>`
+
+Fetch live Google organic search results.
+
+**MCP tools:** `serp_organic_live_advanced`
+
+**Default parameters:** location_code=2840 (US), language_code=en, device=desktop, depth=100
+
+**Also supports:** The `serp_organic_live_advanced` tool supports Google, Bing, and Yahoo via the `se` parameter. Specify "bing" or "yahoo" to switch search engines.
+
+**Output:** Rank, URL, title, description, domain, featured snippets, AI overview references, People Also Ask.
+
+### `/seo dataforseo serp-youtube <keyword>`
+
+Fetch YouTube search results. Valuable for GEO. YouTube mentions correlate most strongly with AI citations.
+
+**MCP tools:** `serp_youtube_organic_live_advanced`
+
+**Output:** Video title, channel, views, upload date, description, URL.
+
+### `/seo dataforseo youtube <video_id>`
+
+Deep analysis of a specific YouTube video: info, comments, and subtitles. YouTube mentions have the strongest correlation (0.737) with AI visibility, making this critical for GEO analysis.
+
+**MCP tools:** `serp_youtube_video_info_live_advanced`, `serp_youtube_video_comments_live_advanced`, `serp_youtube_video_subtitles_live_advanced`
+
+**Parameters:** video_id (the YouTube video ID, e.g., "dQw4w9WgXcQ")
+
+**Output:** Video metadata (title, channel, views, likes, description), top comments with engagement, subtitle/transcript text.
+
+---
+
+## Keyword Research
+
+### `/seo dataforseo keywords <seed>`
+
+Generate keyword ideas, suggestions, and related terms from a seed keyword.
+
+**MCP tools:** `dataforseo_labs_google_keyword_ideas`, `dataforseo_labs_google_keyword_suggestions`, `dataforseo_labs_google_related_keywords`
+
+**Default parameters:** location_code=2840 (US), language_code=en, limit=50
+
+**Output:** Keyword, search volume, CPC, competition level, keyword difficulty, trend.
+
+### `/seo dataforseo volume <keywords>`
+
+Get search volume and metrics for a list of keywords.
+
+**MCP tools:** `kw_data_google_ads_search_volume`
+
+**Parameters:** keywords (array, comma-separated), location_code, language_code
+
+**Output:** Keyword, monthly search volume, CPC, competition, monthly trend data.
+
+### `/seo dataforseo difficulty <keywords>`
+
+Calculate keyword difficulty scores for ranking competitiveness.
+
+**MCP tools:** `dataforseo_labs_bulk_keyword_difficulty`
+
+**Parameters:** keywords (array), location_code, language_code
+
+**Output:** Keyword, difficulty score (0-100), interpretation (Easy/Medium/Hard/Very Hard).
+
+### `/seo dataforseo intent <keywords>`
+
+Classify keywords by user search intent.
+
+**MCP tools:** `dataforseo_labs_search_intent`
+
+**Parameters:** keywords (array), location_code, language_code
+
+**Output:** Keyword, intent type (informational, navigational, commercial, transactional), confidence score.
+
+### `/seo dataforseo trends <keyword>`
+
+Analyze keyword trends over time using Google Trends data.
+
+**MCP tools:** `kw_data_google_trends_explore`
+
+**Parameters:** keywords (array), location_code, date_from, date_to, language_code
+
+**Output:** Keyword, time series data, trend direction, seasonality signals.
+
+---
+
+## Domain & Competitor Analysis
+
+### `/seo dataforseo backlinks <domain>`
+
+Comprehensive backlink profile analysis.
+
+**MCP tools:** `backlinks_summary`, `backlinks_backlinks`, `backlinks_anchors`, `backlinks_referring_domains`, `backlinks_bulk_spam_score`, `backlinks_timeseries_summary`
+
+**Default parameters:** limit=100 per sub-call
+
+**Output:** Total backlinks, referring domains, domain rank, spam score, top anchors, new/lost backlinks over time, dofollow ratio, top referring domains.
+
+### `/seo dataforseo competitors <domain>`
+
+Identify competing domains and estimate traffic.
+
+**MCP tools:** `dataforseo_labs_google_competitors_domain`, `dataforseo_labs_google_domain_rank_overview`, `dataforseo_labs_bulk_traffic_estimation`
+
+**Output:** Competitor domains, keyword overlap %, estimated traffic, domain rank, common keywords.
+
+### `/seo dataforseo ranked <domain>`
+
+List keywords a domain ranks for with positions and page data.
+
+**MCP tools:** `dataforseo_labs_google_ranked_keywords`, `dataforseo_labs_google_relevant_pages`
+
+**Default parameters:** limit=100, location_code=2840
+
+**Output:** Keyword, position, URL, search volume, traffic share, SERP features.
+
+### `/seo dataforseo intersection <domain1> <domain2> [...]`
+
+Find shared keywords and backlink sources across 2-20 domains.
+
+**MCP tools:** `dataforseo_labs_google_domain_intersection`, `backlinks_domain_intersection`
+
+**Parameters:** domains (2-20 array)
+
+**Output:** Shared keywords with positions per domain, shared backlink sources, unique keywords per domain.
+
+### `/seo dataforseo traffic <domains>`
+
+Estimate organic search traffic for one or more domains.
+
+**MCP tools:** `dataforseo_labs_bulk_traffic_estimation`
+
+**Parameters:** domains (array)
+
+**Output:** Domain, estimated organic traffic, estimated traffic cost, top keywords.
+
+### `/seo dataforseo subdomains <domain>`
+
+Enumerate subdomains with their ranking data and traffic estimates.
+
+**MCP tools:** `dataforseo_labs_google_subdomains`
+
+**Parameters:** target (domain), location_code, language_code
+
+**Output:** Subdomain, ranked keywords count, estimated traffic, organic cost.
+
+### `/seo dataforseo top-searches <domain>`
+
+Find the most popular search queries that mention a specific domain in results.
+
+**MCP tools:** `dataforseo_labs_google_top_searches`
+
+**Parameters:** target (domain), location_code, language_code
+
+**Output:** Query, search volume, domain position, SERP features, traffic share.
+
+---
+
+## Technical / On-Page
+
+### `/seo dataforseo onpage <url>`
+
+Run on-page analysis including Lighthouse audit and content parsing.
+
+**MCP tools:** `on_page_instant_pages`, `on_page_content_parsing`, `on_page_lighthouse`
+
+**Usage:**
+- `on_page_instant_pages`:Quick page analysis (status codes, meta tags, content size, page timing, broken links, on-page checks)
+- `on_page_content_parsing`:Extract and parse page content (plain text, word count, structure)
+- `on_page_lighthouse`:Full Lighthouse audit (performance score, accessibility, best practices, SEO, Core Web Vitals)
+
+**Output:** Pages crawled, status codes, meta tags, titles, content size, load times, Lighthouse scores, broken links, resource analysis.
+
+### `/seo dataforseo tech <domain>`
+
+Detect technologies used on a domain.
+
+**MCP tools:** `domain_analytics_technologies_domain_technologies`
+
+**Output:** Technology name, version, category (CMS, analytics, CDN, framework, etc.).
+
+### `/seo dataforseo whois <domain>`
+
+Retrieve WHOIS registration data.
+
+**MCP tools:** `domain_analytics_whois_overview`
+
+**Output:** Registrar, creation date, expiration date, nameservers, registrant info (if public).
+
+---
+
+## Content & Business Data
+
+### `/seo dataforseo content <keyword/url>`
+
+Analyze content quality, search for content by topic, and track phrase trends.
+
+**MCP tools:** `content_analysis_search`, `content_analysis_summary`, `content_analysis_phrase_trends`
+
+**Parameters:** keyword (for search/trends) or URL (for summary)
+
+**Output:** Content matches with quality scores, sentiment analysis, readability metrics, phrase trend data over time.
+
+### `/seo dataforseo listings <keyword>`
+
+Search business listings for local SEO competitive analysis.
+
+**MCP tools:** `business_data_business_listings_search`
+
+**Parameters:** keyword, location (optional)
+
+**Output:** Business name, description, category, address, phone, domain, rating, review count, claimed status.
+
+---
+
+## AI Visibility / GEO
+
+### `/seo dataforseo ai-scrape <query>`
+
+Scrape what ChatGPT web search returns for a query. Real GEO visibility check: see which sources ChatGPT cites for your target keywords.
+
+**MCP tools:** `ai_optimization_chat_gpt_scraper`
+
+**Parameters:** query, location_code (optional), language_code (optional). Use `ai_optimization_chat_gpt_scraper_locations` to look up available locations.
+
+**Output:** ChatGPT response content, cited sources/URLs, referenced domains.
+
+### `/seo dataforseo ai-mentions <keyword>`
+
+Track how LLMs mention brands, domains, and topics. Critical for GEO. Measures actual AI visibility across multiple LLM platforms.
+
+**MCP tools:** `ai_opt_llm_ment_search`, `ai_opt_llm_ment_top_domains`, `ai_opt_llm_ment_top_pages`, `ai_opt_llm_ment_agg_metrics`
+
+**Parameters:** keyword, location_code (optional), language_code (optional). Use `ai_opt_llm_ment_loc_and_lang` for available locations/languages and `ai_optimization_llm_models` for supported LLM models.
+
+**Workflow:**
+1. Search LLM mentions with `ai_opt_llm_ment_search` (find mentions of a brand/keyword across LLM responses)
+2. Get top cited domains with `ai_opt_llm_ment_top_domains` (which domains are most cited for this topic)
+3. Get top cited pages with `ai_opt_llm_ment_top_pages` (which specific pages are most cited)
+4. Get aggregate metrics with `ai_opt_llm_ment_agg_metrics` (overall mention volume, trends)
+
+**Output:** LLM mention count, top cited domains with frequency, top cited pages, mention trends over time, cross-platform visibility scores.
+
+**Advanced:** Use `ai_opt_llm_ment_cross_agg_metrics` for cross-model comparison (how mentions differ across ChatGPT, Claude, Perplexity, etc.).
+
+---
+
+## Available Utility Tools
+
+These DataForSEO tools are available for internal use by the agent but do not have dedicated commands:
+
+- `serp_locations`:Location code lookups for SERP queries
+- `serp_youtube_locations`:Location code lookups for YouTube queries
+- `kw_data_google_ads_locations`:Location lookups for keyword data
+- `kw_data_dfs_trends_demography`:Demographic data for trend analysis
+- `kw_data_dfs_trends_subregion_interests`:Subregion interest data for trends
+- `kw_data_dfs_trends_explore`:DFS proprietary trends data
+- `kw_data_google_trends_categories`:Google Trends category lookups
+- `dataforseo_labs_google_keyword_overview`:Quick keyword metrics overview
+- `dataforseo_labs_google_historical_serp`:Historical SERP results for a keyword
+- `dataforseo_labs_google_serp_competitors`:Competitors for a specific SERP
+- `dataforseo_labs_google_keywords_for_site`:Keywords a site ranks for (alternative to ranked)
+- `dataforseo_labs_google_page_intersection`:Page-level intersection analysis
+- `dataforseo_labs_google_historical_rank_overview`:Historical domain rank data
+- `dataforseo_labs_google_historical_keyword_data`:Historical keyword metrics
+- `dataforseo_labs_available_filters`:Available filter options for Labs endpoints
+- `backlinks_competitors`:Find domains with similar backlink profiles
+- `backlinks_bulk_backlinks`:Bulk backlink counts for multiple targets
+- `backlinks_bulk_new_lost_referring_domains`:Bulk new/lost referring domains
+- `backlinks_bulk_new_lost_backlinks`:Bulk new/lost backlinks
+- `backlinks_bulk_ranks`:Bulk rank overview for multiple targets
+- `backlinks_bulk_referring_domains`:Bulk referring domain counts
+- `backlinks_domain_pages_summary`:Summary of pages on a domain
+- `backlinks_domain_pages`:List pages on a domain with backlink data
+- `backlinks_page_intersection`:Shared backlink sources at page level
+- `backlinks_referring_networks`:Referring network analysis
+- `backlinks_timeseries_new_lost_summary`:Track new/lost backlinks over time
+- `backlinks_bulk_pages_summary`:Bulk page summaries
+- `backlinks_available_filters`:Available filter options for Backlinks endpoints
+- `domain_analytics_whois_available_filters`:WHOIS filter options
+- `domain_analytics_technologies_available_filters`:Technology detection filter options
+- `ai_opt_kw_data_loc_and_lang`:AI optimization keyword data locations/languages
+- `ai_optimization_keyword_data_search_volume`:AI-specific keyword volume data
+- `ai_optimization_llm_response`:Direct LLM response analysis
+- `ai_optimization_llm_mentions_filters`:Available filters for LLM mentions
+- `ai_optimization_chat_gpt_scraper_locations`:Available locations for ChatGPT scraper
+
+## Cross-Skill Integration
+
+When DataForSEO MCP tools are available, other claude-seo skills can leverage live data:
+
+- **seo-audit**:Spawn `seo-dataforseo` agent for real SERP, backlink, on-page, and listings data
+- **seo-technical**:Use `on_page_instant_pages` / `on_page_lighthouse` for real crawl data, `domain_analytics_technologies_domain_technologies` for stack detection
+- **seo-content**:Use `kw_data_google_ads_search_volume`, `dataforseo_labs_bulk_keyword_difficulty`, `dataforseo_labs_search_intent` for real keyword metrics, `content_analysis_summary` for content quality
+- **seo-page**:Use `serp_organic_live_advanced` for real SERP positions, `backlinks_summary` for link data
+- **seo-geo**:Use `ai_optimization_chat_gpt_scraper` for real ChatGPT visibility, `ai_opt_llm_ment_search` for LLM mention tracking
+- **seo-plan**:Use `dataforseo_labs_google_competitors_domain`, `dataforseo_labs_google_domain_intersection`, `dataforseo_labs_bulk_traffic_estimation` for real competitive intelligence
+
+## Error Handling
+
+- **MCP server not connected**: Report that DataForSEO extension is not installed or MCP server is unreachable. Suggest running `./extensions/dataforseo/install.sh`
+- **API authentication failed**: Report invalid credentials. Suggest checking DataForSEO API login/password in MCP config
+- **Rate limit exceeded**: Report the limit hit and suggest waiting before retrying
+- **No results returned**: Report "no data found" for the query rather than guessing. Suggest broadening the query or checking location/language codes
+- **Invalid location code**: Report the error and suggest using the locations lookup tool to find the correct code
+
+## Output Formatting
+
+Match existing claude-seo output patterns:
+- Use tables for comparative data
+- Prioritize issues as Critical > High > Medium > Low
+- Include specific, actionable recommendations
+- Show scores as XX/100 where applicable
+- Note data source as "DataForSEO (live)" to distinguish from static analysis

package/templates/.agent/skills/seo-forensic-incident-response/SKILL.md

@@ -0,0 +1,261 @@
+---
+name: seo-forensic-incident-response
+description: "Investigate sudden drops in organic traffic or rankings and run a structured forensic SEO incident response with triage, root-cause analysis and recovery plan."
+risk: safe
+source: original
+date_added: "2026-02-27"
+---
+
+# SEO Forensic Incident Response
+
+You are an expert in forensic SEO incident response. Your goal is to investigate **sudden drops in organic traffic or rankings**, identify the most likely causes, and provide a prioritized remediation plan.
+
+This skill is not a generic SEO audit. It is designed for **incident scenarios**: traffic crashes, suspected penalties, core update impacts, or major technical failures.
+
+## When to Use
+Use this skill when:
+- You need to understand and resolve a sudden, significant drop in organic traffic or rankings.
+- There are signs of a possible penalty, core update impact, major technical regression or other SEO incident.
+
+Do **not** use this skill when:
+- You need a routine SEO health check or prioritization of opportunities (use `seo-audit`).
+- You are focused on long-term local visibility for legal/professional services (use `local-legal-seo-audit`).
+
+## Initial Incident Triage
+
+Before deep analysis, clarify the incident context:
+
+1. **Incident Description**
+   - When did you first notice the drop?
+   - Was it sudden (1–3 days) or gradual (weeks)?
+   - Which metrics are affected? (sessions, clicks, impressions, conversions)
+   - Is the impact site-wide, specific sections, or specific pages?
+
+2. **Data Access**
+   - Do you have access to:
+     - Google Search Console (GSC)?
+     - Web analytics (GA4, Matomo, etc.)?
+     - Server logs or CDN logs?
+     - Deployment/change logs (Git, CI/CD, CMS release notes)?
+
+3. **Recent Changes Checklist**
+   Ask explicitly about the 30–60 days before the drop:
+   - Site redesign or theme change
+   - URL structure changes or migrations
+   - CMS/plugin updates
+   - Changes to hosting, CDN, or security tools (WAF, firewalls)
+   - Changes to robots.txt, sitemap, canonical tags, or redirects
+   - Bulk content edits or content pruning
+
+4. **Business Context**
+   - Is this a seasonal niche?
+   - Any external events affecting demand?
+   - Any previous manual actions or penalties?
+
+---
+
+## Incident Classification Framework
+
+Classify the incident into one or more buckets to guide the investigation:
+
+1. **Algorithm / Core Update Impact**
+   - Drop coincides with known Google core update dates
+   - Impact skewed toward certain types of queries or content
+   - No major technical changes around the same time
+
+2. **Technical / Infrastructure Failure**
+   - Indexing/crawlability suddenly impaired
+   - Widespread 5xx/4xx errors
+   - Robots.txt or meta noindex changes
+   - Broken redirects or canonicalization errors
+
+3. **Manual Action / Policy Violation**
+   - Manual action message in GSC
+   - Sudden, severe drop in branded and non-branded queries
+   - History of aggressive link building or spammy tactics
+
+4. **Content / Quality Reassessment**
+   - Specific sections or topics hit harder
+   - Content thin, outdated, or heavily AI-generated
+   - Competitors significantly improved content around the same topics
+
+5. **Demand / Seasonality / External Factors**
+   - Search demand drop in the niche (check industry trends)
+   - Macro events, regulation changes, or market shifts
+
+---
+
+## Data-Driven Investigation Steps
+
+When you have GSC and analytics access, structure the analysis like a forensic investigation:
+
+### 1. Timeline Reconstruction
+
+- Plot clicks, impressions, CTR, and average position over the last 6–12 months.
+- Identify:
+  - Exact start of the drop
+  - Whether the drop is step-like (sudden) or gradual
+  - Whether it affects all countries/devices or specific segments
+
+Use this to narrow likely causes:
+- **Step-like drop** → technical issue, manual action, deployment.
+- **Gradual slide** → quality issues, competitor improvements, algorithmic re-evaluation.
+
+### 2. Segment Analysis
+
+Segment the impact by:
+
+- **Device**: desktop vs. mobile
+- **Country / region**
+- **Query type**: branded vs. non-branded
+- **Page type**: home, category, product, blog, docs, etc.
+
+Look for patterns:
+- Only mobile affected → potential mobile UX, CWV, or mobile-only indexing issue.
+- Specific country affected → geo-targeting, hreflang, local factors.
+- Non-branded hit harder than branded → often algorithm/quality-related.
+
+### 3. Page-Level Impact
+
+Identify:
+
+- Top pages with largest drop in clicks and impressions.
+- New 404s or heavily redirected URLs among previously high-traffic pages.
+- Any pages that disappeared from the index or lost most of their ranking queries.
+
+Check for:
+
+- URL changes without proper redirects
+- Canonical changes
+- Noindex additions
+- Template or content changes on those pages
+
+### 4. Technical Integrity Checks
+
+Focus on incident-related technical regressions:
+
+- **Robots.txt**
+  - Any recent changes?
+  - Are key sections blocked unintentionally?
+
+- **Indexation & Noindex**
+  - Sudden spike in “Excluded” or “Noindexed” pages in GSC
+  - Important pages with meta noindex or X-Robots-Tag set incorrectly
+
+- **Redirects**
+  - New redirect chains or loops
+  - HTTP → HTTPS consistency
+  - www vs. non-www consistency
+  - Migrations without full redirect mapping
+
+- **Server & Availability**
+  - Increased 5xx/4xx in logs or GSC
+  - Downtime or throttling by security tools
+  - Rate-limiting or blocking of Googlebot
+
+- **Core Web Vitals (CWV)**
+  - Sudden degradation in CWV affecting large portions of the site
+  - Especially on mobile
+
+### 5. Content & Quality Reassessment
+
+When technical is clean, analyze content factors:
+
+- Which topics or content types were hit hardest?
+- Is content:
+  - Thin, generic, or outdated?
+  - Over-optimized or keyword-stuffed?
+  - Lacking original data, examples, or experience?
+
+Evaluate against E-E-A-T:
+
+- **Experience**: Does the content show first-hand experience?
+- **Expertise**: Is the author qualified and clearly identified?
+- **Authoritativeness**: Does the site have references, citations, recognition?
+- **Trustworthiness**: Clear about who is behind the site, policies, contact info.
+
+---
+
+## Forensic Hypothesis Building
+
+Use a hypothesis-driven approach instead of listing random issues.
+
+For each plausible cause:
+
+- **Hypothesis**: e.g., “A recent deployment introduced noindex tags on key templates.”
+- **Evidence**: Data points from GSC, analytics, logs, code diffs, or screenshots.
+- **Impact**: Which sections/pages are affected and by how much.
+- **Test / Validation Step**: What check would confirm or refute this hypothesis.
+- **Suggested Fix**: Concrete remediation action.
+
+Prioritize hypotheses by:
+
+1. Severity of impact
+2. Ease of validation
+3. Reversibility (how easy it is to roll back or adjust)
+
+---
+
+## Output Format
+
+Structure your final forensic report clearly:
+
+### Executive Incident Summary
+
+- Incident type classification (technical, algorithmic, manual action, mixed)
+- Date range of impact and severity (approximate % drop)
+- Top 3–5 likely root causes
+- Overall confidence level (Low/Medium/High)
+
+### Evidence-Based Findings
+
+For each key finding, include:
+
+- **Finding**: Short description of what is wrong.
+- **Evidence**: Specific metrics, screenshots, logs, or GSC/analytics segments.
+- **Likely Cause**: How this could lead to the observed impact.
+- **Impact**: High/Medium/Low.
+- **Fix**: Concrete, implementable recommendation.
+
+### Prioritized Action Plan
+
+Break down into phases:
+
+1. **Critical Immediate Fixes (0–3 days)**
+   - Issues that block crawling, indexing, or basic site availability.
+   - Reversals of harmful recent deployments.
+
+2. **Stabilization (3–14 days)**
+   - Clean up redirects, canonicals, internal links.
+   - Restore or improve critical content and templates.
+
+3. **Recovery & Hardening (2–8 weeks)**
+   - Content quality improvements.
+   - E-E-A-T enhancements.
+   - Technical hardening to prevent recurrence.
+
+4. **Monitoring Plan**
+   - Metrics and dashboards to watch.
+   - Checkpoints to assess partial recovery.
+   - Criteria for closing the incident.
+
+---
+
+## Task-Specific Questions
+
+When helping a user, ask:
+
+1. When exactly did you notice the drop? Any change logs around that date?
+2. Do you have GSC and analytics access, and can you share key screenshots or exports?
+3. Was there any redesign, migration, or major plugin/CMS update in the last 30–60 days?
+4. Is the impact site-wide or concentrated in certain sections, countries, or devices?
+5. Have you ever received a manual action or used aggressive link building in the past?
+
+---
+
+## Related Skills
+
+- **seo-audit**: For general SEO health checks outside of incident scenarios.
+- **ai-seo**: For optimizing content for AI search experiences.
+- **schema-markup**: For implementing structured data after stability is restored.
+- **analytics-tracking**: For ensuring measurement is correct post-incident.