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, 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. The manifest name inside the ZIP is replaced with the ID of the existing OpenAI listing (OPENAI_PLUGIN_NAME in scripts/package.ts), because the directory rejects uploads whose name doesn't match. The repo manifest keeps checkly for marketplace installs. .app.json and the manifest apps field are left out of the ZIP, because OpenAI rejects submissions with app references; the MCP app is linked in the dashboard instead. 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.