agent-web-auditlisted
Install: claude install-skill ahmadabdulnasir/agent-ai-readiness
# Agent web audit
This skill audits a web project for how well AI agents and LLMs can read, navigate, and act on it, then applies the fixes. It covers three overlapping concerns that share one root cause:
1. Agent readiness: can an autonomous agent perceive and operate the interface (screenshots, DOM, accessibility tree).
2. Accessibility: the same signals a screen reader needs. Agent-readiness is accessibility restated for a new visitor class, so fixing one fixes both.
3. AI-search legibility: can crawlers reach the content and is it worth citing (GEO/AEO).
The standard this is built on is Google's web.dev "Build agent-friendly websites" guidance (April 2026), the Lighthouse 13.3 "Agentic Browsing" audit (May 2026), and Google's Search Central generative-AI optimization guide (May 2026). The whole point: there is no separate AI layer. Clean, semantic, accessible, crawlable HTML is the entire game.
## What this skill does
Given a web project (whole repo by default, or a folder/file if the user points at one):
1. Size up: detect the stack (plain HTML, React, Next.js, Vue, server templates) and whether Tailwind is in use, since one of the highest-hit issues is Tailwind-version-specific.
2. Scan: run `scripts/scan.sh` to grep for the common machine-readability problems across the whole project.
3. Deep read: open the files the scan flags and confirm each finding against `references/agent-rules.md`.
4. Report: write a findings report grouped by impact, with file:line refere