Analyzed URL
https://problemcockpit.com/
Measured 2 hours ago
AI-Ready Score
86
/ 100
Good
out of 100
Token Savings
HTML tokens
10.138
Markdown tokens
360
Savings
96%
Score Breakdown
Accessibility
100/100
AI Discoverability
60/100
Structured Data
100/100
Semantic HTML
94/100
Content Efficiency
70/100
Emerging protocols
0 of 6 detectedWell-known endpoints AI agents look for. Detected here means an agent can discover and connect to your service automatically.
-
OAuth Protected Resource RFC 9728
/.well-known/oauth-protected-resource -
OAuth Discovery RFC 8414
/.well-known/oauth-authorization-server -
MCP Server Card SEP-1649 draft
/.well-known/mcp/server-card.json -
A2A Agent Card A2A v1.0
/.well-known/agent-card.json -
API Catalog RFC 9727
/.well-known/api-catalog -
Agent Skills index Discovery RFC v0.2.0 draft
/.well-known/agent-skills/index.json
Doesn't stay fixed by itself. Monitoring isn't built yet — join the list and we'll tell you when it is.
You're on the list! We'll notify you when it launches.
What we measured No Markdown for Agents support detected
Your site doesn't support Markdown for Agents. This Cloudflare standard lets AI agents request content in markdown format, reducing token usage by ~80%.
How to implement
Implement one or more: (1) Respond to Accept: text/markdown with markdown content. (2) Serve .md URLs (e.g., /page.md). (3) Add <link rel="alternate" type="text/markdown"> tags. (4) Add Link HTTP headers for markdown discovery.
Paste into a coding agent to make the fix
What we measured Content ratio: 4.0% (1416 content chars / 35613 HTML bytes)
Your page has a low ratio of actual content to total HTML. Much of the page weight is markup, scripts, or styles rather than content.
How to implement
Move CSS to external stylesheets, remove inline styles, minimize JavaScript, and ensure the HTML focuses on content structure.
Paste into a coding agent to make the fix
What we measured No llms.txt found
Your site doesn't have an llms.txt file. This is the emerging standard for helping AI agents understand your site structure.
How to implement
Create an /llms.txt file following the llmstxt.org specification. Include a site description and links to your key pages.
Paste into a coding agent to make the fix
What we measured No Content-Signal found (robots.txt or HTTP headers)
No Content-Signal directives found. These tell AI agents how they may use your content (search indexing, AI input, training data). The recommended location is robots.txt.
How to implement
Add Content-Signal to your robots.txt: User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no. You can also add it as an HTTP header on markdown responses.
Paste into a coding agent to make the fix
## Most problem-solving starts too late. A structured excavation that surfaces your assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer. 3 problems solved free. Then $49/month. ## How it works 1 ### Name what's wrong Start with whatever you have -- a hunch, a frustration, a brain dump. Clarity comes from the process, not before it. 2 ### Surface your assumptions The structure finds what you're taking for granted. Hypotheses are tested, not accepted. 3 ### Reach the physics Drill until you hit the irreducible truth -- the constraint that won't move no matter how you reframe it. 4 ### Choose a path forward Fork paths from the real problem, sorted from quick wins to structural change. See how it works ## Layer 00: Intake We keep missing deadlines despite accurate estimates. Happens across teams. ## Find the real problem. For one person 3 problems solved free then $49/month - \--7-stage structured process, not open-ended chat - \--Surfaces your assumptions and strikes through what doesn't hold - \--Fork paths sorted from quick wins to structural change - \--Start even when you can't articulate the problem yet For a whole team 5 seats, one shared history $99/month. Add seats as you grow. - \--The same 7 stages, for everyone on the team - \--The whole team reads every session by default - \--Only the owner can change billing - \--Weeks later, see which decisions actually held up Start with the problem that keeps coming back.
Problem.Cockpit — Stop Solving the Wrong Problem [Skip to content](https://problemcockpit.com/#main-content) [Problem.Cockpit ](https://problemcockpit.com/) [Sign Up](https://problemcockpit.com/sign-up) # Most problem-solving starts too late. A structured excavation that surfaces your assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer. [Start Free](https://problemcockpit.com/sign-up?redirect=/excavate) 3 problems solved free. Then $49/month. ## How it works 1### Name what's wrong Start with whatever you have -- a hunch, a frustration, a brain dump. Clarity comes from the process, not before it. 2### Surface your assumptions The structure finds what you're taking for granted. Hypotheses are tested, not accepted. 3### Reach the physics Drill until you hit the irreducible truth -- the constraint that won't move no matter how you reframe it. 4### Choose a path forward Fork paths from the real problem, sorted from quick wins to structural change. See how it works ## Layer 00: Intake We keep missing deadlines despite accurate estimates. Happens across teams. Next ## Find the real problem. For one person 3 problems solved free then $49/month - \--7-stage structured process, not open-ended chat - \--Surfaces your assumptions and strikes through what doesn't hold - \--Fork paths sorted from quick wins to structural change - \--Start even when you can't articulate the problem yet [Start Free](https://problemcockpit.com/sign-up) For a whole team 5 seats, one shared history $99/month. Add seats as you grow. - \--The same 7 stages, for everyone on the team - \--The whole team reads every session by default - \--Only the owner can change billing - \--Weeks later, see which decisions actually held up [Start a Team](https://problemcockpit.com/team) Start with the problem that keeps coming back.
Upload this file as /index.md on your server so AI agents can access a clean version of your page. You can also configure Accept: text/markdown content negotiation to serve it automatically.
Generated llms.txt for this single page
# Problem.Cockpit > Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer. ## Main - [Problem.Cockpit — Stop Solving the Wrong Problem](https://problemcockpit.com/): Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the sym… - [Gallery](https://problemcockpit.com/gallery) - [Sign In](https://problemcockpit.com/sign-in) - [Sign Up](https://problemcockpit.com/sign-up) ## Blog - [Blog](https://problemcockpit.com/blog) ## Legal - [Terms](https://problemcockpit.com/terms) - [Privacy](https://problemcockpit.com/privacy)
Full llms.txt requires domain-wide analysis (coming soon)
Upload this file to https://problemcockpit.com/llms.txt at the root of your domain. AI agents like ChatGPT, Claude, and Perplexity check this file to understand your site structure.
Accessibility
Content available without JavaScript
(100/100)
Content available without JavaScript
Content appears early in HTML
(100/100)
Main content starts at 18% of HTML
Reasonable page size
(100/100)
Page size: 35KB
AI Discoverability
Robots.txt allows AI bots
(100/100)
All major AI search bots allowed
Markdown for Agents support
(0/100)
✗ Accept: text/markdown
✗ .md URL
✗ <link> tag
✗ Link header
Has sitemap.xml
(100/100)
Sitemap found
Has robots.txt file
(100/100)
robots.txt exists
Has llms.txt file
(0/100)
No llms.txt found
Has Content-Signal (robots.txt or HTTP headers)
(0/100)
✓ robots.txt
✓ HTTP header
✗ Policy
Structured Data
Has Schema.org / JSON-LD
(100/100)
JSON-LD found: Organization, WebSite
Has Open Graph tags
(100/100)
All OG tags present
Has meta description
(100/100)
Meta description: 159 chars
Has canonical URL
(100/100)
Canonical URL present
Has lang attribute
(100/100)
lang="en"
Semantic HTML
Proper heading hierarchy
(100/100)
Clean heading hierarchy
Uses article or main element
(100/100)
Has <main>
Uses semantic HTML elements
(68/100)
8 semantic elements, 31 divs (ratio: 21%)
Meaningful image alt texts
(100/100)
No images found
Low div nesting depth
(100/100)
Avg div depth: 3.3, max: 6
Content Efficiency
Good token reduction ratio
(100/100)
96% token reduction (HTML→Markdown)
Good content-to-noise ratio
(0/100)
Content ratio: 4.0% (1416 content chars / 35613 HTML bytes)
Reasonable page weight
(100/100)
HTML size: 35KB
Minimal inline styles
(100/100)
1/162 elements with inline styles (0.6%)
{
"url": "https://problemcockpit.com/",
"timestamp": 1792412868895,
"fetch": {
"mode": "simple",
"timeMs": 412,
"htmlSizeBytes": 35613,
"supportsMarkdown": false,
"markdownAgents": {
"contentNegotiation": false,
"mdUrl": {
"found": false,
"url": null
},
"linkTag": {
"found": false,
"url": null
},
"linkHeader": {
"found": false,
"url": null
},
"responseHeaders": {
"contentSignal": null,
"xMarkdownTokens": null,
"vary": null
},
"frontmatter": {
"present": false,
"fields": [],
"level": "none"
},
"level": "none"
},
"statusCode": 200
},
"extraction": {
"title": "Problem.Cockpit — Stop Solving the Wrong Problem",
"excerpt": "Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer.",
"byline": null,
"siteName": "Problem.Cockpit",
"lang": "en",
"contentLength": 1416,
"metadata": {
"description": "Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer.",
"ogTitle": "Problem.Cockpit — Stop Solving the Wrong Problem",
"ogDescription": "Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer.",
"ogImage": "https://problemcockpit.com/opengraph-image?1bf0182397b45598",
"ogType": "website",
"canonical": "https://problemcockpit.com",
"lang": "en",
"schemas": [
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Problem.Cockpit",
"url": "https://problemcockpit.com",
"description": "AI-powered root cause excavation for engineering teams."
},
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "Problem.Cockpit",
"url": "https://problemcockpit.com",
"description": "Find the real problem. Not the stated one."
}
],
"robotsMeta": null,
"author": null,
"generator": null,
"markdownAlternateHref": null
}
},
"markdown": "## Most problem-solving starts too late.\n\nA structured excavation that surfaces your assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer.\n\n3 problems solved free. Then $49/month.\n\n## How it works\n\n1\n\n### Name what's wrong\n\nStart with whatever you have -- a hunch, a frustration, a brain dump. Clarity comes from the process, not before it.\n\n2\n\n### Surface your assumptions\n\nThe structure finds what you're taking for granted. Hypotheses are tested, not accepted.\n\n3\n\n### Reach the physics\n\nDrill until you hit the irreducible truth -- the constraint that won't move no matter how you reframe it.\n\n4\n\n### Choose a path forward\n\nFork paths from the real problem, sorted from quick wins to structural change.\n\nSee how it works\n\n## Layer 00: Intake\n\nWe keep missing deadlines despite accurate estimates. Happens across teams.\n\n## Find the real problem.\n\nFor one person\n\n3 problems solved free\n\nthen $49/month\n\n- \\--7-stage structured process, not open-ended chat\n- \\--Surfaces your assumptions and strikes through what doesn't hold\n- \\--Fork paths sorted from quick wins to structural change\n- \\--Start even when you can't articulate the problem yet\n\nFor a whole team\n\n5 seats, one shared history\n\n$99/month. Add seats as you grow.\n\n- \\--The same 7 stages, for everyone on the team\n- \\--The whole team reads every session by default\n- \\--Only the owner can change billing\n- \\--Weeks later, see which decisions actually held up\n\nStart with the problem that keeps coming back.\n",
"fullPageMarkdown": "Problem.Cockpit — Stop Solving the Wrong Problem\n\n[Skip to content](https://problemcockpit.com/#main-content)\n\n[Problem.Cockpit\n\n](https://problemcockpit.com/)\n\n[Sign Up](https://problemcockpit.com/sign-up)\n\n# Most problem-solving starts too late.\n\nA structured excavation that surfaces your assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer.\n\n[Start Free](https://problemcockpit.com/sign-up?redirect=/excavate)\n\n3 problems solved free. Then $49/month.\n\n## How it works\n\n1### Name what's wrong\n\nStart with whatever you have -- a hunch, a frustration, a brain dump. Clarity comes from the process, not before it.\n\n2### Surface your assumptions\n\nThe structure finds what you're taking for granted. Hypotheses are tested, not accepted.\n\n3### Reach the physics\n\nDrill until you hit the irreducible truth -- the constraint that won't move no matter how you reframe it.\n\n4### Choose a path forward\n\nFork paths from the real problem, sorted from quick wins to structural change.\n\nSee how it works\n\n## Layer 00: Intake\n\nWe keep missing deadlines despite accurate estimates. Happens across teams.\n\nNext\n\n## Find the real problem.\n\nFor one person\n\n3 problems solved free\n\nthen $49/month\n\n- \\--7-stage structured process, not open-ended chat\n- \\--Surfaces your assumptions and strikes through what doesn't hold\n- \\--Fork paths sorted from quick wins to structural change\n- \\--Start even when you can't articulate the problem yet\n\n[Start Free](https://problemcockpit.com/sign-up)\n\nFor a whole team\n\n5 seats, one shared history\n\n$99/month. Add seats as you grow.\n\n- \\--The same 7 stages, for everyone on the team\n- \\--The whole team reads every session by default\n- \\--Only the owner can change billing\n- \\--Weeks later, see which decisions actually held up\n\n[Start a Team](https://problemcockpit.com/team)\n\nStart with the problem that keeps coming back.\n",
"markdownStats": {
"images": 0,
"links": 0,
"tables": 0,
"codeBlocks": 0,
"headings": 8
},
"tokens": {
"htmlTokens": 10138,
"markdownTokens": 360,
"reduction": 9778,
"reductionPercent": 96
},
"score": {
"score": 86,
"grade": "B",
"rubricVersion": 3,
"dimensions": {
"accessibility": {
"score": 100,
"weight": 30,
"grade": "A",
"checks": {
"content_without_js": {
"score": 100,
"weight": 55,
"evidence": "proven",
"details": "Content available without JavaScript"
},
"fast_content_position": {
"score": 100,
"weight": 25,
"evidence": "plausible",
"details": "Main content starts at 18% of HTML"
},
"reasonable_page_size": {
"score": 100,
"weight": 20,
"evidence": "plausible",
"details": "Page size: 35KB"
}
}
},
"aiDiscoverability": {
"score": 60,
"weight": 25,
"grade": "C",
"checks": {
"robots_allows_ai_bots": {
"score": 100,
"weight": 35,
"evidence": "proven",
"details": "All major AI search bots allowed"
},
"supports_markdown_negotiation": {
"score": 0,
"weight": 20,
"evidence": "plausible",
"details": "No Markdown for Agents support detected"
},
"has_sitemap": {
"score": 100,
"weight": 15,
"evidence": "plausible",
"details": "Sitemap found"
},
"has_robots_txt": {
"score": 100,
"weight": 10,
"evidence": "plausible",
"details": "robots.txt exists"
},
"has_llms_txt": {
"score": 0,
"weight": 10,
"evidence": "speculative",
"details": "No llms.txt found"
},
"has_content_signals": {
"score": 0,
"weight": 10,
"evidence": "speculative",
"details": "No Content-Signal found (robots.txt or HTTP headers)",
"mechanisms": {
"robotsTxt": false,
"httpHeader": false,
"policy": false
}
}
}
},
"structuredData": {
"score": 100,
"weight": 20,
"grade": "A",
"checks": {
"has_schema_org": {
"score": 100,
"weight": 35,
"evidence": "proven",
"details": "JSON-LD found: Organization, WebSite"
},
"has_open_graph": {
"score": 100,
"weight": 20,
"evidence": "plausible",
"details": "All OG tags present"
},
"has_meta_description": {
"score": 100,
"weight": 20,
"evidence": "plausible",
"details": "Meta description: 159 chars"
},
"has_canonical_url": {
"score": 100,
"weight": 15,
"evidence": "plausible",
"details": "Canonical URL present"
},
"has_lang_attribute": {
"score": 100,
"weight": 10,
"evidence": "plausible",
"details": "lang=\"en\""
}
}
},
"semanticHtml": {
"score": 94,
"weight": 15,
"grade": "A",
"checks": {
"proper_heading_hierarchy": {
"score": 100,
"weight": 30,
"evidence": "plausible",
"details": "Clean heading hierarchy"
},
"uses_article_or_main": {
"score": 100,
"weight": 25,
"evidence": "plausible",
"details": "Has <main>"
},
"semantic_elements": {
"score": 68,
"weight": 20,
"evidence": "plausible",
"details": "8 semantic elements, 31 divs (ratio: 21%)"
},
"meaningful_alt_texts": {
"score": 100,
"weight": 15,
"evidence": "plausible",
"details": "No images found"
},
"low_div_nesting": {
"score": 100,
"weight": 10,
"evidence": "speculative",
"details": "Avg div depth: 3.3, max: 6"
}
}
},
"contentEfficiency": {
"score": 70,
"weight": 10,
"grade": "C",
"checks": {
"token_reduction_ratio": {
"score": 100,
"weight": 40,
"evidence": "speculative",
"details": "96% token reduction (HTML→Markdown)"
},
"content_to_noise_ratio": {
"score": 0,
"weight": 30,
"evidence": "speculative",
"details": "Content ratio: 4.0% (1416 content chars / 35613 HTML bytes)"
},
"reasonable_page_weight": {
"score": 100,
"weight": 20,
"evidence": "speculative",
"details": "HTML size: 35KB"
},
"minimal_inline_styles": {
"score": 100,
"weight": 10,
"evidence": "speculative",
"details": "1/162 elements with inline styles (0.6%)"
}
}
}
}
},
"recommendations": [
{
"id": "add_markdown_negotiation",
"priority": "critical",
"category": "aiDiscoverability",
"titleKey": "rec.add_markdown_negotiation.title",
"descriptionKey": "rec.add_markdown_negotiation.description",
"howToKey": "rec.add_markdown_negotiation.howto",
"howToStepKeys": null,
"effort": "significant",
"estimatedImpact": 5,
"maxImpact": 5,
"evidence": "plausible",
"checkScore": 0,
"checkDetails": "No Markdown for Agents support detected"
},
{
"id": "improve_content_ratio",
"priority": "high",
"category": "contentEfficiency",
"titleKey": "rec.improve_content_ratio.title",
"descriptionKey": "rec.improve_content_ratio.description",
"howToKey": "rec.improve_content_ratio.howto",
"howToStepKeys": null,
"effort": "moderate",
"estimatedImpact": 3,
"maxImpact": 3,
"evidence": "speculative",
"checkScore": 0,
"checkDetails": "Content ratio: 4.0% (1416 content chars / 35613 HTML bytes)"
},
{
"id": "add_llms_txt",
"priority": "high",
"category": "aiDiscoverability",
"titleKey": "rec.add_llms_txt.title",
"descriptionKey": "rec.add_llms_txt.description",
"howToKey": "rec.add_llms_txt.howto",
"howToStepKeys": null,
"effort": "quick-win",
"estimatedImpact": 2.5,
"maxImpact": 2.5,
"evidence": "speculative",
"checkScore": 0,
"checkDetails": "No llms.txt found"
},
{
"id": "add_content_signals",
"priority": "high",
"category": "aiDiscoverability",
"titleKey": "rec.add_content_signals.title",
"descriptionKey": "rec.add_content_signals.description",
"howToKey": "rec.add_content_signals.howto",
"howToStepKeys": null,
"effort": "quick-win",
"estimatedImpact": 2.5,
"maxImpact": 2.5,
"evidence": "speculative",
"checkScore": 0,
"checkDetails": "No Content-Signal found (robots.txt or HTTP headers)"
}
],
"llmsTxtPreview": "# Problem.Cockpit\n\n> Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer.\n\n## Main\n- [Problem.Cockpit — Stop Solving the Wrong Problem](https://problemcockpit.com/): Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the sym…\n- [Gallery](https://problemcockpit.com/gallery)\n- [Sign In](https://problemcockpit.com/sign-in)\n- [Sign Up](https://problemcockpit.com/sign-up)\n\n## Blog\n- [Blog](https://problemcockpit.com/blog)\n\n## Legal\n- [Terms](https://problemcockpit.com/terms)\n- [Privacy](https://problemcockpit.com/privacy)\n\n",
"llmsTxtExisting": null,
"emergingProtocols": {
"oauthProtectedResource": {
"exists": false,
"url": "https://problemcockpit.com/.well-known/oauth-protected-resource"
},
"oauthDiscovery": {
"exists": false,
"url": "https://problemcockpit.com/.well-known/oauth-authorization-server"
},
"mcpServerCard": {
"exists": false,
"url": "https://problemcockpit.com/.well-known/mcp/server-card.json",
"draft": true
},
"a2aAgentCard": {
"exists": false,
"url": "https://problemcockpit.com/.well-known/agent-card.json"
},
"apiCatalog": {
"exists": false,
"url": "https://problemcockpit.com/.well-known/api-catalog"
},
"agentSkills": {
"exists": false,
"url": "https://problemcockpit.com/.well-known/agent-skills/index.json",
"draft": true
},
"count": 0,
"total": 6
},
"botAccess": {
"probed": true,
"bot": "OAI-SearchBot",
"controlStatus": 200,
"botStatus": 200,
"discriminates": false,
"refusedAsBot": false,
"edge": "Vercel",
"verifiable": false,
"detail": "This origin answers OAI-SearchBot exactly as it answers any other client (200). No edge-level filtering of AI crawlers observed."
},
"snippets": [
{
"id": "add_llms_txt",
"title": "Create /llms.txt",
"description": "Upload this file to your web root. It tells AI agents what your site is about and which pages matter.",
"language": "markdown",
"code": "# Problem.Cockpit\n\n> Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the symptom. One conversation. One real answer.\n\n## Main\n- [Problem.Cockpit — Stop Solving the Wrong Problem](https://problemcockpit.com/): Structured root cause excavation that surfaces assumptions, tests them, and names the irreducible truth beneath the sym…\n- [Gallery](https://problemcockpit.com/gallery)\n- [Sign In](https://problemcockpit.com/sign-in)\n- [Sign Up](https://problemcockpit.com/sign-up)\n\n## Blog\n- [Blog](https://problemcockpit.com/blog)\n\n## Legal\n- [Terms](https://problemcockpit.com/terms)\n- [Privacy](https://problemcockpit.com/privacy)\n\n",
"filename": "/llms.txt"
},
{
"id": "add_content_signals",
"title": "Add Content-Signal directives",
"description": "Content-Signal tells AI agents how they may use your content. The canonical location is robots.txt, but you can also expose it as an HTTP header from any stack.",
"language": "txt",
"code": "User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no",
"filename": "/robots.txt",
"stacks": [
{
"id": "robots",
"label": "robots.txt",
"language": "txt",
"filename": "/robots.txt",
"code": "User-agent: *\nContent-Signal: search=yes, ai-input=yes, ai-train=no"
},
{
"id": "nginx",
"label": "Nginx",
"language": "nginx",
"filename": "server block",
"code": "# Inside your server { } block:\nadd_header Content-Signal \"search=yes, ai-input=yes, ai-train=no\" always;"
},
{
"id": "apache",
"label": "Apache",
"language": "apache",
"filename": ".htaccess",
"code": "# In .htaccess (or VirtualHost):\nHeader set Content-Signal \"search=yes, ai-input=yes, ai-train=no\""
},
{
"id": "wordpress",
"label": "WordPress",
"language": "php",
"filename": "functions.php",
"code": "<?php\n// In your theme's functions.php or a small mu-plugin\nadd_action('send_headers', function () {\n header('Content-Signal: search=yes, ai-input=yes, ai-train=no');\n});\n\n// Optional: also append the directive to the dynamic robots.txt\nadd_filter('robots_txt', function ($output) {\n return $output . \"\\nContent-Signal: search=yes, ai-input=yes, ai-train=no\\n\";\n}, 10, 1);"
},
{
"id": "nextjs",
"label": "Next.js",
"language": "typescript",
"filename": "middleware.ts",
"code": "// middleware.ts (Next.js 13+ App Router or Pages Router)\nimport { NextResponse } from 'next/server';\nexport function middleware() {\n const res = NextResponse.next();\n res.headers.set(\n 'Content-Signal',\n 'search=yes, ai-input=yes, ai-train=no'\n );\n return res;\n}\nexport const config = { matcher: '/:path*' };"
},
{
"id": "cloudflare",
"label": "Cloudflare Workers",
"language": "javascript",
"filename": "worker.js",
"code": "// Cloudflare Worker that proxies your origin and adds the header\nexport default {\n async fetch(request, env, ctx) {\n const res = await fetch(request);\n const newRes = new Response(res.body, res);\n newRes.headers.set(\n 'Content-Signal',\n 'search=yes, ai-input=yes, ai-train=no'\n );\n return newRes;\n },\n};"
},
{
"id": "express",
"label": "Express / Fastify",
"language": "javascript",
"filename": "server.js",
"code": "// Express\napp.use((req, res, next) => {\n res.setHeader('Content-Signal', 'search=yes, ai-input=yes, ai-train=no');\n next();\n});\n\n// Fastify\nfastify.addHook('onSend', (request, reply, payload, done) => {\n reply.header('Content-Signal', 'search=yes, ai-input=yes, ai-train=no');\n done();\n});"
}
]
},
{
"id": "add_markdown_negotiation",
"title": "Support Markdown for Agents",
"description": "Let AI agents request a clean Markdown version of any page via content negotiation, .md alternate URLs, link tags or Link headers.",
"language": "html",
"code": "<!-- Mechanism 3: link tag advertising the .md alternate -->\n<link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">",
"filename": "<head>",
"stacks": [
{
"id": "html",
"label": "HTML <head>",
"language": "html",
"filename": "<head>",
"code": "<!-- Mechanism 3: link tag advertising the .md alternate -->\n<link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">"
},
{
"id": "express",
"label": "Express",
"language": "javascript",
"filename": "server.js",
"code": "// Mechanisms 1 + 4: content negotiation + Link header\napp.get('/page', (req, res) => {\n res.setHeader('Vary', 'Accept');\n res.setHeader('Link', '</page.md>; rel=\"alternate\"; type=\"text/markdown\"');\n if ((req.headers.accept || '').includes('text/markdown')) {\n res.type('text/markdown; charset=utf-8');\n return res.send(renderMarkdown('page'));\n }\n res.render('page');\n});"
},
{
"id": "fastify",
"label": "Fastify",
"language": "javascript",
"filename": "server.js",
"code": "// Mechanisms 1 + 4: content negotiation + Link header\nfastify.get('/page', async (req, reply) => {\n reply.header('Vary', 'Accept');\n reply.header('Link', '</page.md>; rel=\"alternate\"; type=\"text/markdown\"');\n if ((req.headers.accept || '').includes('text/markdown')) {\n return reply.type('text/markdown; charset=utf-8').send(renderMarkdown('page'));\n }\n return reply.view('/page.ejs');\n});"
},
{
"id": "nextjs",
"label": "Next.js",
"language": "typescript",
"filename": "app/page/route.ts",
"code": "// Next.js App Router — Route Handler returning Markdown\nimport { NextRequest } from 'next/server';\nimport { renderMarkdown } from '@/lib/md';\nexport async function GET(req: NextRequest) {\n const accept = req.headers.get('accept') || '';\n if (accept.includes('text/markdown')) {\n return new Response(await renderMarkdown('page'), {\n headers: {\n 'Content-Type': 'text/markdown; charset=utf-8',\n 'Vary': 'Accept',\n },\n });\n }\n // Fall through to the page component\n return new Response(null, { status: 404 });\n}"
},
{
"id": "wordpress",
"label": "WordPress",
"language": "php",
"filename": "functions.php",
"code": "<?php\n// Mechanism 1: respond to Accept: text/markdown on the same URL\nadd_action('template_redirect', function () {\n if (!is_singular()) return;\n $accept = $_SERVER['HTTP_ACCEPT'] ?? '';\n if (strpos($accept, 'text/markdown') === false) return;\n header('Content-Type: text/markdown; charset=utf-8');\n header('Vary: Accept');\n $post = get_queried_object();\n echo \"# \" . get_the_title($post) . \"\\n\\n\";\n echo wp_strip_all_tags(apply_filters('the_content', $post->post_content));\n exit;\n});"
},
{
"id": "static",
"label": "Hugo / Jekyll / Astro",
"language": "txt",
"filename": "static/page.md",
"code": "# Mechanism 2: serve .md alongside .html\n# Hugo: place page.md in /static/ — built unchanged\n# Jekyll: drop page.md in /assets/ — copied as-is\n# Astro: src/pages/page.md.ts that exports a GET returning markdown\n\n# Then advertise with mechanism 3 in <head>:\n# <link rel=\"alternate\" type=\"text/markdown\" href=\"/page.md\">"
}
]
}
]
}Use our API to get this programmatically (coming soon)
This JSON is for internal use — unlike the Markdown and llms.txt files, it's not meant to be uploaded to your site. Save it as a baseline to track your score over time, share it with your dev team, or integrate it into your CI/CD pipeline.
Share your results
Or ask an AI to help you fix it
Want a second opinion?
Cloudflare runs a free scanner too, and it asks a different question. It scores what your site publishes for agents to call — MCP server cards, Agent Skills, API catalogs, DNS records. We score whether an agent can reach, read and understand your content. A site can do well on one and poorly on the other, so expect two different numbers: they are answers to two different questions, and both are worth knowing.
Scan problemcockpit.com with CloudflareEmbed your badge
Add this badge to your site. It updates automatically as your AI-readiness score changes.
Script Recommended
<script src="https://agentready.md/badge.js" data-id="b340bbda-7796-4175-a20c-49515ee1d179" data-domain="problemcockpit.com"></script>
Markdown
[](https://agentready.md/r/problemcockpit.com)Coming soon: Full Domain Analysis
Crawl your entire domain, generate llms.txt, and monitor your AI-readiness score over time. Join the waitlist to be notified.
You're on the list! We'll notify you when it launches.