AI Messaging in Concepts and Sidebar

Dgiordano33 · Dgiordano33 · commit a1bcfb265e8b · 2026-03-30T18:08:04.000-04:00
diff --git a/ai/overview.mdx b/ai/overview.mdx
@@ -1,7 +1,7 @@
 ---
 title: 'AI Agents & Coding Assistants'
 description: 'Use AI agents and coding assistants to create, update, and deploy your Checkly monitoring setup with skills and rules.'
-sidebarTitle: 'Overview'
+sidebarTitle: 'Agents & Checkly'
 keywords: ['mcp', 'ai', 'rules', 'generate checks', 'agents', 'context']
 ---
 
@@ -74,3 +74,92 @@ Whether you need to configure your monitoring setup, access check data or declar
 <Tip>
 We are researching additional AI-native workflows. [Let us know in the public roadmap](https://feedback.checklyhq.com/p/checkly-mcp) if you are interested in more agent-friendly integrations.
 </Tip>
+
+## Markdown access
+
+Every page in the Checkly documentation is available as markdown. This makes it easy to feed specific documentation pages into AI assistants like Claude, ChatGPT, Cursor, or any other AI tool.
+
+<Tip>
+Use [Checkly Skills](/ai/skills) to automatically provide your agent with up-to-date, agent-optimized documentation.
+</Tip>
+
+### .md endpoints
+
+Append `.md` to any documentation URL to get the markdown version of that page.
+
+**Example:**
+
+- **HTML:** `https://www.checklyhq.com/docs/what-is-checkly/`
+- **Markdown:** `https://www.checklyhq.com/docs/what-is-checkly.md`
+
+The markdown version includes the full page content in plain markdown, code blocks, links preserved as markdown links, and tables formatted as markdown tables.
+
+```bash
+# Fetch documentation content with curl
+curl https://www.checklyhq.com/docs/what-is-checkly.md
+
+# Pipe directly to your clipboard
+curl https://www.checklyhq.com/docs/what-is-checkly.md | pbcopy
+```
+
+### Content negotiation
+
+You can also request markdown by setting the `Accept` header to `text/markdown`:
+
+```bash
+curl -H "Accept: text/markdown" https://www.checklyhq.com/docs/what-is-checkly/
+```
+
+This is useful when integrating with tools or scripts that set request headers programmatically.
+
+<Tip>
+Modern coding agents set [these headers automatically when querying documentation](https://www.checklyhq.com/blog/state-of-ai-agent-content-negotation/).
+</Tip>
+
+### Copy as Markdown button
+
+Every documentation page includes a **Copy as Markdown** button at the top of the page. Click it to copy the full page content as markdown to your clipboard.
+
+This is the fastest way to grab documentation for a specific topic and paste it into your AI assistant's context.
+
+```text
+Here is the Checkly Browser Checks documentation:
+
+[paste markdown content]
+
+Based on this, how do I set up a browser check with a custom user agent?
+```
+
+
+## LLMs.txt 
+
+
+The [llms.txt standard](https://llmstxt.org/) provides a machine-readable index of all available documentation pages. Checkly publishes an `llms.txt` file at [`checklyhq.com/llms.txt`](https://www.checklyhq.com/llms.txt) that lists every documentation page with its markdown URL and a short description.
+
+```txt llms.txt (first 15 lines)
+# Checkly Docs
+
+## Docs
+
+- [Changing your email or password in Checkly](https://checklyhq.com/docs/admin/changing-your-email-password.md): Learn how to change your email address or password in your Checkly account
+- [Creating an API key in Checkly](https://checklyhq.com/docs/admin/creating-api-key.md): Learn how to create and manage user and service API keys for the Checkly API and CLI
+- [Adding team members to your Checkly account](https://checklyhq.com/docs/admin/team-management/adding-team-members.md): Learn how to invite team members to join your Checkly account and manage team collaboration
+- [Using Microsoft Entra ID for Single Sign-on in Checkly](https://checklyhq.com/docs/admin/team-management/microsoft-azure-ad.md): This page illustrates the standard procedure to follow in order to get started with Microsoft Entra ID SSO (formerly Azure AD) on Checkly.
+- [Multi-Factor Authentication in Checkly](https://checklyhq.com/docs/admin/team-management/multi-factor-authentication.md): Learn how to set up and manage multi-factor authentication for enhanced account security
+- [Using Okta for Single Sign-on in Checkly](https://checklyhq.com/docs/admin/team-management/okta.md): This page illustrates the standard procedure to follow in order to get started with Okta SSO on Checkly.
+- [Role Based Access Control in Checkly](https://checklyhq.com/docs/admin/team-management/rbac.md): Checkly roles and permissions for team members
+- [Removing team members from your Checkly account](https://checklyhq.com/docs/admin/team-management/removing-team-members.md): Learn how to remove team members from your Checkly account and understand how it affects your billing
+- [Using SAML for Single Sign-On in Checkly](https://checklyhq.com/docs/admin/team-management/saml-sso.md): Learn how to set up SAML-based SSO for your Checkly account with supported identity providers
+- [Using SCIM provisioning in Checkly](https://checklyhq.com/docs/admin/team-management/scim-provisioning.md): Learn how to set up SCIM provisioning for Checkly using your identity provider
+- [Team management in Checkly](https://checklyhq.com/docs/admin/team-management.md): Manage your team and collaborate effectively in Checkly
+```
+
+Use the `llms.txt` file to crawl and index the entire Checkly documentation. Every link in the file points to [the `.md` version of the page](/ai/markdown-access#md-endpoints), so you can fetch each URL directly to get the markdown content.
+
+```bash
+# Fetch the llms.txt index
+curl https://www.checklyhq.com/llms.txt
+
+# Fetch a specific page from the index
+curl https://checklyhq.com/docs/detect/synthetic-monitoring/browser-checks/overview.md
+```
diff --git a/ai/rocky-ai.mdx b/ai/rocky-ai.mdx
diff --git a/ai/skills.mdx b/ai/skills.mdx
@@ -1,7 +1,7 @@
 ---
 title: 'Checkly Skills'
 description: 'Install Checkly skills to give your AI agent on-demand monitoring context and capabilities.'
-sidebarTitle: 'Skills'
+sidebarTitle: 'Agent Skills'
 ---
 
 Skills are reusable and modular capabilities for AI agents. They provide procedural knowledge that helps agents accomplish Checkly tasks more effectively. Think of Checkly Skills as plugins or extensions that enhance what your AI agent can do with your monitoring infrastructure.
diff --git a/communicate/overview.mdx b/communicate/overview.mdx
@@ -25,23 +25,10 @@ Schedule and communicate planned maintenance to reduce alert noise
 
 ## Key Benefits
 
-<AccordionGroup>
-<Accordion title="Multi-Channel Alerting">
-Send notifications through email, SMS, Slack, webhooks, and more to ensure critical issues reach the right people.
-</Accordion>
-
-<Accordion title="Transparent Status Communication">
-Build trust with users through branded status pages that provide real-time system status and incident updates.
-</Accordion>
-
-<Accordion title="Customizable Dashboards">
-Create tailored views of monitoring data that match your team's workflow and stakeholder needs.
-</Accordion>
-
-<Accordion title="Intelligent Alert Management">
-Reduce alert fatigue with escalation policies, maintenance windows, and smart notification routing.
-</Accordion>
-</AccordionGroup>
+- **Multi-Channel Alerting** — Send notifications through email, SMS, Slack, webhooks, and more to ensure critical issues reach the right people.
+- **Transparent Status Communication** — Build trust with users through branded status pages that provide real-time system status and incident updates.
+- **Customizable Dashboards** — Create tailored views of monitoring data that match your team's workflow and stakeholder needs.
+- **Intelligent Alert Management** — Reduce alert fatigue with escalation policies, maintenance windows, and smart notification routing.
 
 ## How It Works
 
diff --git a/detect/overview.mdx b/detect/overview.mdx
@@ -23,28 +23,17 @@ Run automated Playwright tests to validate functionality and user workflows befo
 
 ## Key Benefits
 
-<Accordion title="Early, Proactive Issue Detection">
-Identify problems before they impact users through proactive monitoring and testing across all application layers.
-</Accordion>
-
-<Accordion title="Comprehensive, Global Coverage">
-Monitor everything from basic uptime to complex user workflows with multiple monitoring types and global locations.
-</Accordion>
-
-<Accordion title="Historical Performance Insights">
-Track response times, availability percentages, and user experience metrics to optimize application performance.
-</Accordion>
-
-<Accordion title="Automated Validation">
-Reduce manual testing overhead with automated checks that run continuously and provide immediate feedback.
-</Accordion>
+- **Early, Proactive Issue Detection** — Identify problems before they impact users through proactive monitoring and testing across all application layers.
+- **Comprehensive, Global Coverage** — Monitor everything from basic uptime to complex user workflows with multiple monitoring types and global locations.
+- **Historical Performance Insights** — Track response times, availability percentages, and user experience metrics to optimize application performance.
+- **Automated Validation** — Reduce manual testing overhead with automated checks that run continuously and provide immediate feedback.
 
 ## How Checkly Works
 
 <Steps>
 <Step title="Add Monitors to your project">
 Start with the monitoring approach that best fits your immediate needs:
-- Create them inside the Checkly UI 
+- Create them inside the Checkly UI
 - Create them in your repository as [constructs](/constructs)
 </Step>
 
@@ -67,20 +56,12 @@ Once you are happy with your monitoring, you can deploy them to production.
 
 ## Reliability In Depth Strategy
 
-Implement testing and monitoring across multiple layers. Layering all of these approaches provides a comprehensive view of your application's reliability, from the infrastructure layer to the user experience layer. With Checkly, monitor everything from your homepage availability to the most complex user journeys in a single platform.
-
-
-#### Automated Testing
-Run automated unit, integration, and end-to-end Tests to validate functionality and user workflows before production
-
-#### Uptime Monitoring
-Monitor servers, databases, and network connectivity to ensure your applications are available and responsive
-
-#### API Synthetic Monitoring
-Validate API endpoints and microservice communication  
+Implement testing and monitoring across multiple layers for a comprehensive view of your application's reliability, from infrastructure to user experience. With Checkly, monitor everything from homepage availability to the most complex user journeys in a single platform.
 
-#### Browser Synthetic Monitoring
-Validate user journeys and interactions in a real browser environment
+- **Automated Testing** — Run unit, integration, and end-to-end tests to validate functionality and user workflows before production
+- **Uptime Monitoring** — Monitor servers, databases, and network connectivity to ensure availability and responsiveness
+- **API Synthetic Monitoring** — Validate API endpoints and microservice communication
+- **Browser Synthetic Monitoring** — Validate user journeys and interactions in a real browser environment
 
 
 ## Getting Started
@@ -103,4 +84,4 @@ Create comprehensive user experience validation
 
 <Note>
 For maximum reliability, combine all three monitoring approaches. Start with one type and gradually expand your coverage to create a comprehensive monitoring strategy.
-</Note>
+</Note>
diff --git a/docs.json b/docs.json
@@ -4,7 +4,7 @@
   "name": "Checkly Docs",
   "colors": {
     "primary": "#0075FF",
-    "light": "#0075FF",
+    "light": "#2B8AFF",
     "dark": "#031834"
   },
   "seo": {
@@ -22,9 +22,6 @@
     }
   ],
   "integrations": {
-    "intercom": {
-      "appId": "ep3ft8gg"
-    },
     "segment": {
       "key": "Bjlk6vx065LS2B25zVBzcfsjTaGrrpAM"
     },
@@ -104,7 +101,6 @@
                       "platform/runtimes/runtime-specification"
                     ]
                   },
-                  "platform/rocky-ai",
                   "platform/secrets",
                   "platform/dynamic-secret-scrubbing",
                   "platform/data-storage",
@@ -137,8 +133,7 @@
                   },
                   "admin/changing-your-email-password"
                 ]
-              },
-              "changelog/changelog"
+              }
             ]
           },
           {
@@ -297,6 +292,7 @@
             "group": "Resolve",
             "pages": [
               "resolve/overview",
+                "resolve/ai-root-cause-analysis/overview",
               {
                 "group": "Traces",
                 "pages": [
@@ -336,23 +332,17 @@
                     ]
                   }
                 ]
-              },
-              "resolve/ai-root-cause-analysis/overview"
+              }
+            
             ]
           },
           {
             "group": "AI",
             "pages": [
-              {
-                "group": "Agent resources",
-                "pages": [
-                  "ai/overview",
+              "ai/rocky-ai",
+              "ai/overview",
                   "ai/skills",
-                  "ai/markdown-access",
-                  "ai/llms-txt",
                   "ai/rules"
-                ]
-              }
             ]
           },
           {
@@ -523,7 +513,7 @@
         ]
       },
       {
-        "tab": "CLI",
+        "tab": "CLI Reference",
         "pages": [
           {
             "group": "Getting Started",
@@ -564,7 +554,7 @@
         ]
       },
       {
-        "tab": "API",
+        "tab": "API Reference",
         "pages": [
           {
             "group": "Getting Started",
@@ -942,6 +932,12 @@
               "guides/overview"
             ]
           },
+          {
+            "group": "AI and LLMs",
+            "pages": [
+              "guides/agentic-workflows"
+            ]
+          },
           {
             "group": "Monitoring Guides",
             "pages": [
@@ -981,12 +977,7 @@
               "guides/reading-traces"
             ]
           },
-          {
-            "group": "AI and LLMs",
-            "pages": [
-              "guides/agentic-workflows"
-            ]
-          },
+          
           {
             "group": "Advanced Topics",
             "pages": [
@@ -1239,6 +1230,10 @@
       {
         "label": "Home",
         "href": "https://www.checklyhq.com"
+      },
+      {
+        "label": "Changelog",
+        "href": "https://www.checklyhq.com/changelog"
       }
     ],
     "primary": {
diff --git a/resolve/ai-root-cause-analysis/overview.mdx b/resolve/ai-root-cause-analysis/overview.mdx
@@ -1,7 +1,7 @@
 ---
 title: Rocky AI Root Cause Analysis
 description: Automatically perform root cause and user impact analysis with Rocky AI
-sidebarTitle: Rocky AI Root Cause Analysis
+sidebarTitle: AI Root Cause Analysis
 ---
 
 ## What is Rocky AI Root Cause Analysis?
diff --git a/resolve/overview.mdx b/resolve/overview.mdx
@@ -17,23 +17,10 @@ Let Rocky AI analyze errors, metrics, traces and logs and determine impact and r
 
 ## Key Benefits
 
-<AccordionGroup>
-<Accordion title="Fast Root Cause Analysis">
-Identify the exact source of issues with detailed request tracing across your entire application stack.
-</Accordion>
-
-<Accordion title="AI-Powered Insights">
-Get intelligent analysis and recommendations from Rocky AI to resolve incidents faster than ever.
-</Accordion>
-
-<Accordion title="Full Request Visibility">
-See complete request flows from frontend to backend, including database queries and external API calls.
-</Accordion>
-
-<Accordion title="Performance Optimization">
-Identify slow operations and bottlenecks to proactively improve application performance.
-</Accordion>
-</AccordionGroup>
+- **Fast Root Cause Analysis** — Identify the exact source of issues with detailed request tracing across your entire application stack.
+- **AI-Powered Insights** — Get intelligent analysis and recommendations from Rocky AI to resolve incidents faster than ever.
+- **Full Request Visibility** — See complete request flows from frontend to backend, including database queries and external API calls.
+- **Performance Optimization** — Identify slow operations and bottlenecks to proactively improve application performance.
 
 ## Getting Started
 
diff --git a/style.css b/style.css
diff --git a/what-is-checkly.mdx b/what-is-checkly.mdx

Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`"name": "Checkly Docs",`
`5`	`5`	`"colors": {`
`6`	`6`	`"primary": "#0075FF",`
`7`		`- "light": "#0075FF",`
	`7`	`+ "light": "#2B8AFF",`
`8`	`8`	`"dark": "#031834"`
`9`	`9`	`},`
`10`	`10`	`"seo": {`
`@@ -22,9 +22,6 @@`
`22`	`22`	`}`
`23`	`23`	`],`
`24`	`24`	`"integrations": {`
`25`		`- "intercom": {`
`26`		`- "appId": "ep3ft8gg"`
`27`		`- },`
`28`	`25`	`"segment": {`
`29`	`26`	`"key": "Bjlk6vx065LS2B25zVBzcfsjTaGrrpAM"`
`30`	`27`	`},`
`@@ -104,7 +101,6 @@`
`104`	`101`	`"platform/runtimes/runtime-specification"`
`105`	`102`	`]`
`106`	`103`	`},`
`107`		`- "platform/rocky-ai",`
`108`	`104`	`"platform/secrets",`
`109`	`105`	`"platform/dynamic-secret-scrubbing",`
`110`	`106`	`"platform/data-storage",`
`@@ -137,8 +133,7 @@`
`137`	`133`	`},`
`138`	`134`	`"admin/changing-your-email-password"`
`139`	`135`	`]`
`140`		`- },`
`141`		`- "changelog/changelog"`
	`136`	`+ }`
`142`	`137`	`]`
`143`	`138`	`},`
`144`	`139`	`{`
`@@ -297,6 +292,7 @@`
`297`	`292`	`"group": "Resolve",`
`298`	`293`	`"pages": [`
`299`	`294`	`"resolve/overview",`
	`295`	`+ "resolve/ai-root-cause-analysis/overview",`
`300`	`296`	`{`
`301`	`297`	`"group": "Traces",`
`302`	`298`	`"pages": [`
`@@ -336,23 +332,17 @@`
`336`	`332`	`]`
`337`	`333`	`}`
`338`	`334`	`]`
`339`		`- },`
`340`		`- "resolve/ai-root-cause-analysis/overview"`
	`335`	`+ }`
	`336`	`+`
`341`	`337`	`]`
`342`	`338`	`},`
`343`	`339`	`{`
`344`	`340`	`"group": "AI",`
`345`	`341`	`"pages": [`
`346`		`- {`
`347`		`- "group": "Agent resources",`
`348`		`- "pages": [`
`349`		`- "ai/overview",`
	`342`	`+ "ai/rocky-ai",`
	`343`	`+ "ai/overview",`
`350`	`344`	`"ai/skills",`
`351`		`- "ai/markdown-access",`
`352`		`- "ai/llms-txt",`
`353`	`345`	`"ai/rules"`
`354`		`- ]`
`355`		`- }`
`356`	`346`	`]`
`357`	`347`	`},`
`358`	`348`	`{`
`@@ -523,7 +513,7 @@`
`523`	`513`	`]`
`524`	`514`	`},`
`525`	`515`	`{`
`526`		`- "tab": "CLI",`
	`516`	`+ "tab": "CLI Reference",`
`527`	`517`	`"pages": [`
`528`	`518`	`{`
`529`	`519`	`"group": "Getting Started",`
`@@ -564,7 +554,7 @@`
`564`	`554`	`]`
`565`	`555`	`},`
`566`	`556`	`{`
`567`		`- "tab": "API",`
	`557`	`+ "tab": "API Reference",`
`568`	`558`	`"pages": [`
`569`	`559`	`{`
`570`	`560`	`"group": "Getting Started",`
`@@ -942,6 +932,12 @@`
`942`	`932`	`"guides/overview"`
`943`	`933`	`]`
`944`	`934`	`},`
	`935`	`+ {`
	`936`	`+ "group": "AI and LLMs",`
	`937`	`+ "pages": [`
	`938`	`+ "guides/agentic-workflows"`
	`939`	`+ ]`
	`940`	`+ },`
`945`	`941`	`{`
`946`	`942`	`"group": "Monitoring Guides",`
`947`	`943`	`"pages": [`
`@@ -981,12 +977,7 @@`
`981`	`977`	`"guides/reading-traces"`
`982`	`978`	`]`
`983`	`979`	`},`
`984`		`- {`
`985`		`- "group": "AI and LLMs",`
`986`		`- "pages": [`
`987`		`- "guides/agentic-workflows"`
`988`		`- ]`
`989`		`- },`
	`980`	`+`
`990`	`981`	`{`
`991`	`982`	`"group": "Advanced Topics",`
`992`	`983`	`"pages": [`
`@@ -1239,6 +1230,10 @@`
`1239`	`1230`	`{`
`1240`	`1231`	`"label": "Home",`
`1241`	`1232`	`"href": "https://www.checklyhq.com"`
	`1233`	`+ },`
	`1234`	`+ {`
	`1235`	`+ "label": "Changelog",`
	`1236`	`+ "href": "https://www.checklyhq.com/changelog"`
`1242`	`1237`	`}`
`1243`	`1238`	`],`
`1244`	`1239`	`"primary": {`