# Checkly Plugin for AI Coding Agents - Checkly Docs

> Install the Checkly plugin to give your AI coding agent Checkly monitoring skills and Playwright best practices in a single package.

Source: https://www.checklyhq.com/docs/ai/plugin/

---

- Getting started Installation

- What the plugin provides MCP server
- Skills

- Usage
- Reporting issues
- Additional resources

Agent Resources

# Checkly Plugin for AI Coding Agents

Install the Checkly plugin to give your AI coding agent Checkly monitoring skills and Playwright best practices in a single package.

The [Checkly plugin](https://github.com/checkly/checkly-plugin) bundles the official Checkly skills and the Checkly MCP server for AI coding agents in a single installable package. It targets Claude Code, OpenAI Codex, Cursor, and any agent supporting the plugins standard.

## ​ Getting started

### ​ Installation

- Claude Code (CLI)
- Claude Code (Desktop) & Claude Cowork
- Codex & ChatGPT

Add the Checkly plugin marketplace and install the plugin from within Claude Code:

```
/plugin marketplace add checkly/checkly-plugin
/plugin install checkly@checkly
```

- Open the plugin settings and click **Add marketplace**.

- Select **Add from a repository**.

- Enter `https://github.com/checkly/checkly-plugin/` as the URL and click **Sync**.

- Install the Checkly plugin from the newly added marketplace.

- Open the plugin settings and click **Add marketplace**.

- Enter `https://github.com/checkly/checkly-plugin` as the source and click **Add marketplace**.

- Install the Checkly plugin from the newly added marketplace and connect it to your Checkly account.

- Once installed, the plugin registers the [Checkly MCP server](https://www.checklyhq.com/docs/ai/mcp-server) so you can inspect checks, trigger runs, and investigate failures from Codex.

The Checkly plugin has been submitted to Anthropic and OpenAI and is awaiting review. Until it’s approved, install it from the GitHub repository as described above.

After installation, restart your AI agent to load the plugin.

## ​ What the plugin provides

### ​ MCP server

The plugin configures the [Checkly MCP server](https://www.checklyhq.com/docs/ai/mcp-server), connecting your agent to your Checkly account for live operations like inspecting check status and results, triggering checks, or starting root cause analyses.

### ​ Skills

The plugin also ships two skills. Both are synced daily from their source repositories, so you always get the latest guidance.
Skill Description

`checkly` Set up, create, test, and manage monitoring checks with the Checkly CLI. See [Checkly Skills](https://www.checklyhq.com/docs/ai/skills) for details on what the skill covers.

`playwright-best-practices-for-agents` Agent-first best practices for writing, structuring, debugging, and stabilizing Playwright tests.

## ​ Usage

Once installed, your agent automatically loads the relevant skill whenever a Checkly or Playwright task comes up — no manual context loading required.
Claude Code Example

```
❯ Can you create a new URLMonitor with Checkly for example.com?

⏺ Skill(checkly:checkly)
⎿ Successfully loaded skill · 3 tools allowed

⏺ Let me read more references and check the existing project structure
```

In agents supporting slash commands, you can also invoke the bundled skills explicitly:

```
/checkly:checkly
/checkly:playwright-best-practices-for-agents
```

If you only want the Checkly monitoring skill without the plugin wrapper, install it directly via the Checkly CLI. See [Checkly Skills](https://www.checklyhq.com/docs/ai/skills).

## ​ Reporting issues

If a skill gives incorrect advice or the plugin doesn’t behave as expected, [file an issue on GitHub](https://github.com/checkly/checkly-plugin/issues).

## ​ Additional resources

- [checkly/checkly-plugin on GitHub](https://github.com/checkly/checkly-plugin)

- [Checkly Skills](https://www.checklyhq.com/docs/ai/skills)

- [Agent Skills Specification](https://agentskills.io/specification.md)

Was this page helpful?

[Suggest edits](https://github.com/checkly/docs/edit/main/ai/plugin.mdx)[Raise issue](https://github.com/checkly/docs/issues/new?title=Issue%20on%20docs&body=Path:%20/ai/plugin)

[Troubleshoot the Checkly MCP Server Previous](https://www.checklyhq.com/docs/ai/mcp-server/troubleshooting)[Checkly Skills Next](https://www.checklyhq.com/docs/ai/skills)

[x](https://x.com/checklyhq)[github](https://github.com/checkly)[linkedin](https://linkedin.com/company/checkly)

[Powered by This documentation is built and hosted on Mintlify, a developer documentation platform](https://www.mintlify.com/?utm_campaign=poweredBy&utm_medium=referral&utm_source=checkly-422f444a)