cleaned skills page

Author: Dgiordano33

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/skills.mdx

@@ -54,6 +54,119 @@ Provide the necessary Checkly context and let your AI agent of choice do the res
 
 Using Checkly, 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.
 
+## Skill Details
+
+<Accordion title="Configure">
+  Create and manage monitoring checks, alert channels, dashboards, status pages, and other Checkly constructs using the CLI.
+
+  **Invoke explicitly:**
+
+  ```bash
+  npx checkly skills configure
+  ```
+
+  **Example prompts:**
+
+  - "Create a URL monitor for api.example.com that checks every 5 minutes"
+  - "Set up a browser check that logs into my app and verifies the dashboard loads"
+  - "Add a Slack alert channel for my production check group"
+
+  **CLI usage:**
+
+  ```bash
+  # List all configure sub-actions
+  npx checkly skills configure
+
+  # Get reference for a specific check type
+  npx checkly skills configure api-checks
+  npx checkly skills configure browser-checks
+  npx checkly skills configure url-monitors
+
+  # Other constructs
+  npx checkly skills configure alert-channels
+  npx checkly skills configure check-groups
+  npx checkly skills configure supporting-constructs
+  ```
+</Accordion>
+
+<Accordion title="Investigate">
+  Access check status, analyze failures, trigger on-demand runs, and debug errors across your monitoring setup.
+
+  **Invoke explicitly:**
+
+  ```bash
+  npx checkly skills investigate
+  ```
+
+  **Example prompts:**
+
+  - "Show me which checks are currently failing"
+  - "Investigate why the login browser check started failing yesterday"
+  - "Trigger an on-demand run of my API health check"
+
+  **CLI usage:**
+
+  ```bash
+  # Get full investigate reference
+  npx checkly skills investigate
+
+  # Check inspection and on-demand runs
+  npx checkly skills investigate checks
+  ```
+</Accordion>
+
+<Accordion title="Communicate">
+  Open and manage incidents and lead customer communications via status pages.
+
+  **Invoke explicitly:**
+
+  ```bash
+  npx checkly skills communicate
+  ```
+
+  **Example prompts:**
+
+  - "Create a new incident for the API outage and post it to the status page"
+  - "Update the current incident with a resolution message"
+  - "List all open incidents"
+
+  **CLI usage:**
+
+  ```bash
+  # Get full communicate reference
+  npx checkly skills communicate
+
+  # Incident lifecycle management
+  npx checkly skills communicate incidents
+  ```
+</Accordion>
+
+<Accordion title="Manage">
+  Understand your account plan, entitlements, feature limits, and available monitoring locations.
+
+  **Invoke explicitly:**
+
+  ```bash
+  npx checkly skills manage
+  ```
+
+  **Example prompts:**
+
+  - "What features are available on my current Checkly plan?"
+  - "Which monitoring locations can I use?"
+  - "Check if my plan supports private locations"
+
+  **CLI usage:**
+
+  ```bash
+  # Get full manage reference
+  npx checkly skills manage
+
+  # Check plan details and entitlements
+  npx checkly skills manage plan
+  ```
+</Accordion>
+
 ## Additional resources
 
 - [`checkly skills` CLI Reference](/cli/checkly-skills)

images/rca/rca-automation-dark.png

@@ -6,7 +6,7 @@ sidebarTitle: AI Root Cause Analysis
 
 ## What is Rocky AI Root Cause Analysis?
 
-Rocky AI — Checkly's AI service — can automatically analyze, categorize and summarize any failure or error from one of Checkly's
+Rocky AI — Checkly's Agent — can automatically analyze, categorize and summarize any failure or error from one of Checkly's
 synthetic checks and / or monitoring checks.
 
 <Frame>
@@ -26,7 +26,7 @@ Using any available artifacts like error message, user code, logs, metrics, trac
 and other evidence, it will quickly assess what the impact is of a failure and what the underlying (possible) root cause is.
 It will also provide a suggested code fix for any check based on (Playwright) code.
 
-## How do I use Rocky AI Root Cause Analysis?
+## Getting Started with Rocky AI Root Cause Analysis
 
 1. Make sure [Rocky AI is enabled in its settings page](https://app.checklyhq.com/accounts/rocky-ai).
 2. Click the "Analyze Root Cause" button on any failing check result, test session result and / or error group.