# CircleCI agent skills for Claude Code, Cursor and RevampKey

> Ready-made CircleCI playbooks for AI agents: diagnose a failed CircleCI run with AI, check a CircleCI deploy before you roll it back, review CircleCI pipeline health with AI. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use CircleCI with AI safely](https://revampkey.com/marketplace/circleci/skills/essentials.md): Sets the ground rules for working with CircleCI from an AI assistant: confirm the org and project first, pick the right tool for runs, workflows, jobs and logs, and ask before any rerun, cancel or rollback.
- [Diagnose a failed CircleCI run with AI](https://revampkey.com/marketplace/circleci/skills/ci-failure-diagnosis.md): Walks back from a failed CircleCI workflow to the first real failing step and separates code bugs from flaky tests and infrastructure problems. It checks run history before naming a cause and does not rerun anything without asking.
- [Check a CircleCI deploy before you roll it back](https://revampkey.com/marketplace/circleci/skills/deploy-rollback-check.md): Works out which version is live, what it replaced and whether the previous build is healthy, then asks for your explicit yes before any rollback runs.
- [Review CircleCI pipeline health with AI](https://revampkey.com/marketplace/circleci/skills/pipeline-health-review.md): Reviews recent CircleCI runs on a branch or project to measure failure rate, duration and repeated failures, then ranks the bottleneck and the fix with the best payback. It reports trends across runs and does not change anything in your CI.
- [Rerun a failed CircleCI workflow, safely](https://revampkey.com/marketplace/circleci/skills/rerun-failed-workflow.md): Decides whether a failed or stuck CircleCI workflow is worth rerunning, and whether to rerun only the failed jobs or everything. It checks state and history first and asks before rerunning or cancelling.
- [Triage CircleCI test failures](https://revampkey.com/marketplace/circleci/skills/test-failure-triage.md): Turns the failing tests in a CircleCI job into a ranked list: new failures that block the branch, probably flaky tests, skipped-test drift and pre-existing debt. It asks before changing any test or project settings.

## Install

- RevampKey: connect CircleCI at https://revampkey.com/marketplace/circleci; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
for s in essentials ci-failure-diagnosis deploy-rollback-check pipeline-health-review rerun-failed-workflow test-failure-triage; do
  curl -fsSL --create-dirs -o .agents/skills/circleci-$s/SKILL.md https://revampkey.com/marketplace/circleci/skills/$s/SKILL.md
done
```

### What is a CircleCI agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each CircleCI skill describes one job, which CircleCI tools to use in which order, what to check first and when to stop and ask you.

### Do the CircleCI skills change anything on their own?

3 of the 6 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in CircleCI.

### Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect CircleCI; elsewhere you copy the folders into your project or skills directory.

### Do I need the CircleCI MCP server too?

Yes. The skills tell the agent how to do the work; the CircleCI MCP server gives it the tools to do it. The CircleCI MCP setup guide covers every client.

MCP setup guide: https://revampkey.com/marketplace/circleci.md