Scan Results: https://scan.glintbase.xyz/pxxl-scan
ID: 2f363538-2055-4301-8578-9b57de4eb0d5
74/100
Agent Readiness Score
AI-Friendly Docs
Parseable by AI models but has high token usage or lacks standard machine-readable hooks.
Category Breakdown
Context Optimization11 / 30
Code Block Execution23 / 30
Machine Readability20 / 20
Agent Tooling & MCP20 / 20
Detailed Findings
⚡
Context Optimization
11/30
llms.txt Auto-Discovery
llms-full.txt Consolidated Docs
Markdown Content Negotiation (Accept: text/markdown)
↳ AI Agent Fix Prompt
My documentation is returning excessive HTML to AI agents. Implement server-side content negotiation in my app. When a request includes the header 'Accept: text/markdown', return ONLY the technical content as clean Markdown. Strip completely: navigation menus, footers, cookie banners, sidebar links, breadcrumbs, social sharing buttons, interactive widgets, and any HTML not containing technical content. The response should contain only: - Page title as H1 - Section headings as H2/H3 - Body text - Code blocks with language tags - Parameter tables - No HTML tags, no CSS, no scripts
DOM Cleanliness Ratio (9% markdown/HTML)
↳ AI Agent Fix Prompt
Reduce layout boilerplate (header, footers, scripts) or use Markdown Content Negotiation to strip DOM noise.
🔧
Code Block Execution
23/30
Terminal Prompt Pollution (No "$" prefixes in copyable code)
Dependency & Import Completeness
Dynamic Variable Placeholders
↳ AI Agent Fix Prompt
Replace vague variable hints or hardcoded keys with clean, uppercase environment placeholders (e.g. <YOUR_API_KEY> or process.env.YOUR_API_KEY). Details: Several snippets use vague bracketed placeholders like [domain], [Product Name], and [URL] instead of standardized format like process.env.XYZ or <INSERT_VALUE_HERE>. Only clear examples would be the server-side negotiation snippet which has no secrets, and the OpenAPI/MCP snippets which have no variables.
🔍
Machine Readability
20/20
OpenAPI/Swagger Spec Auto-Discovery
JSON-LD Structured Schema (TechArticle / APIReference / Guide)
All checks passed — this category is agent-ready.
🤖
Agent Tooling & MCP
20/20
Model Context Protocol (MCP) Server Integration
Error Code Diagnostics & Cross-Referencing Index
All checks passed — this category is agent-ready.