Master audit report compilation. Activates when compiling the final audit report, creating deliverables, producing action plans, building roadmaps, or summarizing all audit findings into a single master document. Output: {AUDIT_DIR}/master-report.md
From local-seo-auditnpx claudepluginhub anthropics/claude-plugins-community --plugin local-seo-audit-systemThis skill uses the workspace's default tool permissions.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
The master report is the culmination of all 21 audit phases — the client's definitive reference document for the next 6–12 months of SEO work. A well-structured master report delivers: clear business impact framing (not just technical findings), a prioritized action plan with effort estimates, measurable KPIs, and a roadmap stakeholders can act on. In 2025, the master report must explicitly address AI visibility (AI Overviews, ChatGPT, Perplexity) as a separate strategic dimension — clients increasingly ask "why aren't we showing up in AI answers?"
2025 master report requirements:
| Tool | Purpose | Cost |
|---|---|---|
python3 scripts/report_compiler.py | Compile all phase .md files → master-report.md | Free (local) |
python3 scripts/score_calculator.py --both | Compute LOCAL-IMPACT + SERP-TRUST + SEO Health Index | Free (local) |
python3 scripts/generate_pdf.py | Convert master HTML → PDF (Chrome or WeasyPrint) | Free (local) |
python3 scripts/audit_status.py | Verify all 21 phases complete before compiling | Free (local) |
| Google Search Console | Page-level data for KPI baseline (current traffic) | Free |
| Ahrefs / SEMrush | DR, traffic estimate, keyword count for executive summary | Paid |
# Compile all phase findings into structured master report data
python3 scripts/report_compiler.py --project {PROJECT_DIR} --output {AUDIT_DIR}/master-report.md
Then read all individual phase files to enrich the compiled report:
{AUDIT_DIR}/intake-data.md{AUDIT_DIR}/competitor-profiles.md{AUDIT_DIR}/local-impact-scores.md{AUDIT_DIR}/serp-trust-scores.md{AUDIT_DIR}/*.md filesOverall Site Health: [X]/100 Grade: [A-F]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Technical: [X]/100 Local SEO: [X]/100
On-Page: [X]/100 AI Visibility: [X]/100
Content: [X]/100 Authority: [X]/100
Speed/CWV: [X]/100 Reputation: [X]/100
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(Load from {AUDIT_DIR}/local-impact-scores.md)
Dimension Breakdown:
L Listing Quality [XX/30] ████████░░ [X%]
O Online Reviews [XX/30] ███████░░░ [X%]
C Citation Consistency [XX/30] █████░░░░░ [X%]
A Authority Signals [XX/30] ████████░░ [X%]
L2 Local Content [XX/15] ██████░░░░ [X%]
I Integrated Visibility [XX/15] ███████░░░ [X%]
P Performance [XX/15] ████████░░ [X%]
T Tracking [XX/15] █████░░░░░ [X%]
Veto Checks: [status of all 6 vetoes]
Or compute with: python3 scripts/score_calculator.py --local-impact {AUDIT_DIR}/local-impact-scores.md
(Load from {AUDIT_DIR}/serp-trust-scores.md)
Dimension Breakdown:
T Technical Foundation [XX/40] ████████░░ [X%]
R Ranking Signals [XX/40] ███████░░░ [X%]
U User Experience [XX/40] █████░░░░░ [X%]
S Search Authority [XX/40] ████████░░ [X%]
T2 Trust & AI Readiness [XX/40] ██████░░░░ [X%]
Veto Checks: [status of all 7 vetoes]
Or compute with: python3 scripts/score_calculator.py --serp-trust {AUDIT_DIR}/serp-trust-scores.md
SEO Health Index = (LOCAL-IMPACT [X] × 0.55) + (SERP-TRUST [X] × 0.45) = [X]/100
Status: Excellent | Good | Fair | Poor | Critical
Or compute with: python3 scripts/score_calculator.py --both --li-file {AUDIT_DIR}/local-impact-scores.md --st-file {AUDIT_DIR}/serp-trust-scores.md
All CRITICAL priority issues from all phases, consolidated:
| # | Issue | Phase | Impact | Est. Fix Time |
|---|---|---|---|---|
| 1 | [issue] | [Phase X] | Revenue loss / Rankings loss | [X hours] |
| 2 | [issue] | [Phase X] | [impact] | [X hours] |
| ... |
Expand each critical issue with:
HIGH IMPACT, LOW EFFORT (Do First — Quick Wins):
• [issue/opportunity]
• [issue/opportunity]
• [issue/opportunity]
HIGH IMPACT, HIGH EFFORT (Strategic Priorities):
• [issue/opportunity]
• [issue/opportunity]
LOW IMPACT, LOW EFFORT (Fill When Available):
• [issue/opportunity]
LOW IMPACT, HIGH EFFORT (Deprioritize):
• [issue/opportunity]
Maximum 15 quick wins, ordered by impact:
| # | Quick Win | Page/Section | Expected Impact | Time to Implement |
|---|---|---|---|---|
| 1 | [specific action] | [URL or section] | [specific outcome] | < 1 hour |
| 2 | [specific action] | [URL or section] | [specific outcome] | 1-2 hours |
| ... |
Week 1 — Critical Fixes:
Week 2 — Technical & On-Page:
Week 3 — Local & Content:
Week 4 — Authority & Measurement:
Month 1: Foundation — Fix critical issues, establish tracking, launch content engine Month 2: Acceleration — Content at scale, link acquisition, local authority building Month 3: Optimization — Refine based on data, scale what's working, close keyword gaps
Quarterly milestone targets with specific KPIs:
Where can this business be in 12 months with consistent execution?
| KPI | Current | Month 1 Target | Month 3 Target | Month 6 Target | Tracking Tool |
|---|---|---|---|---|---|
| Organic traffic | [X/mo] | GA4 | |||
| Local pack positions | [rank] | GBP Insights | |||
| Google review count | [X] | GBP | |||
| Google avg. rating | [X.X] | GBP | |||
| Phone call conversions | [X/mo] | CallTracking | |||
| Form submissions | [X/mo] | GA4 | |||
| LOCAL-IMPACT score | [X] | Quarterly audit | |||
| SERP-TRUST score | [X] | Quarterly audit | |||
| SEO Health Index | [X] | Quarterly audit |
By priority:
| Competitor | Overall Score | Key Advantage | Biggest Gap vs. Client |
|---|---|---|---|
| [Comp 1] | [X/100] | [what they do best] | [where they beat client] |
| [Comp 2] | [X/100] | ||
| [Comp 3] | [X/100] |
LOCAL-IMPACT + SERP-TRUST competitor scores included if scored.
One paragraph + key findings per phase, with score and status.
After compiling master report, generate the final PDF:
# Convert HTML master report to PDF
python3 scripts/generate_pdf.py --html {REPORTS_DIR}/master-report.html
# Or use Chrome directly
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
--headless=new --disable-gpu --no-sandbox --print-to-pdf-no-header \
--print-to-pdf="{REPORTS_DIR}/master-report.pdf" \
"file:///absolute/path/{REPORTS_DIR}/master-report.html"
PDF Design for Master Report:
Write final report HTML to {REPORTS_DIR}/master-report.html.
Write final PDF to {REPORTS_DIR}/master-report.pdf.
Write markdown to {AUDIT_DIR}/master-report.md.
| Check | Standard | Status |
|---|---|---|
| All 21 phases included (or N/A noted) | Required | ✅/❌ |
| SEO Health Index computed and displayed | Required | ✅/❌ |
| LOCAL-IMPACT + SERP-TRUST both scored | Required | ✅/❌ |
| AI Overviews section present | Required | ✅/❌ |
| INP used (not FID) in all CWV references | Required | ✅/❌ |
| All recommendations have effort estimates | Required | ✅/❌ |
| All issues have Impact × Feasibility scores | Required | ✅/❌ |
| Competitor benchmarks present in every section | Required | ✅/❌ |
| 30-day plan broken into weekly tasks | Required | ✅/❌ |
| KPI tracking table with current baselines | Required | ✅/❌ |
| Quick wins list (≤ 1 hour each) | Required | ✅/❌ |
| No placeholder text remaining | Required | ✅/❌ |
| Task | Impact (1–5) | Feasibility (1–5) | Priority | Effort |
|---|---|---|---|---|
| Executive summary (3–5 paragraphs, business framing) | 5 | 4 | 20 | 30–60 min |
| SEO Health Index + framework scores display | 5 | 5 | 25 | 15–30 min |
| Critical issues section (all phases consolidated) | 5 | 4 | 20 | 30–60 min |
| Priority matrix (Impact × Effort quadrant) | 5 | 5 | 25 | 15–30 min |
| 30-day action plan (weekly breakdown) | 5 | 4 | 20 | 30–45 min |
| Quick wins list (top 15, impact-ordered) | 4 | 5 | 20 | 20–30 min |
| KPI tracking framework with baselines | 4 | 4 | 16 | 20–30 min |
| AI visibility section (AIO + ChatGPT + Perplexity) | 4 | 5 | 20 | 20–30 min |
| Competitor summary table | 4 | 4 | 16 | 15–20 min |
| 90-day + 6-month roadmap | 3 | 4 | 12 | 20–30 min |
Write to {AUDIT_DIR}/master-report.md with YAML frontmatter:
---
skill: output/report-generation
phase: final
date: [YYYY-MM-DD]
business: [Business Name]
url: [URL]
seo_health_index: [X/100]
local_impact_score: [X/100]
serp_trust_score: [X/100]
phases_completed: [X/21]
critical_issues: [X]
high_issues: [X]
quick_wins: [X]
---
Key consumers:
output/pdf-report — master-report.md → HTML → PDF conversion