Tag: SEO

  • geo-seo-claude audit: AI search SEO inside Claude Code

    geo-seo-claude audit: AI search SEO inside Claude Code

    A geo-seo-claude audit brings AI search optimization into Claude Code. The open source skill checks whether a site is easy for ChatGPT, Claude, Perplexity, Gemini, and Google AI Overviews to parse, cite, and connect with a real brand while still keeping normal SEO work in view.

    The short version

    • The project is a Claude Code skill for Generative Engine Optimization, with commands such as /geo audit, /geo quick, /geo citability, /geo crawlers, /geo schema, and /geo llmstxt.
    • Its full audit flow splits work across five analysis tracks: AI visibility, platform readiness, technical SEO, content quality, and schema markup.
    • The scoring model gives the most weight to AI citability, brand authority signals, and content quality rather than old keyword density habits.
    • Treat the numbers as a working checklist, not a universal ranking formula. AI search behavior still varies by platform, query, language, and site type.

    What happened

    The geo-seo-claude repository packages a GEO-first SEO audit workflow for Claude Code users. It installs a main skill, 13 specialized sub-skills, five parallel agent prompts, and Python utilities for fetching pages, scoring citability, scanning brand mentions, checking llms.txt, and generating reports.

    The command list is built for site audits rather than one-off prompt advice. /geo audit <url> runs the fuller workflow. /geo quick <url> gives a faster visibility snapshot. Other commands focus on citation readiness, crawler access, brand mentions, structured data, technical SEO, content quality, platform readiness, and report generation.

    The scoring method is explicit enough to be useful. AI Citability & Visibility gets 25% of the score, Brand Authority Signals and Content Quality & E-E-A-T each get 20%, Technical Foundations gets 15%, and Structured Data plus Platform Optimization get 10% each.

    Why this is worth watching

    The interesting part is the mix of marketing language and real site mechanics. GEO can sound like a new label for content advice, but this project turns it into checks that developers can actually run: robots.txt access for AI crawlers, JSON-LD, site structure, crawler-friendly rendering, and passages that answer questions without needing the rest of the page.

    That matters because AI search changes what a good page fragment looks like. A traditional SEO page can rank well while still being hard for an answer engine to quote cleanly. The repository’s citability section looks for self-contained, fact-rich blocks that answer a question directly. That is a useful pressure test for documentation pages, product pages, pricing pages, and comparison posts.

    There is a risk here too. The README cites market projections, AI-referred traffic growth, and brand-mention correlations, but those numbers should not be treated as a guaranteed playbook for every site. A small SaaS documentation page, a local business page, and a technical blog post will not all earn AI citations the same way.

    For readers tracking these tools, the broader pattern is clear: SEO work is moving closer to developer workflows. Claude Code skills, agent prompts, and audit scripts are becoming a new place where marketers and engineers meet. The IT & AI archive follows that shift as more search, coding, and publishing workflows move into agent-facing tools.

    What the discussion is missing

    There was no public Hacker News thread available for this repository at the time of writing. The missing debate is still easy to predict: what part of GEO is measurable, what part is repackaged SEO, and how much control site owners really have over answer-engine citations.

    The technical questions are the better ones. Does a generated llms.txt file help any major answer engine today, or is it mainly documentation for humans and future crawlers? Are AI crawler allow rules enough if the page renders poorly without JavaScript? Can a site improve citation readiness without flattening every article into sterile answer blocks?

    The practical answer is to test the boring parts first. Check crawler access. Fix broken structured data. Make important pages easy to quote. Then watch real referral logs and brand mentions instead of assuming a single GEO score explains everything.

    The practical read for a geo-seo-claude audit

    A geo-seo-claude audit is most useful as a first-pass map for teams that already use Claude Code. It can help a developer, content lead, and marketer look at the same URL and agree on what to fix first.

    Do not start with llms.txt because it feels new. Start with pages that matter: docs, pricing, product pages, comparison pages, and posts that answer common buyer or developer questions. If those pages lack clear answers, schema, crawl access, or trustworthy attribution, no new file will make them strong AI search candidates.

    The best use case is weekly or monthly review. Run a quick scan, fix the items that are clearly under your control, and compare whether AI search referrals, branded queries, and quoted snippets change over time. The tool gives you a workflow. Your analytics still have to tell you whether it worked.

    Sources

  • Website Specification turns web QA into a 128-point map

    Website Specification turns web QA into a 128-point map

    Website Specification is a new open web checklist that tries to put the boring, easy-to-miss parts of a good site in one place. It covers 128 topics across SEO, accessibility, security, performance, privacy, resilience, internationalisation, and agent-readable surfaces such as Markdown pages and llms.txt.

    The short version

    • Website Specification is platform-agnostic: WordPress, Next.js, Astro, Django, Drupal, plain HTML, and other stacks are meant to be checked against the same list.
    • The project groups 128 topics into 10 areas, including foundations, SEO, accessibility, security, well-known URIs, agent readiness, performance, privacy, resilience, and internationalisation.
    • The useful part is not that every site must pass every item. It is that teams can discuss site quality with a shared map instead of a pile of scattered audit tools.
    • The controversial part is agent readiness. Hacker News readers liked the checklist but argued hard about llms.txt, MCP, and whether machine-facing pages invite abuse.

    What happened

    The Website Specification site describes itself as “a platform-agnostic specification of the technical features every decent website should have.” The home page points to familiar basics, such as <title>, /.well-known/security.txt, WCAG contrast, and llms.txt, then links into a full topic index.

    The index currently lists 128 topics across 10 categories. Foundations alone covers the doctype, <html lang>, UTF-8 charset, viewport, title, meta description, canonical URLs, favicons, theme color, Open Graph tags, feed discovery, and related basics. Other sections move into robots.txt, sitemaps, structured data, WCAG-aligned accessibility checks, security headers, Core Web Vitals, privacy signals, error handling, and language metadata.

    The project is also deliberately machine-readable. It publishes llms.txt, per-page Markdown via .md URLs or Accept: text/markdown, a full llms-full.txt, a public MCP server, and an Agent Skill. That makes the site a reference for humans, but also a test case for how web documentation might expose itself to AI coding tools and audit agents.

    Why this is worth watching

    Most website quality work is fragmented. One audit tool catches missing metadata. Another complains about contrast. A security scanner checks headers. A performance tool cares about images, caching, and script weight. Product teams often end up with a spreadsheet that mixes browser requirements, SEO advice, accessibility obligations, and someone’s personal preferences.

    Website Specification is interesting because it pulls those concerns into one model and cites the underlying sources: WHATWG, W3C, IETF RFCs, WCAG, MDN, IANA, and other web references. That does not make every recommendation equally urgent. It does make the tradeoffs easier to see.

    The agent-readable layer is the part to watch. A checklist that can be queried over MCP or consumed as Markdown is useful for AI-assisted QA, especially for teams building developer tools, site generators, CMS plugins, or agent workflows. If you track this space, the IT & AI archive is a good place to follow similar shifts in web tooling and AI developer infrastructure.

    Website Specification in practice

    For builders, the best use of Website Specification is probably as a deployment review, not a religion. A small landing page may not need every feed, structured data, or internationalisation detail. A public product site, docs site, or media site probably needs many more of them than its team remembers before launch.

    The checklist is also a useful way to split ownership. Engineers can handle headers, status codes, caching, redirects, and HTML correctness. Designers can review contrast, focus states, and readable layouts. Product and growth teams can own metadata, previews, search snippets, and feed behavior. The spec gives those conversations a common vocabulary.

    The weak spot is the same one that makes the project interesting: agent readiness is still unsettled. llms.txt, public MCP endpoints, and agent skills may help tools inspect a site, but they are not equivalent to browser standards or WCAG. Treat them as experiments until real adoption patterns become clearer.

    What Hacker News readers are arguing about

    The Hacker News discussion is split in a useful way. Many readers liked having a single checklist and said they discovered features they had missed, especially around /.well-known/ URLs and older web basics. A few developers with long experience said the list is handy precisely because websites accumulate quiet technical debt.

    The strongest objection is checklist inflation. Several commenters worried that a 128-item list could become another Jira mandate where teams must justify why a simple site does not implement every modern web feature. That is a fair concern. A spec like this is only helpful if teams can mark items as required, recommended, optional, or irrelevant for their context.

    The sharpest argument was about agent readiness. Some readers dismissed llms.txt as unsupported by major AI providers. Others argued that giving agents a separate surface could repeat old SEO problems, where machines see a cleaner or more flattering version of the site than humans do. The practical counterpoint is that plain Markdown, accessible HTML, and predictable URLs also help screen readers, search engines, archivers, and developer tools. The safest reading is boring but useful: make the human site clean first, then expose machine-readable versions only when they match the real content.

    The practical read

    If you run a website, use Website Specification as a triage tool. Start with the items that affect every visitor: valid HTML basics, mobile viewport, titles and descriptions, canonical URLs, accessible contrast and focus states, HTTPS, security headers, useful error pages, and reasonable performance.

    If you build web tooling, the project is more interesting as an interface pattern. A spec exposed through pages, Markdown, llms.txt, MCP, and an agent skill gives coding assistants something concrete to query. That could turn site QA from a vague prompt into a repeatable audit.

    Just do not let the checklist replace judgment. A good website still has to serve its users. The list helps you find gaps; it cannot decide which gaps matter this week.

    Sources