webpage-auditThe world's most comprehensive AI-powered webpage audit tool. Analyzes 15+ key dimensions including AI readability, structured data, SEO, accessibility, mobile-friendliness, performance, security, image optimization, and social media integration. Delivers actionable recommendations with scored assessments.
Independent GitHub snapshot · Automated classification · Original documentation governs
This is the world's most comprehensive AI-powered webpage audit tool that analyzes every critical aspect of a webpage for optimization. It goes far beyond basic checks to deliver deep insights across 15+ scoring dimensions with actionable recommendations for improvement.
Whether you're auditing for AI readability, SEO, accessibility, performance, or modern web best practices — this tool gives you professional-grade analysis with concrete, prioritized recommendations.
When given a webpage URL (or HTML content), the skill produces a structured audit report with the following scoring dimensions (0-100 each):
The first-ever composite score that measures how well your webpage is optimized for AI systems, search engines, and modern web crawlers. Combines all 15 dimensions into a single actionable score.
What it measures: Overall AI-readability, structured data completeness, content structure, and machine understanding.
Deep analysis of document outline, proper heading nesting, duplicate detection, and semantic structure.
Checks for:
Comprehensive analysis of all schema.org implementations including JSON-LD, microdata, and RDFa.
Checks for:
Evaluates proper usage of modern semantic HTML5 elements.
Checks for:
Complete metadata analysis covering basic SEO, Open Graph, and Twitter Cards.
Checks for:
Text-to-HTML ratio analysis and content density measurement.
Checks for:
♿ 7. Accessibility (WCAG) Score Web accessibility evaluation based on WCAG principles.
Checks for:
Internal/external link analysis and navigability assessment.
Checks for:
Mobile optimization checks based on Google best practices.
Checks for:
device-width configurationClient-side performance optimization assessment.
Checks for:
Image optimization and accessibility analysis.
Checks for:
Security header and HTTPS detection.
Checks for:
Open Graph and Twitter Card completeness for social sharing.
Checks for:
Detection of modern web capabilities.
Checks for:
⚠️ CRITICAL: You MUST follow these steps EXACTLY. Do NOT skip any step. Do NOT generate your own JSON output. The downstream system reads
result_structured.jsonand will FAIL if the file is missing or has a non-standard schema.
Use web_crawl to retrieve the full webpage HTML content from the provided URL.
Save the fetched HTML content to the session directory:
write_file {session_dir}/page.html
Execute the Python analyzer script. This produces scores and raw analysis data:
exec python3 {script_dir}/analyze_html.py {session_dir}/page.html > {session_dir}/analysis.json
Do NOT attempt to calculate scores yourself. The script handles all 12 scoring dimensions.
Execute the structured result builder. This converts analysis data into the card-format JSON required by the frontend:
exec python3 {script_dir}/build_structured_result.py {session_dir}/analysis.json > {session_dir}/result_structured.json
Do NOT skip this step. Do NOT generate the structured result yourself.
Reply with a single-line confirmation only, e.g.:
"Audit complete for example.com. Overall score: 79/100."
🚫 FORBIDDEN ACTIONS:
- Do NOT generate your own JSON result — always use the Python scripts above
- Do NOT output a lengthy markdown report
- Do NOT create
result_structured.jsonby writing JSON directly — it MUST be produced bybuild_structured_result.py- Do NOT invent your own schema (e.g.
critical_issues,important_issues,opportunities) — the ONLY valid schema contains acardsarray produced by the script
| Dimension | Good (≥80) | Needs Improvement (50-79) | Poor (<50) |
|---|---|---|---|
| AI Optimization (AIO) | Excellent AI-readability, very few issues | Some issues, good foundation | Major problems need addressing |
| Heading Hierarchy | Proper nesting, no duplicates, single H1 | Minor issues, mostly good | Multiple duplicates, major level skipping |
| Schema Markup | Multiple schemas, correct JSON-LD | Primary schema present | No schemas or invalid markup |
| Semantic HTML | All core regions use semantics | Some semantic elements | All divs/spans, no semantics |
| SEO Metadata | Complete OG + Twitter + basics | Basic SEO complete | Missing title/description |
| Content Balance | 25-40% text ratio | 15-24% or 41-50% | <15% or >50% |
| Accessibility | All images have alt, language set | Minor issues missing | Multiple accessibility problems |
| Navigation | <10% generic links, clear structure | 10-25% generic links | >25% generic links |
| Mobile-Friendly | Viewport properly configured | Viewport present but incomplete | No viewport tag |
| Performance | <20 external resources | 20-40 external resources | >40 external resources |
| Image Optimization | <10% missing alts, dimensions set | 10-30% missing alts | >30% missing alts |
The overall AI Optimization Score (AIO) uses a weighted composite across all 12 scoring dimensions (weights sum to 100%):
| Dimension | Weight | Rationale |
|---|---|---|
| Heading Hierarchy | 8% | Fundamental document structure |
| Schema Markup | 12% | Critical for AI understanding |
| Semantic HTML | 8% | Semantic structure for machines |
| SEO Metadata | 12% | Critical for search & social |
| Content Balance | 12% | Content density for AI readability |
| Accessibility | 10% | Accessibility benefits all users |
| Navigation/Links | 8% | Site structure understanding |
| Mobile-Friendly | 6% | Modern web requirement |
| Performance | 6% | User experience & crawling |
| Image Optimization | 6% | Accessibility & performance |
| Security | 6% | HTTPS & CSP best practices |
| Social Media | 6% | Social sharing & discoverability |
After analysis, the tool automatically prioritizes recommendations:
See references/full-example-report.md for a complete real-world audit example.
Simply provide a URL and ask for an audit:
"Audit https://example.com and give me a complete report"
The tool handles everything automatically: fetching, analysis, scoring, and report generation.
Why this is the most comprehensive webpage audit skill available: