checkly · stefanjudis · Mar 25, 2026 · Mar 25, 2026 · Mar 25, 2026 · Mar 25, 2026
diff --git a/ai/llms-txt.mdx b/ai/llms-txt.mdx
@@ -0,0 +1,41 @@
+---
+title: 'llms.txt'
+description: 'Use the Checkly llms.txt file to discover and crawl all available documentation pages as markdown.'
+sidebarTitle: '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
+```
+
+## Additional resources
+
+- [Markdown Access](/ai/markdown-access)
+- [Checkly Skills](/ai/skills)
+- [Checkly Rules](/ai/rules)
diff --git a/ai/markdown-access.mdx b/ai/markdown-access.mdx
@@ -0,0 +1,64 @@
+---
+title: 'Markdown Access'
+description: 'Access Checkly documentation as markdown to use with AI assistants and coding agents.'
+sidebarTitle: '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?
+```
+
+
+## Additional resources
+
+- [Checkly Skills](/ai/skills)
+- [Checkly Rules](/ai/rules)
diff --git a/integrations/ai/overview.mdx → ai/overview.mdx b/integrations/ai/overview.mdx → ai/overview.mdx
@@ -44,14 +44,14 @@ Provide the necessary Checkly context and let your AI agent of choice do the res
 
 ## Add Checkly context to your AI agent conversation
 
-Install [Checkly Skills](/integrations/ai/skills) or add the [Checkly Rules](/integrations/ai/rules) to your AI conversation to give your AI agent enough context to perform Checkly-related tasks.
+Install [Checkly Skills](/ai/skills) or add the [Checkly Rules](/ai/rules) to your AI conversation to give your AI agent enough context to perform Checkly-related tasks.
 
 <Columns cols={2}>
-<Card title="Checkly Skills" href="/integrations/ai/skills" cta="Get started">
+<Card title="Checkly Skills" href="/ai/skills" cta="Get started">
 Let your agents pull in all required Checkly context on demand.
 </Card>
 
-<Card title="Checkly Rules" href="/integrations/ai/rules" cta="Get started">
+<Card title="Checkly Rules" href="/ai/rules" cta="Get started">
 Include the entire Checkly context in commands or documentation.
 </Card>
 </Columns>
@@ -67,9 +67,9 @@ Include the entire Checkly context in commands or documentation.
 
 The MCP concept is often used to enable LLMs to interact with external systems. It acts as a bridge between the AI model and the target system, translating natural language commands into actionable API calls or code snippets.
 
-**With Monitoring as Code, Checkly already provides a native way to control your monitoring infrastructure via code and the command line.**
+**With Monitoring as Code and agent-friendly CLI commands, Checkly already provides a native way to control your monitoring infrastructure via code and access monitoring results via the command line.**
 
-Whether you need to create new resources or update existing ones, AI can write and update the necessary construct files and execute the Checkly CLI commands autonomously.
+Whether you need to configure your monitoring setup, access check data or declare incidents, AI can write and update the necessary construct files and execute the Checkly CLI commands autonomously.
 
 <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.

diff --git a/integrations/ai/rules.mdx → ai/rules.mdx b/integrations/ai/rules.mdx → ai/rules.mdx
@@ -1,12 +1,16 @@
 ---
 title: 'Checkly Rules'
 description: 'Add Checkly rules files to your AI agent to provide monitoring context for your coding workflow.'
-sidebarTitle: 'Checkly Rules'
+sidebarTitle: 'Rules'
 ---
 
 import AgentExamples from "/snippets/agent-example.mdx"
 import { YoutubeEmbed } from "/snippets/youtube-embed.jsx"
 
+<Warning>
+Use the Checkly Skills instead if your coding agents supports [Agent Skills](https://agentskills.io).
+</Warning>
+
 The [`checkly.rules.md` file](https://www.checklyhq.com/docs/ai/checkly.rules.md) includes best practices, example code and required CLI commands to give your AI workflow enough context to perform Checkly-related tasks.
 
 Once the Checkly rules are included in your AI context window, your agent can effectively assist you in managing your monitoring setup.

diff --git a/integrations/ai/skills.mdx → ai/skills.mdx b/integrations/ai/skills.mdx → ai/skills.mdx
@@ -1,16 +1,19 @@
 ---
 title: 'Checkly Skills'
 description: 'Install Checkly skills to give your AI agent on-demand monitoring context and capabilities.'
-sidebarTitle: 'Checkly Skills'
+sidebarTitle: '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.
 
 [Agent Skills](https://agentskills.io) are an open standard supported by many AI agents and coding assistants including Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, and others. If your agent supports skills, you can use the Checkly Skills to manage your monitoring setup.
 
-Use [the `skills` CLI](https://www.npmjs.com/package/skills) to install [Checkly skills](https://github.com/checkly/checkly-cli/tree/main/skills/checkly) globally or in your project:
+Use [the Checkly CLI `skills` command](/cli/checkly-skills#checkly-skills-install) to install [Checkly skills](https://github.com/checkly/checkly-cli/tree/main/skills/checkly) globally or in your project:
 
 ```bash
+npx checkly skills install
+
+# or if you prefer the `skills` CLI
 npx skills add checkly/checkly-cli
 ```
 
@@ -32,7 +35,7 @@ This will make the Checkly Skills available to your AI agent. When your agent ne
 ⏺ I'll create a new URLMonitor for example.com!
 ```
 
-Using [Monitoring as Code](/concepts/monitoring-as-code), you can now control your monitoring setup with AI agents without needing a specific MCP server or API for your monitoring. Just give your agent the necessary context and let it use the Checkly Skills to manage your monitoring setup effectively.
+Using [Monitoring as Code](/concepts/monitoring-as-code), you can now control your monitoring setup with AI agents without needing a specific MCP server or API for your monitoring. Tell your agent what you want to do and it will access the necessary context and use the CLI to manage your monitoring setup effectively.
 
 ## Additional resources
 

diff --git a/cli/checkly-skills.mdx b/cli/checkly-skills.mdx
@@ -8,7 +8,7 @@ sidebarTitle: 'checkly skills'
 
 The `checkly skills` command outputs Markdown-formatted context about your Checkly project, describing monitoring capabilities and how to use them programmatically. **This context is designed to be discovered and consumed by AI agents and LLMs**, giving them the information they need to work with your monitoring setup.
 
-You can also install [Checkly Skills as an agent skill](/integrations/ai/skills) to let your AI agent automatically discover and use the `checkly skills` command.
+You can also install [Checkly Skills as an agent skill](/ai/skills) to let your AI agent automatically discover and use the `checkly skills` command.
 
 <Accordion title="Prerequisites">
 Before using `checkly skills`, ensure you have:
@@ -31,6 +31,7 @@ npx checkly skills <action> [resource]
 
 | Action | Description |
 |--------|-------------|
+| `install` | Install [the Checkly agent skill (SKILL.md)](/ai/skills) into your project. |
 | `initialize` | Let your agent initialize [a new Checkly project](/constructs/project). |
 | `configure` | Let your agent configure [Checkly constructs](/constructs/overview). |
 | `investigate` | Access check status, analyze failures, and investigate errors. |

diff --git a/cli/overview.mdx b/cli/overview.mdx
@@ -64,10 +64,10 @@ Checkly is designed to work with Agents, AI IDEs, and Copilots. You can use your
 Checks, Browser Checks and all other constructs.
 
 <Columns cols={2}>
-  <Card title="Checkly Skills" href="/integrations/ai/skills">
+  <Card title="Checkly Skills" href="/ai/skills">
     Install Checkly Skills and let AI agents generate Checkly monitoring code for you.
   </Card>
-  <Card title="Checkly Rules" href="/integrations/ai/rules">
+  <Card title="Checkly Rules" href="/ai/rules">
     Include the Checkly Rules in your conversations to generate Checkly monitoring code for you.
   </Card>
 </Columns>

diff --git a/docs.json b/docs.json
@@ -341,16 +341,23 @@
             ]
           },
           {
-            "group": "Integrations",
+            "group": "AI",
             "pages": [
               {
-                "group": "AI Agents & Coding Assistants",
+                "group": "Agent resources",
                 "pages": [
-                  "integrations/ai/overview",
-                  "integrations/ai/skills",
-                  "integrations/ai/rules"
+                  "ai/overview",
+                  "ai/skills",
+                  "ai/markdown-access",
+                  "ai/llms-txt",
+                  "ai/rules"
                 ]
-              },
+              }
+            ]
+          },
+          {
+            "group": "Integrations",
+            "pages": [
               {
                 "group": "Alerts & Notifications",
                 "pages": [

diff --git a/guides/agentic-workflows.mdx b/guides/agentic-workflows.mdx
@@ -31,7 +31,7 @@ Before your AI assistant can effectively configure Checkly monitoring, it needs
 
 ### Add the Checkly rules file
 
-Download [the official Checkly rules file](/integrations/ai/overview) and add it to your project. This file contains instructions on project structure, CLI commands, links to documentation and code examples for all the different Checkly check types.
+Download [the official Checkly rules file](/ai/overview) and add it to your project. This file contains instructions on project structure, CLI commands, links to documentation and code examples for all the different Checkly check types.
 
 ```md checkly.rules.md
 # Checkly
@@ -498,4 +498,4 @@ As mentioned in the beginning: **Checkly is by definition AI-ready** without com
 - Test your monitoring configuration before deploying. Use `npx checkly test` to validate checks locally before pushing to production.
 - Your AI agent might deploy your monitoring when running in YOLO or `--skip-permissions` mode. Be aware of this risk and implement guard rails.
 
-For complete documentation on AI integrations, see [the AI overview](/integrations/ai/overview).
+For complete documentation on AI integrations, see [the AI overview](/ai/overview).
diff --git a/sitemap-crawl.md b/sitemap-crawl.md
@@ -1,17 +1,17 @@
 # Checkly Docs Sitemap

 This file contains all valid URLs extracted from docs.json organized by directory structure.

 ## Root Pages
 - /what-is-checkly

 ## Quickstarts
 - /quickstarts/url-monitor
 - /quickstarts/browser-check
 - /quickstarts/api-check
 - /quickstarts/multistep-check
 - /quickstarts/heartbeat-monitor
 - /quickstarts/tcp-monitor

 ## Concepts
 - /concepts/checks
@@ -29,7 +29,7 @@
 - /platform/network-diagnostic-tools
 - /platform/managing-false-positives

 ### Platform - Private Locations
 - /platform/private-locations/overview
 - /platform/private-locations/quick-start
 - /platform/private-locations/use-cases
@@ -39,54 +39,54 @@
 - /platform/private-locations/proxy-setup
 - /platform/private-locations/scaling-redundancy

 ### Platform - Reporting
 - /platform/reporting/overview
 - /platform/reporting/analytics-api

 ### Platform - Runtimes
 - /platform/runtimes/overview
 - /platform/runtimes/runtime-specification
 - /platform/runtimes/dependencies

 ## Admin
 - /admin/creating-api-key
 - /admin/changing-your-email-password
 - /admin/data-storage
 - /admin/ip-information

 ### Admin - Team Management
 - /admin/team-management/overview
 - /admin/team-management/adding-team-members
 - /admin/team-management/microsoft-azure-ad
 - /admin/team-management/multi-factor-authentication
 - /admin/team-management/saml
 - /admin/team-management/single-sign-on

 ## Detect
 - /detect/overview

 ### Detect - Uptime Monitoring
 - /detect/uptime-monitoring/overview

 #### Detect - URL Monitors
 - /detect/uptime-monitoring/url-monitors/overview
 - /detect/uptime-monitoring/url-monitors/configuration
 - /detect/uptime-monitoring/url-monitors/creating-your-first-url-monitor

 #### Detect - Heartbeat Monitors
 - /detect/uptime-monitoring/heartbeat-monitors/overview
 - /detect/uptime-monitoring/heartbeat-monitors/creating-your-first-heartbeat-monitor
 - /detect/uptime-monitoring/heartbeat-monitors/examples

 #### Detect - TCP Monitors
 - /detect/uptime-monitoring/tcp-monitors/overview
 - /detect/uptime-monitoring/tcp-monitors/configuration
 - /detect/uptime-monitoring/tcp-monitors/creating-your-first-tcp-monitor

 ### Detect - Synthetic Monitoring
 - /detect/synthetic-monitoring/overview

 #### Detect - API Checks
 - /detect/synthetic-monitoring/api-checks/overview
 - /detect/synthetic-monitoring/api-checks/creating-your-first-api-check
 - /detect/synthetic-monitoring/api-checks/api-structure
@@ -96,7 +96,7 @@
 - /detect/synthetic-monitoring/api-checks/snippets
 - /detect/synthetic-monitoring/api-checks/troubleshooting

 #### Detect - Multistep Checks
 - /detect/synthetic-monitoring/multistep-checks/overview
 - /detect/synthetic-monitoring/multistep-checks/creating-your-first-multistep-check
 - /detect/synthetic-monitoring/multistep-checks/multistep-structure
@@ -105,7 +105,7 @@
 - /detect/synthetic-monitoring/multistep-checks/websockets
 - /detect/synthetic-monitoring/multistep-checks/examples

 #### Detect - Browser Checks
 - /detect/synthetic-monitoring/browser-checks/overview
 - /detect/synthetic-monitoring/browser-checks/creating-a-browser-check
 - /detect/synthetic-monitoring/browser-checks/mac-structure
@@ -117,14 +117,14 @@
 - /detect/synthetic-monitoring/browser-checks/timeouts
 - /detect/synthetic-monitoring/browser-checks/troubleshooting

 #### Detect - Playwright Checks Suite
 - /detect/synthetic-monitoring/playwright-checks/overview
 - /detect/synthetic-monitoring/playwright-checks/quickstart
 - /detect/synthetic-monitoring/playwright-checks/reference
 - /detect/synthetic-monitoring/playwright-checks/add-to-group
 - /detect/synthetic-monitoring/playwright-checks/custom-dependencies

 ### Detect - Testing
 - /detect/testing/overview
 - /detect/testing/creating-your-first-test
 - /detect/testing/using-env-variables
@@ -132,50 +132,50 @@
 ## Communicate
 - /communicate/overview

 ### Communicate - Alerts
 - /communicate/alerts/overview
 - /communicate/alerts/configuration
 - /communicate/alerts/channels
 - /communicate/alerts/retries
 - /communicate/alerts/ssl-expiration
 - /communicate/alerts/notification-log

 ### Communicate - Status Pages
 - /communicate/status-pages/overview
 - /communicate/status-pages/creating-a-status-page
 - /communicate/status-pages/customization
 - /communicate/status-pages/incidents

 ### Communicate - Dashboards
 - /communicate/dashboards/overview
 - /communicate/dashboards/configuration
 - /communicate/dashboards/custom-css
 - /communicate/dashboards/incidents

 ### Communicate - Maintenance Windows
 - /communicate/maintenance-windows/overview

 ## Resolve
 - /resolve/overview
 - /resolve/rocky-ai/overview

 ### Resolve - Traces
 - /resolve/traces/overview
 - /resolve/traces/how-it-works

 #### Resolve - Traces - Importing
 - /resolve/traces/import/overview
 - /resolve/traces/import/open-telemetry
 - /resolve/traces/import/missing-spans
 - /resolve/traces/import/https-grpc

 #### Resolve - Traces - Exporting
 - /resolve/traces/export/grafana-tempo
 - /resolve/traces/export/honeycomb
 - /resolve/traces/export/new-relic
 - /resolve/traces/export/dash0

 #### Resolve - Traces - Instrumentation
 - /resolve/traces/instrumentation/nextjs
 - /resolve/traces/instrumentation/nodejs
 - /resolve/traces/instrumentation/express
@@ -187,14 +187,17 @@
 - /resolve/traces/instrumentation/java
 - /resolve/traces/instrumentation/dotnet
 
-## Integrations
+## AI
+
+- /ai/overview
+- /ai/skills
+- /ai/markdown-access
+- /ai/llms-txt
+- /ai/rules
 
-### Integrations - AI
-- /integrations/ai/overview
-- /integrations/ai/skills
-- /integrations/ai/rules
+## Integrations
 
 ### Integrations - Alerts & Notifications
 - /integrations/alerts/discord
 - /integrations/alerts/email
 - /integrations/alerts/gitlab_alerts
@@ -207,7 +210,7 @@
 - /integrations/alerts/telegram
 - /integrations/alerts/webhooks

 ### Integrations - Incident Management
 - /integrations/incident-management/firehydrant
 - /integrations/incident-management/pagerduty
 - /integrations/incident-management/opsgenie
@@ -221,23 +224,23 @@
 - /integrations/ci-cd/gitlab/overview
 - /integrations/ci-cd/jenkins/overview

 #### Integrations - GitHub
 - /integrations/ci-cd/github/actions
 - /integrations/ci-cd/github/deployments

 #### Integrations - Vercel
 - /integrations/ci-cd/vercel/overview
 - /integrations/ci-cd/vercel/deployment-protection
 - /integrations/ci-cd/vercel/managing-plan

 ### Integrations - Observability
 - /integrations/observability/prometheus
 - /integrations/observability/prometheus-v2
 - /integrations/observability/coralogix

 ### Integrations - Infrastructure as Code

 #### Integrations - Terraform
 - /integrations/iac/terraform/overview
 - /integrations/iac/terraform/alerting
 - /integrations/iac/terraform/maintenance-windows
@@ -248,7 +251,7 @@
 - /integrations/iac/terraform/snippets-variables
 - /integrations/iac/terraform/troubleshooting

 #### Integrations - Pulumi
 - /integrations/iac/pulumi/overview
 - /integrations/iac/pulumi/best-practices
 - /integrations/iac/pulumi/setup
@@ -259,10 +262,10 @@
 - /constructs/quickstart
 - /constructs/including-checks

 ### Constructs - DETECT
 - /constructs/url-monitor
 - /constructs/tcp-monitor
 - /constructs/heartbeat-monitor
 - /constructs/api-check
 - /constructs/multistep-check
 - /constructs/browser-check
@@ -274,7 +277,7 @@
 - /constructs/dashboard
 - /constructs/maintenance-window

 #### Constructs - Alert Channels
 - /constructs/email-alert-channel
 - /constructs/sms-alert-channel
 - /constructs/phone-call-alert-channel
@@ -282,71 +285,71 @@
 - /constructs/msteams-alert-channel
 - /constructs/webhook-alert-channel

 #### Constructs - Status Pages
 - /constructs/status-page
 - /constructs/status-page-service

 ### Constructs - Project & Configuration
 - /constructs/project
 - /constructs/check-group-v2
 - /constructs/check-group

 ## CLI
 - /cli/overview
 - /cli/authentication
 - /cli/basic-workflow
 - /cli/environment-variables
 - /cli/importing

 ### CLI Commands
 - /cli/checkly-deploy
 - /cli/checkly-destroy
 - /cli/checkly-env
 - /cli/checkly-import
 - /cli/checkly-login
 - /cli/checkly-logout
 - /cli/checkly-pw-test
 - /cli/checkly-runtimes
 - /cli/checkly-switch
 - /cli/checkly-sync-playwright
 - /cli/checkly-test
 - /cli/checkly-trigger
 - /cli/checkly-whoami

 ## API Reference

 ### API - Platform
 - /api-reference/authentication

 #### API - Accounts
 - /api-reference/accounts/list
 - /api-reference/accounts/get
 - /api-reference/accounts/me

 #### API - Analytics
 - /api-reference/analytics/metrics
 - /api-reference/analytics/api-checks
 - /api-reference/analytics/browser-checks
 - /api-reference/analytics/heartbeat-checks
 - /api-reference/analytics/multistep-checks
 - /api-reference/analytics/tcp-checks
 - /api-reference/analytics/url-monitors

 #### API - Environment Variables
 - /api-reference/environment-variables/list
 - /api-reference/environment-variables/get
 - /api-reference/environment-variables/create
 - /api-reference/environment-variables/update
 - /api-reference/environment-variables/delete

 #### API - Locations
 - /api-reference/locations/list

 #### API - Runtimes
 - /api-reference/runtimes/list
 - /api-reference/runtimes/get

 #### API - Static IPs
 - /api-reference/static-ips/list
 - /api-reference/static-ips/by-region
 - /api-reference/static-ips/text-format
@@ -354,19 +357,19 @@
 - /api-reference/static-ips/ipv6-by-region
 - /api-reference/static-ips/ipv6-text-format

 #### API - Reporting
 - /api-reference/reporting/generate

 #### API - Snippets
 - /api-reference/snippets/list
 - /api-reference/snippets/get
 - /api-reference/snippets/create
 - /api-reference/snippets/update
 - /api-reference/snippets/delete

 ### API - Detect

 #### API - Checks
 - /api-reference/checks/list
 - /api-reference/checks/get
 - /api-reference/checks/update
@@ -383,10 +386,10 @@
 - /api-reference/checks/tcp-get
 - /api-reference/checks/tcp-update
 - /api-reference/checks/tcp-delete
 - /api-reference/checks/url-create
 - /api-reference/checks/url-get
 - /api-reference/checks/url-update
 - /api-reference/checks/url-delete
 - /api-reference/checks/multistep-create
 - /api-reference/checks/multistep-get
 - /api-reference/checks/multistep-update
@@ -396,30 +399,30 @@
 - /api-reference/checks/heartbeat-update
 - /api-reference/checks/heartbeat-delete

 #### API - Check Groups
 - /api-reference/check-groups/list
 - /api-reference/check-groups/create
 - /api-reference/check-groups/get
 - /api-reference/check-groups/update
 - /api-reference/check-groups/delete

 #### API - Check Results
 - /api-reference/check-results/list
 - /api-reference/check-results/get

 #### API - Check Status
 - /api-reference/check-status/list
 - /api-reference/check-status/get

 #### API - Check Alerts
 - /api-reference/check-alerts/list
 - /api-reference/check-alerts/get

 #### API - Heartbeats
 - /api-reference/heartbeats/list
 - /api-reference/heartbeats/create

 #### API - Private Locations
 - /api-reference/private-locations/list
 - /api-reference/private-locations/create
 - /api-reference/private-locations/get
@@ -430,34 +433,34 @@
 - /api-reference/private-locations/keys-delete
 - /api-reference/private-locations/metrics

 #### API - Badges
 - /api-reference/badges/check-badge
 - /api-reference/badges/group-badge

 #### API - Triggers
 - /api-reference/triggers/trigger-check
 - /api-reference/triggers/trigger-group

 #### API - Heartbeat Events
 - /api-reference/heartbeat-events/list
 - /api-reference/heartbeat-events/get
 - /api-reference/heartbeat-events/availability

 #### API - Client Certificates
 - /api-reference/client-certificates/list
 - /api-reference/client-certificates/get
 - /api-reference/client-certificates/create
 - /api-reference/client-certificates/update
 - /api-reference/client-certificates/delete

 #### API - V2 API
 - /api-reference/v2/check-groups-list
 - /api-reference/v2/check-groups-get
 - /api-reference/v2/check-results-get

 ### API - Communicate

 #### API - Alert Channels
 - /api-reference/alert-channels/list
 - /api-reference/alert-channels/create
 - /api-reference/alert-channels/get
@@ -465,15 +468,15 @@
 - /api-reference/alert-channels/delete
 - /api-reference/alert-channels/subscriptions

 #### API - Alert Notifications
 - /api-reference/alert-notifications/list

 #### API - Dashboards
 - /api-reference/dashboards/list
 - /api-reference/dashboards/get
 - /api-reference/dashboards/create

 #### API - Status Pages
 - /api-reference/status-pages/list
 - /api-reference/status-pages/create
 - /api-reference/status-pages/get
@@ -482,9 +485,9 @@
 #### API - Incidents
 - /api-reference/incidents/list

 ### API - Resolve

 #### API - Maintenance Windows
 - /api-reference/maintenance-windows/list
 - /api-reference/maintenance-windows/create
 - /api-reference/maintenance-windows/get
@@ -494,7 +497,7 @@
 ## Guides
 - /guides/overview

 ### Guides - Monitoring Guides
 - /guides/end-to-end-monitoring
 - /guides/startup-guide-detect-communicate-resolve
 - /guides/getting-started-with-monitoring-as-code
@@ -503,32 +506,32 @@
 - /guides/uptime-monitoring
 - /guides/keyword-monitoring
 - /guides/sdlc-monitoring
 - /guides/create-multiple-monitors

 ### Guides - API Monitoring
 - /guides/monitoring-an-openapi-spec
 - /guides/monitoring-the-stripe-api
 - /guides/setup-scripts-for-apis

 ### Guides - E-commerce Monitoring
 - /guides/monitoring-ecommerce-apps-using-playwright
 - /guides/monitoring-ecommerce-apps-using-terraform

 ### Guides - Playwright Guides
 - /guides/moving-from-puppeteer-to-playwright
 - /guides/developer-fixtures
 - /guides/auto-waiting-methods
 - /guides/reading-traces

 ### Guides - Advanced Topics
 - /guides/claude-code-monitoring
 - /guides/how-to-monitor-broken-links

 ## Learn

 ### Learn - Playwright
 - /learn/playwright/overview
 - /learn/playwright/what-is-playwright
 - /learn/playwright/how-to-set-up-locally
 - /learn/playwright/testing-pyramid
 - /learn/playwright/assertions
@@ -570,7 +573,7 @@
 - /learn/playwright/user-signup-automation
 - /learn/playwright/debugging-errors
 - /learn/playwright/debugging
 - /learn/playwright/error-click-not-executed
 - /learn/playwright/error-element-not-found
 - /learn/playwright/error-element-not-visible
 - /learn/playwright/error-target-closed
@@ -582,7 +585,7 @@
 - /learn/incidents/incident-management-challenges
 - /learn/incidents/reduce-mttd
 - /learn/incidents/slo-sla-sli
 - /learn/incidents/what-is-incident-response
 - /learn/incidents/automation-incident-response
 - /learn/incidents/incident-assessment-severity
 - /learn/incidents/on-call-schedule
@@ -607,7 +610,7 @@
 - /learn/kubernetes/operators-metrics
 - /learn/kubernetes/structured-logging

 ### Learn - Monitoring
 - /learn/monitoring/overview
 - /learn/monitoring/intro-to-sdlc
 - /learn/monitoring/metrics-every-team-needs
@@ -617,16 +620,16 @@
 - /learn/monitoring/real-user-monitoring
 - /learn/monitoring/synthetic-monitoring
 - /learn/monitoring/transaction-monitoring
 - /learn/monitoring/web-application-monitoring
 - /learn/monitoring/https-for-app-developers
 - /learn/monitoring/tcp-and-ssl
 - /learn/monitoring/what-is-tcp

 ### Learn - OpenTelemetry
 - /learn/opentelemetry/overview
 - /learn/opentelemetry/getting-started-with-observability
 - /learn/opentelemetry/how-to-instrument
 - /learn/opentelemetry/what-is-the-otel-collector
 - /learn/opentelemetry/logs
 - /learn/opentelemetry/metrics
 - /learn/opentelemetry/traces
@@ -637,16 +640,16 @@

 ## Comparisons

 ### Comparisons - Frameworks
 - /comparisons/frameworks/playwright-vs-cypress
 - /comparisons/frameworks/playwright-vs-selenium
 - /comparisons/frameworks/playwright-vs-others

 ---

 ## Common URL Patterns for Link Fixing:

 ### BROKEN → CORRECT MAPPINGS:
 - `/alerting/` → `/communicate/alerts/`
 - `/alerting-and-retries/` → `/communicate/alerts/`
 - `/alerting-and-retries/retries/` → `/communicate/alerts/retries`
@@ -668,4 +671,4 @@

 - `/status-pages/` → `/communicate/status-pages/`

 - `/monitoring/global-locations/` → `/concepts/locations` (likely)

diff --git a/snippets/agent-example.mdx b/snippets/agent-example.mdx
@@ -1,11 +1,16 @@
 <Card title="Create new checks, alert channels or other constructs" horizontal>
-"Can you create a new `BrowserCheck` monitoring `example.com`"
-</Card>
-
-<Card title="Gather information about the current monitoring setup" horizontal>
-"What are the currently used monitoring locations?"
+"Can you set up a new `BrowserCheck` for `example.com`?"
 </Card>
 
 <Card title="Bulk-update your monitoring resources" horizontal>
 "Can you change all checks to run every 5 minutes instead of every 10 minutes?"
 </Card>
+
+<Card title="Gather information about alerts and your monitoring setup" horizontal>
+"I just received an alert. Can you tell me details about the failing checks?"
+</Card>
+
+<Card title="Handle and communicate incidents" horizontal>
+"Can you please open an incident and investigate a fix?"
+</Card>
+