Skip to main content
Generalgtmagents

diagnostics

Use for structured technical SEO audits, incident response, and validation.

Stars
259
Source
gtmagents/gtm-agents
Updated
2026-04-03
Slug
gtmagents--gtm-agents--diagnostics
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/gtmagents/gtm-agents/HEAD/plugins/seo-workflow-orchestration/skills/diagnostics/SKILL.md -o .claude/skills/diagnostics.md

Drops the SKILL.md into .claude/skills/diagnostics.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Technical Diagnostics Toolkit Skill

When to Use

  • Investigating crawl/index anomalies, traffic drops, or Core Web Vitals regressions.
  • Running scheduled audits ahead of major launches or migrations.
  • Validating fixes before/after engineering deployments.

Framework

  1. Signal Triangulation – combine Search Console, log files, crawler output, and analytics deltas.
  2. Replication Scripts – document steps to reproduce issues (user agents, locales, device types).
  3. Root Cause Hypotheses – map symptoms to likely causes (render blocking, redirects, robots, schema errors).
  4. Fix Design – outline remediation options, risk level, dependencies, and testing approach.
  5. Validation & Monitoring – specify metrics and alerts to confirm resolution.

Templates

  • Diagnostics worksheet (symptom, evidence, hypothesis, owner, next action).
  • Crawl + render checklist per environment.
  • Validation log capturing metrics pre/post change.

Tips

  • Keep historical baselines to quickly detect regressions.
  • Pair with engineering release notes to correlate incidents.
  • Automate recurring crawls and lighthouse runs to catch issues early.