agent-web-audit

Audit web frontend source code for AI crawler citability and agent operability.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/christian-byrne/comfy-skills --skill agent-web-audit-christian-byrne
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-web-audit
Source: https://github.com/christian-byrne/comfy-skills/tree/main/skills/agent-web-audit
Command: npx skills add https://github.com/christian-byrne/comfy-skills --skill agent-web-audit-christian-byrne

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Web frontends are rarely designed for the two machine audiences that now read them: answer engines deciding whether to cite the content, and AI agents trying to operate the UI. This Skill audits source code to find exactly which lines block crawlers, hide content from fetchers, or make controls unidentifiable to agents. ## Core Features & Use Cases - Static source fingerprinting: A probe script reports render mode (SSR/SSG/SPA), head assembly, descriptor files (robots.txt, llms.txt, sitemap, AGENTS.md), JSON-LD usage, and accessibility-tree surface before any review begins. - Five parallel review lenses: Programmatic path, human handoff, crawler & discovery, extractability, and agent operability — each with dedicated criteria files covering 14 AI crawlers, JSON-LD, citability signals, accessible names, canvas gaps, and export affordances. - Four audit modes: Full repo sweep, PR review lens anchored to diff lines, standalone llms.txt review, and author-facing component guidance. - Use Case: Reviewing a PR that touches robots.txt and head metadata — run the probe, apply the review lens to the diff, and get findings anchored to path:line with severity, instead of generic SEO advice. ## Quick Start Ask the agent to audit this repository's frontend for AI agent and LLM crawler readiness using the agent-web-audit skill.

Frequently Asked Questions about agent-web-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a website for AI agents and LLM crawlers?▼

Run the agent-web-probe.sh script against the repo root to fingerprint render mode, descriptor files, and accessibility surface, then dispatch the five review lenses. Findings are reported as severity, path:line, what breaks, and the fix.

What is the difference between AEO/GEO audit and traditional SEO review?▼

AEO/GEO targets citation by answer engines like ChatGPT, Claude, and Perplexity, which run RAG over embeddings rather than PageRank. Only about 12% of ChatGPT citations match Google's top 10, so good SEO rankings do not imply good citability.

Does this skill score a live deployed URL?▼

No. It is a static source audit that identifies what in the repo causes a score and which line to change. For scoring a live deployed URL, use a dedicated GEO scoring tool instead.

Why is data-testid not a fix for agent accessibility?▼

A data-testid attribute does not appear in the accessibility tree, so agents navigating by role and accessible name cannot see it. It is a test anchor for e2e suites, not an agent affordance; the fix is a proper role and accessible name.

When should AEO findings not be filed on a route?▼

Do not file AEO findings on authenticated or noindex routes that no crawler can reach. A logged-in dashboard scoring badly on citability is correct behavior; the audit first determines which agent paths are structurally open.

How do I review an llms.txt file for correctness?▼

Check destination correctness first: links must resolve unauthenticated, render without JS, and route agents to the CLI, API, or MCP surface when that is the real interface. Then check currency, selection, descriptions, and serving at the root with proper content type.