Index of every page on this site: llms.txt
All skills
coreyhaines31 avatar

/seo-audit

@5b2b400
Run it yourself

When the user wants to audit or diagnose SEO, or asks why traffic dropped, a page won't rank, or whether a setup like canonicals, hreflang, or redirects is right: technical SEO, indexing, Google updates, on-page and titles, Core Web Vitals, local SEO. Start here when someone just says their SEO is bad. For pages at scale, see programmatic-seo. For structured data, see schema. For AI search, see ai-seo.

Use this Skill: https://skilld.dev/gh/coreyhaines31/marketingskills/seo-audit

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referenceslocal-seo.md

≈1.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Local SEO

Use this reference when the audit or request is about a local business: Google Business Profile, the map pack, citations, reviews, or location pages.

Help local customers find the right business and turn searches into qualified calls, bookings, and visits. Diagnose the specific location and search context before prescribing changes.

Start With the Business Model

Read existing product context at .agents/product-marketing.md (or .claude/product-marketing.md, including older product-marketing-context.md setups). Ask only for missing facts relevant to the request:

  • Business type: customers visit a storefront, staff travel to customers, both, or online only.
  • Actual operating locations, staffed hours, service coverage, services, and capacity.
  • Website and profile URLs; ownership, verification, duplicates, suspensions, or recent moves.
  • Desired outcome and available evidence: qualified calls, bookings, visits, profile performance, Search Console, and location-level conversion data.

Use the requested scope. A profile description request needs a description, not a compulsory full audit. Without access, provide a provisional plan and identify the evidence needed; never report invented profile findings.

For profile eligibility, address visibility, duplicates, categories, and current feature availability, read profile-and-citations.md. An online-only business needs a different SEO plan. A service area is not a collection of extra storefronts.

Diagnose the Local Search Problem

Keep the two surfaces separate:

Surface Inspect Evidence to retain
Maps / local pack Correct profile, query relevance, searcher distance, reputation Query, observation date, search location, device/context, profile URL
Organic website results Indexation, relevant location/service page, content, internal links Query, page URL, Search Console data where available

Google describes local ranking through relevance, distance, and prominence. Distance varies with the searcher's location; a larger declared service area does not establish a nearer physical location. Do not promise a top-three placement or a fixed ranking uplift.

Compare like with like: the same queries, locations, observation method, and time window. A single search from the owner's office is not evidence of visibility throughout a city. Separate branded from non-branded demand and label estimates, observed facts, and hypotheses.

Prioritize the constraint supported by evidence:

  1. Wrong, ineligible, duplicate, unverified, or suspended profile: resolve the actual issue before adding promotional content.
  2. Customers cannot contact or visit correctly: repair location facts, hours, destination links, and conversion paths.
  3. Relevant demand is not represented: improve accurate categories, service information, and useful location pages.
  4. Weak trust or discovery: address genuine customer feedback, relevant citations, and earned local mentions.

Improve the Profile and Citation Record

Use profile-and-citations.md for the requested profile or listing work. Produce field-level edits grounded in real business facts, with the existing value, proposed value, reason, and missing verification.

Build a canonical location record for the real-world name, public contact details, customer-facing hours, profile ID, and matching location URL. Keep a private operating address separate when customers do not visit it. Never publish a hidden home address merely to satisfy a citation checklist.

Citation cleanup should resolve conflicting identities and customer-facing information. Prioritize relevant maps, local/chamber, and industry listings customers actually use. Correct existing records and merge true duplicates through supported processes before creating more listings. For a software product directory campaign, use directory-submissions; its launch prerequisites and incentive rules are not a local Google review policy.

Earn and Respond to Reviews

Ask customers with genuine experiences for honest feedback through a neutral request and the correct location's review link. Do not select only happy customers, buy reviews, offer incentives, require particular wording, or promise removal of criticism. Google's rules differ from other review platforms (see the referrals skill's review programs reference); read the current Maps review policy.

Example request: "Thanks for choosing [business]. If you'd like to share your experience, you can leave a review here: [location review link]. We welcome your honest feedback."

Reply specifically and courteously. For a complaint, acknowledge the concern and offer an appropriate private contact path without exposing customer, medical, financial, or job details. Report a policy violation through the platform's process; an unfavorable genuine opinion is not automatically removable.

Track recurring feedback and service improvements alongside review volume and recency. A rating target must not become a staff quota for soliciting specified review content.

Build Useful Location and Service Pages

Read location-pages-and-measurement.md when building pages, preparing local schema, or measuring results.

Give each real location a useful destination. A service-area page describes verified service coverage; it must not imply an office that does not exist. Publish a city page only when it adds meaningful local information, evidence, or customer utility. Swapping city names in duplicated text does not create that value.

Route implementation details to the relevant existing skill:

  • The rest of this skill (seo-audit): crawling, indexing, redirects, speed, and technical diagnosis.
  • site-architecture: location hierarchy, navigation, and internal links.
  • programmatic-seo: scaling a justified page pattern backed by real data.
  • schema: markup implementation after choosing accurate, public business facts.
  • ai-seo: visibility in AI answers when that is part of the request.

Return a Decision and an Actionable Artifact

For an audit or plan, return:

  1. Business model and the specific location/search surface assessed.
  2. Findings with source, date, customer impact, confidence, and missing evidence.
  3. Prioritized changes with a responsible owner and a way to verify completion.
  4. The requested artifact: field edits, citation cleanup table, review drafts, location-page outline, or measurement plan.
  5. Follow-up measures tied to qualified customer actions rather than rankings alone.

For narrow requests, deliver the artifact directly and state only the relevant assumptions. Drafting a plan does not itself authorize profile changes, messages to customers, or directory submissions; follow the user's existing authorization for execution.

Sources

Check current platform rules when a recommendation depends on them. The references link directly to the relevant Google documentation, including retired Q&A functionality and the distinction between Schema.org validity and Google rich-result eligibility.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warningtoday5 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    This skill provides a technical SEO audit framework for diagnosing site performance. It includes specific security instructions to prevent the agent from following malicious commands found on external websites during audits. No malicious code or suspicious behaviors were detected.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    2 files scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 5b2b400. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated yesterday
metadata
{
  "version": "2.2.9"
}
  • SEO
  • technical-seo
  • audit
  • on-page
  • crawlability
  • indexation
  • core-web-vitals
  • mobile-friendly
  • schema-markup

README badge

README badge for coreyhaines31/marketingskills/seo-audit

Diagnoses SEO problems on websites by checking crawlability, indexation, speed, mobile-friendliness, on-page elements, and international configurations. The audit walks through technical foundations first, then on-page optimization, and flags common issues like noindex mistakes, canonical conflicts, hreflang errors, and Core Web Vitals problems.

Generated from the current SKILL.md.

Does this skill check for schema markup and structured data?
The skill can identify schema markup issues, but it has a significant limitation: web_fetch and curl cannot reliably detect JSON-LD injected by client-side JavaScript (common in CMS plugins like Yoast or RankMath). For accurate schema detection, use the Google Rich Results Test, browser DevTools, or Screaming Frog instead.
What does this skill prioritize in an audit?
The skill audits in this order: crawlability and indexation, technical foundations (speed, mobile, HTTPS), on-page optimization (titles, headings, content), content quality, and authority/links. It covers robots.txt, XML sitemaps, Core Web Vitals, canonicals, hreflang for multilingual sites, and internal linking.
Does this skill handle international/multilingual sites?
Yes. The skill includes a full international SEO section covering hreflang setup (including self-referencing entries and reciprocal links), canonicalization across locales, locale URL structure, and detection of common errors like cross-locale canonicals or missing x-default entries.
Does this skill require Search Console or analytics access?
Access to Google Search Console and analytics is helpful but not strictly required. The skill can perform initial crawlability and on-page checks without it, but Search Console provides the most accurate indexation and coverage reports.
Does this skill work with any CMS or is it platform-agnostic?
The skill is platform-agnostic and addresses common SEO issues across any site type (SaaS, e-commerce, blog). It notes CMS-specific behaviors (like client-side schema injection in plugins) but does not assume a particular platform.

Generated from the current SKILL.md. These answers refresh after source changes.