Skip to main content
Available since CLI v7.5.0.
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 to let your AI agent automatically discover and use the checkly skills command.
Before using checkly skills, ensure you have:
  • Checkly CLI installed
No existing Checkly account is required to access Checkly skills and documentation.

​
Usage

checkly skills provides your agent with all the required information to manage your Checkly monitoring setup. All resources and workflows are discoverable to provide your agent the right information at the right time.
Terminal
npx checkly skills
npx checkly skills <action> [resource]

​
Actions

ActionDescription
initializeLet your agent initialize a new Checkly project.
configureLet your agent configure Checkly constructs.
investigateAccess check status, analyze failures, and investigate errors.
communicateOpen incidents and lead customer communications via status pages.
manageUnderstand your account plan, entitlements, and feature limits.

​
Commands

CommandDescription
installInstall the Checkly agent skill (SKILL.md) into your project.

​
checkly skills initialize (experimental)

The initialize action outputs LLM-optimized Markdown with all the context an agent needs to set up a new Checkly project from scratch. The context will instruct your agent to install required packages, create config files and scan your current project for resources to monitor. Usage:
Terminal
npx checkly skills initialize
You can prompt your agent with “run npx checkly skills initialize and follow the instructions” and the agent will have everything it needs to scaffold your Checkly monitoring setup.

​
checkly skills configure [resource]

The configure action is an umbrella command that provides Markdown context about all available Checkly resources. The CLI outputs everything your agent needs to configure Checkly constructs directly — no additional docs fetching or file reading required. Run configure without arguments to see all available resources, or pass a specific resource name to get targeted context. Usage:
Terminal
npx checkly skills configure
npx checkly skills configure api-checks
npx checkly skills configure browser-checks
# ...and more

​
checkly skills investigate [resource]

The investigate action provides context for inspecting check status, analyzing failures, and investigating errors across your Checkly account. Run investigate without arguments to see all available resources, or pass a specific resource name for targeted context. Usage:
Terminal
npx checkly skills investigate
npx checkly skills investigate checks
Available resources:
ResourceDescription
checksInspecting checks (checks list, checks get) and triggering on-demand runs.

​
checkly skills communicate [resource]

The communicate action provides context for managing incidents and customer communications through status pages. Write commands like incidents create, incidents update, and incidents resolve follow a confirmation protocol — the CLI returns a JSON envelope for agent review before execution. Run communicate without arguments to see all available resources, or pass a specific resource name for targeted context. Usage:
Terminal
npx checkly skills communicate
npx checkly skills communicate incidents
Available resources:
ResourceDescription
incidentsIncident lifecycle (incidents create, update, resolve, list) and status pages.

​
checkly skills manage [resource]

The manage action provides context about your account’s plan, entitlements, and limits. Use this to understand what features and locations are available before configuring checks. Run manage without arguments to see all available resources, or pass a specific resource name for targeted context. Usage:
Terminal
npx checkly skills manage
npx checkly skills manage plan
Available resources:
ResourceDescription
planCheck account plan, entitlements, feature limits, and available locations (account plan).
The manage plan resource documents the checkly account plan command. Your agent can use the account plan command to query entitlements and available locations before writing check configurations.

​
checkly skills install

The install command installs the Checkly agent skill file (SKILL.md) into your project. This file lets your AI agent automatically discover and use the checkly skills command. Usage:
Terminal
npx checkly skills install
npx checkly skills install --target <platform>
npx checkly skills install --path <directory>
Options:
OptionRequiredDescription
--target, -t-Platform to install the skill for.
--path, -p-Custom target directory to install the skill into.
--force, -f-Overwrite existing SKILL.md without confirmation.

​
Install Options

​
--target, -t
string
The target platform determines where and how the skill file is installed. Available platforms: amp, claude, cline, codex, continue, cursor, gemini-cli, github-copilot, goose, opencode, roo, windsurf.Usage:
Terminal
npx checkly skills install --target=claude
npx checkly skills install -t cursor
​
--path, -p
string
Custom target directory to install the skill file into. Use this when the default location for your platform does not match your project structure.Usage:
Terminal
npx checkly skills install --path=./my-agent-config
​
--force, -f
boolean
Overwrite an existing SKILL.md without asking for confirmation.Usage:
Terminal
npx checkly skills install --force

​
Install Examples

Terminal
# Install for Claude Code
npx checkly skills install --target=claude

# Install for Cursor
npx checkly skills install --target=cursor

# Install to a custom directory
npx checkly skills install --path=./agents

# Overwrite an existing skill file
npx checkly skills install --target=claude --force