checkly-plugin

Checkly skills for AI coding agents packaged as a single plugin that targets Codex, Claude Code, Cursor, and generic agent SDKs. It also bundles the Checkly MCP server for live account operations.

What's in here

.codex-plugin/       Codex plugin manifest
.claude-plugin/      Claude Code marketplace + plugin manifest
.cursor-plugin/      Cursor plugin manifest
.plugin/             Generic agent plugin manifest
skills/              Skills (one directory per skill)
.mcp.json            Checkly MCP server configuration
scripts/sync.ts      Pulls externally-authored skills from their source repos
scripts/package.ts   Builds the ZIP for OpenAI plugin submission
skills.config.ts     Declares where each externally-authored skill comes from

Installing

Codex

codex plugin marketplace add checkly/checkly-plugin
codex

Then open Codex and enable the Checkly plugin via /plugins.

/plugins

Plugins CLI

npx plugins add checkly/checkly-plugin

Claude Code

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

Cursor

Point Cursor at this repo to install the plugin.

Skills shipped here

Skill	Source
checkly	checkly/checkly-cli — tracks main, synced daily
playwright-best-practices-for-agents	checkly/docs — tracks main, synced daily

Packaging for OpenAI submission

npm run package

Writes dist/checkly-plugin-<version>.zip containing only the files the Codex plugin needs: the Codex manifest, .mcp.json, .app.json, skills/, assets/, LICENSE, and README.md. The file list comes from git ls-files, so untracked files such as .env never end up in the archive. Upload the ZIP at the OpenAI plugin dashboard.

Adding more

• Externally-authored (lives in another repo, synced here): add an entry to skills.config.ts and run npm run sync.
• Plugin-native (authored here directly): drop a skills/<name>/SKILL.md into the skills/ directory.

See CONTRIBUTING.md for details.