AI Messaging in Concepts and Sidebar

.claude/skills/checkly/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: checkly
+description: Set up, create, test and manage monitoring checks using the Checkly CLI. Use when working with API Checks, Browser Checks, URL Monitors, ICMP Monitors, Playwright Check Suites, Heartbeat Monitors, Alert Channels, Dashboards, or Status Pages.
+allowed-tools: Bash(npx:checkly:*) Bash(npm:install:*)
+metadata:
+  author: checkly
+---
+
+# Checkly
+
+The Checkly CLI provides all the required information via the `npx checkly skills` command.
+
+Use `npx checkly skills install` to install this skill into your project (supports Claude Code, Cursor, Codex and more).
+
+Use `npx checkly skills` to list all available actions, and `npx checkly skills <action>` to access up-to-date information on how to use the Checkly CLI for each action.
+
+## Progressive Disclosure via `npx checkly skills`
+
+The skill is structured for efficient context usage:
+
+1. **Metadata** (~80 tokens): Name and description in frontmatter
+2. **Core Instructions** (~1K tokens): Main SKILL.md content with links to reference commands
+3. **Reference Commands** (loaded on demand): Detailed construct documentation with examples
+
+Agents load what they need for each task.
+
+## Plan Awareness
+
+Before configuring checks, run `npx checkly account plan --output json` to see what features, locations, and limits are available on the current plan. Disabled features include an `upgradeUrl` pointing to the self-service checkout page or the enterprise contact sales page — share these with the user when they need a feature that's not on their plan.
+
+Run `npx checkly skills manage` for the full reference.
+
+## Confirmation Protocol
+
+Write commands (e.g. `incidents create`, `deploy`, `destroy`) return exit code 2 with a `confirmation_required` JSON envelope instead of executing. **Always present the `changes` to the user and wait for approval before running the `confirmCommand`.** Never auto-append `--force`. This applies to every write command individually — updates and resolutions need confirmation too, not just the initial create.
+
+Run `npx checkly skills communicate` for the full protocol details.
+
+### `npx checkly skills initialize`
+Learn how to initialize and set up a new Checkly CLI project from scratch.
+
+### `npx checkly skills configure`
+Learn how to create and manage monitoring checks using Checkly constructs and the CLI.
+
+#### `npx checkly skills configure api-checks`
+Api Check construct (`ApiCheck`), assertions, and authentication setup scripts
+
+#### `npx checkly skills configure browser-checks`
+Browser Check construct (`BrowserCheck`) with Playwright test files
+
+#### `npx checkly skills configure playwright-checks`
+Playwright Check Suite construct (`PlaywrightCheck`) for multi-browser test suites
+
+#### `npx checkly skills configure multistep-checks`
+Multistep Check construct (`MultiStepCheck`) for complex user flows
+
+#### `npx checkly skills configure tcp-monitors`
+TCP Monitor construct (`TcpMonitor`) with assertions
+
+#### `npx checkly skills configure url-monitors`
+URL Monitor construct (`UrlMonitor`) with assertions
+
+#### `npx checkly skills configure dns-monitors`
+DNS Monitor construct (`DnsMonitor`) with assertions
+
+#### `npx checkly skills configure icmp-monitors`
+ICMP Monitor construct (`IcmpMonitor`) with latency and packet loss assertions
+
+#### `npx checkly skills configure heartbeat-monitors`
+Heartbeat Monitor construct (`HeartbeatMonitor`)
+
+#### `npx checkly skills configure check-groups`
+CheckGroupV2 construct (`CheckGroupV2`) for organizing checks
+
+#### `npx checkly skills configure alert-channels`
+Email (`EmailAlertChannel`), Phone (`PhoneCallAlertChannel`), and Slack (`SlackAlertChannel`) alert channels
+
+#### `npx checkly skills configure supporting-constructs`
+Status pages (`StatusPage`), dashboards (`Dashboard`), maintenance windows (`MaintenanceWindow`), and private locations (`PrivateLocation`)
+
+### `npx checkly skills investigate`
+Access check status, analyze failures, and investigate errors.
+
+#### `npx checkly skills investigate checks`
+Inspecting checks (`checks list`, `checks get`) and triggering on-demand runs
+
+### `npx checkly skills communicate`
+Open incidents and lead customer communications via status pages.
+
+#### `npx checkly skills communicate incidents`
+Incident lifecycle (`incidents create`, `update`, `resolve`, `list`) and status pages
+
+### `npx checkly skills manage`
+Understand your account plan, entitlements, and feature limits.
+
+#### `npx checkly skills manage plan`
+Check account plan, entitlements, feature limits, and available locations (`account plan`)

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
+```

platform/rocky-ai.mdx → ai/rocky-ai.mdx

@@ -7,21 +7,16 @@ sidebarTitle: Rocky AI
 Rocky AI is Checkly's AI agent. Rocky AI can help you automatically determine user impact and root cause on any failing
 check using error messages, code, metrics, traces and logs.
 
-## Rocky AI capabilities
+## Rocky AI Capabilities
+### Root Cause & User Impact Analysis
 
-Rocky AI's current core capabilities are **Root Cause & User Impact Analysis** for failing checks and
-test results. Read more about [Rocky AI Root Cause Analysis in the resolve section](/resolve/ai-root-cause-analysis/overview).
+- **User Impact**: Rocky AI analyzes the failure and provides you with a list of impacted user groups and features.
+- **Root Cause**: Rocky AI analyzes the failure and provides you with a root cause analysis.
+- **Step Summary**: Rocky AI summarizes the steps in the check script, making it easier to understand what the check is doing and where it failed. This typically works for any Playwright based check.
 
-*We are planning more capabilities for Rocky AI across the Detect, Communicate and Resolve categories.*
+**[Learn More](/resolve/ai-root-cause-analysis/overview)**
 
-## Getting Started with Rocky AI
-
-To get started with Rocky AI follow these steps:
-
-1. Make sure [Rocky AI is enabled in its settings page](https://app.checklyhq.com/accounts/rocky-ai).
-2. Now look for Rocky AI buttons and options in the Checkly web interface.
-
-## AI invocations
+## Consumption & Invocations
 
 Every AI analysis — whether triggered automatically or manually — counts as one invocation against your plan's quota. If the same analysis result is pushed to multiple alert channels, it is still counted as a single invocation.
 

ai/rules.mdx

@@ -1,7 +1,8 @@
 ---
 title: 'Checkly Rules'
 description: 'Add Checkly rules files to your AI agent to provide monitoring context for your coding workflow.'
-sidebarTitle: 'Rules'
+sidebarTitle: 'Agent Rules'
+hidden: true
 ---
 
 import AgentExamples from "/snippets/agent-example.mdx"