CircleCI skills

CircleCI-managed plugins for AI agents. Two plugins live here: circleci, the skills for building, debugging and optimizing pipelines, and chunk, the skills for CircleCI Chunk.

Install

Claude Code

Adding the marketplace registers the catalog. Installing the plugin is a separate step, and skipping it is why /reload-plugins would report no skills:

/plugin marketplace add CircleCI-Public/skills
/plugin install circleci@circleci-public-skills

Add chunk@circleci-public-skills as well for the Chunk skills. The same two steps work from a shell with claude plugin marketplace add and claude plugin install.

The circleci plugin also runs the CircleCI YAML language server, so Claude sees config errors after each edit and can look up jobs, commands and orbs by name. It downloads the server the first time it edits a YAML file, and checks once a day for a newer release. That needs curl or wget on macOS and Linux, and PowerShell on Windows, which every supported Windows has. To pin a version, set CIRCLECI_YAML_LSP_VERSION.

Codex

codex plugin marketplace add CircleCI-Public/skills
codex plugin add circleci@circleci-skills

Any agent that reads SKILL.md

The skills are plain markdown under plugins//skills//SKILL.md, with no plugin runtime required. Point your agent at that directory, or copy the ones you want into wherever it looks for skills.

Most of these drive the circleci CLI, so install that too and run circleci auth login once.

Updating

Each plugin’s CHANGELOG.md lists what changed in each version. To hear about new versions, watch this repository on GitHub for releases.

Claude Code

Claude Code doesn’t update plugins from this marketplace unless you turn on auto-update, which is off by default for marketplaces outside Anthropic’s own. Until then you keep the version you installed.

To turn on auto-update, run /plugin, open the Marketplaces tab, select circleci-public-skills, and choose Enable auto-update. Claude Code then updates the plugins when a session starts, and the new versions load in the next session or after /reload-plugins.

To update now, choose Update marketplace in the same place, or from a shell:

claude plugin marketplace update circleci-public-skills
claude plugin update circleci@circleci-public-skills

Codex

Codex keeps the version you installed. Refresh the marketplace, then add the plugin again to install the new version, and start a new session to load it:

codex plugin marketplace upgrade circleci-skills
codex plugin add circleci@circleci-skills

codex plugin list shows the installed version.

Organization

There’s a toplevel codex compatible marketplace meant to facilitate local testing in codex.