local-seo-audit

Check visibility of "$ARGUMENTS" across:

Run accessibility audit with SEO focus (Phase 19)

Generate a prioritized action plan from audit findings

Detect AI-generated content patterns and provide humanization recommendations (Phase 4a)

Run AI visibility & AI SEO audit (Phase 14)

Assess topical authority (Phase 8)

Run backlink & link profile audit (Phase 12)

Run brand SERP & Knowledge Panel audit (Phase 16)

Generate a side-by-side comparison of client vs competitors

Run competitor deep analysis (Phase 1)

Find content gaps vs competitors (Phase 5)

Run content audit (Phase 4)

Run UX & conversion rate audit (Phase 17)

Run entity audit (Phase 9)

Start the audit intake process — collect business information

Run keyword gap analysis (Phase 6)

Run complete local SEO audit (Phase 11)

Run multi-location SEO audit (Phase 21)

Run on-page SEO audit (Phase 3)

Check for Google penalties & manual actions (Phase 20)

Extract and list all quick wins from audit findings

Compile the Master SEO Audit Report from all completed phases

Run reputation & review audit (Phase 15)

Run social media audit (Phase 13)

Run Core Web Vitals & speed audit (Phase 10)

Show current audit progress — which phases are complete

Run complete technical SEO audit (Phase 2)

Build topical map and find gaps (Phase 7)

Run voice search optimization audit (Phase 18)

Autonomously improve SKILL.md files using quality scoring loop (inspired by karpathy/autoresearch)

For a $ARGUMENTS business, generate:

Create a comprehensive SEO content brief for "$ARGUMENTS":

Export audit report as a styled HTML file (no Chrome needed)

Generate a complete GBP optimization checklist and content

Generate a professional PDF report from completed audit findings

Create keyword-to-page mapping document

Run a fast 5-phase SEO health check (Technical, On-Page, Local, Speed, AI)

Generate complete, validated JSON-LD schema markup for $ARGUMENTS.

Run the LOCAL-IMPACT scoring framework on the target business

Run the SERP-TRUST scoring framework on the target website

Launch a complete 21-phase local business SEO audit

Build a complete topical authority map for the business

AI visibility and GEO specialist for Phase 14 (AI SEO & GEO), Phase 16 (Brand SERP & Knowledge Panel), and Phase 18 (Voice Search). Use proactively during full audit Wave 5.

Content audit specialist for Phase 4 (Content Audit), Phase 5 (Content Gaps), Phase 7 (Topical Gaps), and Phase 8 (Topical Authority). Use proactively during full audit Waves 2, 3, and 5.

On-page and keyword specialist for Phase 3 (On-Page SEO), Phase 6 (Keyword Gaps), and Phase 9 (Entity Audit). Use proactively during full audit Waves 2, 3, and 4.

Local SEO specialist for Phase 11 (Local SEO & GBP), Phase 15 (Reputation & Reviews), and Phase 21 (Multi-Location SEO). Use proactively during full audit Waves 4 and 5.

Off-page SEO specialist for Phase 12 (Backlinks & Link Profile), Phase 13 (Social Media), and Phase 17 (UX & CRO). Use proactively during full audit Waves 4 and 5.

Technical SEO specialist for Phase 2 (Technical SEO), Phase 10 (Speed/CWV), and Phase 19 (Accessibility). Use proactively during full audit Waves 2 and 5.

Core identity and expertise for SEO auditing. Activates whenever the user mentions SEO audit, site audit, website analysis, SEO review, or any of the 21 audit phase topics. This foundational skill sets expertise level, behavioral rules, and project path conventions. All audit files write to projects/[slug]/audit/ and reports to projects/[slug]/reports/.

Score a local business using the proprietary 60-item LOCAL-IMPACT framework across 8 dimensions (Listing, Reviews, Citations, Authority, Local Content, Integrated Visibility, Performance, Tracking). 0-3 scale per item, veto checks, normalized 0-100 score. Use /score-local-impact or after audit phases. Output: {AUDIT_DIR}/local-impact-scores.md

Score a website using the proprietary 50-item SERP-TRUST framework across 5 dimensions (Technical Foundation, Ranking Signals, User Experience, Search Authority, Trust & AI Readiness). 0-4 scale per item, veto checks, normalized 0-100. Combines with LOCAL-IMPACT for SEO Health Index. Use /score-serp-trust. Output: {AUDIT_DIR}/serp-trust-scores.md

Handles the initial data collection phase for SEO audits. Activates when the user triggers an audit, mentions starting an SEO review, or provides a business URL for analysis. Collects all required information, creates the project directory structure under projects/[slug]/, validates URL accessibility, and writes intake-data.md as the source of truth for all subsequent phases. Phase 0. Output: {AUDIT_DIR}/intake-data.md

Comprehensive competitor analysis for local SEO audits. Activates when analyzing competitors, comparing businesses, doing competitive research, or assessing competitive landscape. Covers all 9 dimensions of competitor profiling with AI visibility, entity analysis, and SERP feature ownership. Phase 1. Output: {AUDIT_DIR}/competitor-profiles.md

Keyword research and gap analysis. Activates when discussing keywords, keyword gaps, keyword research, search terms, ranking opportunities, low-hanging fruit, keyword mapping, or SERP analysis for local businesses. Phase 6. Output: {AUDIT_DIR}/keyword-gaps.md

Content gap analysis — identifies missing content opportunities vs. competitors. Activates when discussing content gaps, missing topics, content opportunities, competitor content comparison, golden opportunities, AI Overview gaps, or content strategy planning. Phase 5. Output: {AUDIT_DIR}/content-gaps.md

Topical map and gap analysis. Activates when discussing topic gaps, topical maps, content clusters, topic coverage, semantic coverage, topical authority building, or content planning at the topical level. Phase 7. Output: {AUDIT_DIR}/topical-gaps.md

Complete technical SEO audit expertise. Activates for any technical SEO discussion: crawlability, indexation, site architecture, redirects, canonicals, structured data, HTTPS, hreflang, JavaScript rendering, robots.txt, XML sitemaps, Core Web Vitals, or site infrastructure analysis. Phase 2. Output: {AUDIT_DIR}/technical-findings.md

On-page SEO optimization expertise. Activates for title tags, meta descriptions, header tags, content optimization, internal linking, image SEO, E-E-A-T signals, CTAs, AI Overviews optimization, entity optimization, or any page-level SEO analysis. Phase 3. Output: {AUDIT_DIR}/onpage-findings.md

Content quality and strategy assessment. Activates when auditing content, reviewing pages, assessing content quality, checking for thin content, duplicate content, content cannibalization, AI-generated low-quality content, service pages, location pages, blog posts, or FAQ content. Phase 4. Output: {AUDIT_DIR}/content-inventory.md

AI content detection and humanization audit. Activates when discussing AI-generated content, humanizing content, detecting AI writing patterns, E-E-A-T content signals, Google HCS compliance, thin content from AI, "sounds AI-written", content authenticity, or humanizing service pages, location pages, blog posts, or about pages. Phase 4a. Output: {AUDIT_DIR}/ai-content-findings.md

Performance and Core Web Vitals expertise. Activates when discussing page speed, Core Web Vitals, LCP, INP, CLS, TTFB, FCP, performance optimization, image compression, JavaScript optimization, or site speed issues. Phase 10. Output: {AUDIT_DIR}/speed-findings.md

Google penalty and manual action detection. Activates when discussing traffic drops, penalties, manual actions, algorithm updates, deindexation, ranking losses, or suspicious pattern detection. Run this EARLY — a confirmed penalty invalidates all other optimization work until resolved. Phase 20. Output: {AUDIT_DIR}/penalty-findings.md

Web accessibility audit with SEO focus. Activates when discussing WCAG compliance, ADA compliance, accessibility, color contrast, ARIA labels, keyboard navigation, screen reader compatibility, or Core Web Vitals interaction metrics. Phase 19. Output: {AUDIT_DIR}/accessibility-findings.md

Local SEO expertise and audit. Activates for Google Business Profile, GBP optimization, local pack, citations, NAP consistency, reviews, local landing pages, local content, local links, Google Maps, Apple Maps, Bing Places, or service area business discussions. Phase 11. Output: {AUDIT_DIR}/local-findings.md

Entity optimization and Knowledge Graph analysis. Activates when discussing entities, Google Knowledge Graph, entity SEO, NLP entities, schema entities, Wikidata, entity relationships, semantic entities, or E-E-A-T entity signals. Phase 9. Output: {AUDIT_DIR}/entity-findings.md

Multi-location SEO strategy and audit. Activates when the business has multiple physical locations, franchise locations, or serves distinctly different geographic areas. Covers GBP management, location page architecture, citation strategy, and content differentiation per location. Phase 21. Output: {AUDIT_DIR}/multi-location-findings.md

Online reputation analysis and review management strategy. Activates when discussing reviews, reputation, brand sentiment, negative reviews, review management, BBB complaints, Yelp reviews, online reputation strategy, or review generation systems. Phase 15. Output: {AUDIT_DIR}/reputation-findings.md

Brand SERP and Knowledge Panel optimization. Activates when discussing branded search results, Knowledge Panel, brand visibility, sitelinks, SERP real estate for the brand name, or brand narrative control in search. Phase 16. Output: {AUDIT_DIR}/brand-serp-findings.md

AI search visibility and AI SEO optimization. Activates when discussing AI Overviews, AI Mode, AEO, GEO, LLM SEO, ChatGPT visibility, Perplexity mentions, Gemini AI, Copilot, answer engine optimization, generative engine optimization, or any AI search presence topic. Phase 14. Output: {AUDIT_DIR}/ai-seo-findings.md

Voice search and conversational AI optimization. Activates when discussing voice search, Siri, Alexa, Google Assistant, smart speakers, conversational queries, speakable content, "near me" optimization, or AI answer engines. Phase 18. Output: {AUDIT_DIR}/voice-findings.md

Topical authority assessment and building strategy. Activates when discussing domain topical authority, expertise signals, content authority building, Knowledge Graph topic recognition, E-E-A-T content authority, or competitive authority positioning. Phase 8. Output: {AUDIT_DIR}/topical-authority.md

Backlink and link profile analysis. Activates when discussing backlinks, link building, referring domains, anchor text distribution, toxic links, link gaps, digital PR, off-page authority, or link acquisition strategy. Phase 12. Output: {AUDIT_DIR}/backlink-findings.md

Social media presence and SEO signal analysis. Activates when discussing social media profiles, social signals, YouTube SEO, Open Graph tags, social content strategy, engagement, brand consistency across platforms, or social media as an SEO amplifier. Phase 13. Output: {AUDIT_DIR}/social-findings.md

User experience and conversion rate optimization audit. Activates when discussing conversion rate, user experience, bounce rate, form optimization, click-to-call, booking flows, analytics setup, conversion tracking, page layout, or converting visitors into leads. Phase 17. Output: {AUDIT_DIR}/cro-findings.md

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

Generates professionally designed PDF audit reports. Activates when the user requests a PDF report, wants to export audit findings, asks for a printable report, or uses the generate-pdf or export-html commands. Produces a visually stunning HTML report with SVG gauge charts, color-coded severity cards, and professional tables, then converts to PDF. Uses Python script for reliable multi-engine PDF generation. All files saved to {REPORTS_DIR}/.

3 hooks across 3 events