seo-audit-orchestration

$npx mdskill add rampstackco/claude-skills/seo-audit-orchestration

Orchestrates a full SEO audit suite and produces a rollup report.

  • Runs comprehensive SEO audits for quarterly health checks or due diligence.
  • Depends on Ahrefs MCP and sibling audit skills for data collection.
  • Sequences child skills in a defined order based on audit scope.
  • Delivers a synthesized rollup report covering all audit dimensions.

SKILL.md

.github/skills/seo-audit-orchestrationView on GitHub ↗
---
name: seo-audit-orchestration
description: "Master orchestrator for a full SEO audit suite powered by the Ahrefs MCP. Use this skill when running a comprehensive SEO audit, scoping a quarterly health check, doing pre-acquisition SEO due diligence, or post-migration verification. Triggers on full SEO audit, comprehensive SEO review, SEO health check, audit my site, SEO due diligence, audit suite, comprehensive audit, end-to-end SEO. Also triggers when a stakeholder wants the complete picture rather than a single-dimension audit."
category: seo-audit-suite
catalog_summary: "Master orchestrator: sequences the suite, produces a rollup report"
display_order: 1
---

# SEO Audit Orchestration

Run a complete SEO audit by sequencing the sibling audit skills in a defined order. Stack-agnostic. Assumes the Ahrefs MCP is connected. Produces a single rollup report that synthesizes findings across backlinks, keywords, content, traffic, technical health, and rankings.

---

## When to use

- Running a full SEO audit (quarterly, biannual, annual)
- Pre-acquisition SEO due diligence
- Post-migration verification (after content move, replatform, or domain change)
- Onboarding a new client or new property
- Building a baseline before a major SEO investment
- Diagnosing chronic underperformance

## When NOT to use

- Single-dimension audits (use the specific child skill: `seo-onpage`, `seo-backlink-audit`, etc.)
- Investigating a specific traffic drop (use `seo-traffic-diagnosis`)
- Tactical questions like "which keywords should we target" (use `seo-keyword-gap-audit`)
- Routine monitoring (use `seo-rank-tracking`)

---

## Required inputs

- The site or properties in scope
- Target market and primary languages
- Competitor set (3-5 properties)
- Goal of the audit (baseline, due diligence, fix plan, growth roadmap)
- Time and reporting constraints
- Confirmation that the Ahrefs MCP is connected and the workspace has access to the target property

---

## The framework: 6 phases of an end-to-end audit

A complete audit moves through six phases in order. Skipping phases produces gaps. Reordering them produces rework.

### Phase 1: Scope and baseline

Define the audit before running it.

- What is in scope (subdomains, paths, languages)
- What is out of scope
- Goal of the audit (baseline, fix plan, growth roadmap, due diligence)
- Stakeholders and their priorities
- Reporting format and length expectations

Output: a 1-page audit charter.

### Phase 2: Data gather

Pull the raw data from Ahrefs and any companion sources.

Required pulls:

- Site Explorer: organic keywords, organic traffic, top pages, top countries, referring domains, backlinks, anchor text profile
- Site Audit: full crawl results
- Keywords Explorer: target keyword universe and competitor keyword overlap
- Content Explorer: top performing content in target topics
- Rank Tracker: current tracked positions if set up

Companion pulls (not Ahrefs-native):

- Search Console: query and page data, coverage issues
- Analytics: traffic, conversions, segment by source
- Server logs (if available): bot crawl behavior

Document data freshness for every pull. Stale data yields wrong conclusions.

### Phase 3: Run the sub-audits

Run each child audit. Each produces its own findings doc.

| Sub-audit | Skill | What it produces |
| --- | --- | --- |
| Site health | `seo-site-health-audit` | Prioritized technical fix backlog |
| Backlinks | `seo-backlink-audit` | Profile health, toxic list, reclamation list |
| Keywords | `seo-keyword-gap-audit` | Prioritized opportunity list |
| Content | `seo-content-gap-audit` | Create/update/merge roadmap |
| Page-level | `seo-onpage` | Per-page audit on top pages |
| AI search | `seo-aeo-geo` | AI search readiness gaps |

The child skills do the analysis. This skill sequences them and integrates the outputs.

### Phase 4: Synthesize

Combine findings into themes. A list of 200 issues is not an audit. A list of 5-7 themes is.

Themes typically emerge in categories like:

- Technical foundation gaps that cap upside
- Content depth gaps in priority topics
- Backlink profile concentration risks
- Keyword opportunities the site is leaving on the table
- Cannibalization or thin coverage
- AI search readiness

Each theme should answer: what is happening, why it matters, what is the size of prize, what is the fix.

### Phase 5: Prioritize

Rank the themes. Use a simple impact/effort matrix.

- Quick wins: high impact, low effort. Do now.
- Strategic plays: high impact, high effort. Plan and resource.
- Maintenance: low impact, low effort. Backlog.
- Avoid: low impact, high effort. Drop.

Tie each theme to a measurable target (organic clicks, ranked keywords in target band, conversions from organic).

### Phase 6: Deliver

Produce the rollup report. See [`references/audit-rollup-template.md`](references/audit-rollup-template.md).

Structure:

- Executive summary (1 page)
- Themes and recommendations (5-7 themes, 1 page each)
- Sub-audit findings (linked or appended)
- Roadmap (next 90 days)

Walk stakeholders through it. Get commitment to the next 90 days of work.

---

## Workflow

1. **Charter the audit.** 1-page scope, goal, stakeholders, format.
2. **Confirm Ahrefs MCP access.** Verify the workspace has the target property and recent data.
3. **Pull all data.** Run the gather list in phase 2. Document freshness.
4. **Run each sub-audit.** Use the child skills. Each produces its own findings doc.
5. **Synthesize themes.** 5-7 themes max. Each ties to an impact and a fix.
6. **Prioritize.** Impact/effort matrix. Quick wins surface to the top.
7. **Draft the rollup.** Use the template. Executive summary first.
8. **Review with the team.** Pressure-test conclusions before stakeholder readout.
9. **Deliver.** Walk stakeholders through. Get commitment to next 90 days.
10. **Schedule the next one.** Audits decay. Rerun on a cadence.

---

## Failure patterns

- **Audit without a goal.** Produces a 60-page document nobody reads. Charter the audit first.
- **All findings, no themes.** A list of 200 issues is data, not an audit. Synthesize into themes.
- **Skipping the sub-audits.** Running one big audit instead of six focused ones produces shallow analysis everywhere.
- **No prioritization.** "Here are 47 things to fix" gets nothing fixed. Rank them.
- **Stale data.** Ahrefs index updates on a delay. Note freshness. Do not draw conclusions from week-old movement.
- **Tool worship.** Ahrefs is one source. Search Console, analytics, and logs add ground truth. Triangulate.
- **Audit-to-audit drift.** Running every audit differently makes trends impossible to spot. Standardize the structure.
- **No 90-day roadmap.** Without a plan after the audit, the audit is shelfware.
- **Solo audit.** Audits done alone miss context. Pull in the people who own the work.

---

## Output format

A rollup audit report with:

1. **Executive summary** (1 page).
2. **Audit charter** (scope, goal, methodology).
3. **Themes and recommendations** (5-7 themes, each with what, why, size of prize, fix).
4. **Sub-audit appendix** (linked outputs from each child skill).
5. **90-day roadmap** (sequenced work with owners and targets).
6. **Methodology notes** (data sources, pull dates, caveats).

Total length: 15-30 pages including appendices. Executive summary readable in 5 minutes.

---

## Reference files

- [`references/audit-rollup-template.md`](references/audit-rollup-template.md) - Template for the rollup report including executive summary, theme structure, and roadmap format.

More from rampstackco/claude-skills

SkillDescription
ads-creative-developmentHow to produce ad creative that converts at performance scale. Hook patterns, format selection, video pacing, variation systems, sequential testing methodology, fatigue detection, brand-voice alignment without conversion dilution, and platform-specific creative norms. Triggers on ad creative, ad design, hook patterns, ad video pacing, creative testing, ad variations, creative refresh, creative fatigue, refresh ad creative, video ads for Meta, TikTok creative, LinkedIn ad creative, ad asset library. Also triggers when a team is producing creative at scale, planning a creative test cycle, or auditing why creative is not converting.
ads-performance-analyticsHow to read paid media dashboards without fooling yourself. Attribution models, platform reporting quirks, multi-platform reconciliation, ROAS vs LTV horizon traps, statistical noise in performance metrics, incrementality testing, and the failure modes that produce expensive lessons. Triggers on read paid media dashboard, attribution analysis, ROAS vs LTV, multi-platform reconciliation, ad incrementality, geo holdout, conversion lift study, ghost bidding, paid media reporting, board-deck paid media metrics, blended CAC, MMM, MTA, last-click attribution. Also triggers when a marketer is about to scale, kill, or rebudget a campaign based on platform metrics, or when reconciling platform reports against warehouse revenue.
after-action-reportRun a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons. Use this skill whenever the user wants to run a postmortem, retrospective, AAR, or after-action review on any past event. Triggers on after-action report, AAR, postmortem, retrospective, retro, post-incident review, what went well what didn't, lessons learned, blameless postmortem, root cause analysis, RCA, five whys. Also triggers when the user has just shipped something or just resolved an incident and wants to capture learnings.
ai-content-collaborationHow humans and AI compose in content workflows. Where AI legitimately participates, where humans must own, hybrid workflow patterns, voice ownership preservation, the AI slop problem, disclosure and transparency, team calibration, and the ethics of intellectually honest AI-assisted content production. Triggers on AI content workflow, AI-assisted writing, hybrid content production, AI in editorial, AI slop, AI disclosure, AI usage policy, AI content ethics, voice preservation with AI, team AI calibration. Also triggers when content feels generic despite quality tools, when team AI usage has drifted into inconsistency, or when a regulated or trust-sensitive context requires explicit AI policy.
analytics-strategyDesign measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy. Use this skill whenever the user wants to plan analytics, design dashboards, build event taxonomies, define KPIs, set up tracking, or audit existing measurement. Triggers on analytics strategy, measurement plan, event taxonomy, tracking plan, KPI framework, dashboard design, north star metric, attribution model, conversion tracking, GA4 setup, Mixpanel setup, analytics audit. Also triggers when the user has data but no clear way to use it, or wants to make decisions but doesn't know what to track.
art-directionDirect visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, write a creative direction document, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables.
backup-and-disaster-recoveryPlan and run backups, set recovery objectives, and run disaster recovery drills. Use this skill when defining RPO/RTO targets, designing backup architecture, deciding what to back up and how often, planning for full-region or platform outages, or running a restoration drill. Triggers on backup, restore, RPO, RTO, disaster recovery, DR, business continuity, what if the database is gone, what if our hosting goes down, recovery drill, ransomware planning. Also triggers when an incident reveals a gap in restoration capability.
beta-program-managementRunning closed and open betas that produce real signal. Beta participant selection, structured feedback collection, beta-to-GA decision criteria, and the difference between soft-launch (no structure, no signal), kitchen-sink (everyone in, no actionable feedback), and structured beta (calibrated cohort, intentional feedback loops, clear graduation criteria). Triggers on beta program, alpha test, beta cohort, beta participant, beta feedback, beta to GA decision, design partner, early access program, closed beta, open beta, RC release. Also triggers when a feature is approaching launch and the team needs structured pre-GA validation, when prior betas produced noise rather than signal, or when the team has soft-launched before but wants more structured feedback this time.
brand-archetype-systemApply pre-composed aesthetic archetype defaults to jumpstart brand design work covering color, typography, layout, voice, and imagery direction. Use this skill whenever the user wants a starting point for brand visual and verbal direction, references a brand they want to design near (for example 'something like Stripe' or 'editorial like Linear'), needs to converge faster from many directions to one, or wants known-good defaults for a specific industry vertical. Triggers on archetype, design archetype, brand archetype, near to (brand), in the style of, similar aesthetic, design starting point, brand template, vertical-typical, industry-typical. Also triggers when the user has a brief and wants to map it to a known aesthetic family rather than design from first principles.
brand-discoveryRun upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration. Use this skill at the very start of a brand or website project when the user needs to understand who they're for, who they compete with, what the audience actually needs, and where the brand could plausibly stand. Triggers on brand discovery, audience research, market research, competitive scan, category research, customer research, who is this for, who are we, positioning research, intake, kickoff. Also triggers when a creative brief is requested but the upstream inputs (audience, competitors, problem space) are not yet clear.