# Set up with an AI coding agent

> Have Claude Code, Codex, Cursor or another AI coding agent move your GitHub Actions jobs to Skipbox: install the skill, ask, and review the pull request.

Your AI coding agent can move your GitHub Actions jobs to Skipbox. You install the GitHub App. The agent finds the jobs worth moving, changes their `runs-on` line, adds the setup steps each job needs, and opens a pull request for you to review.

## Install the skill

The skill is one Markdown file in [skipbox-dev/skills](https://github.com/skipbox-dev/skills) on GitHub. It tells the agent which jobs to move, the labels and sizes, what the runner image has, and how to fix a job that fails or stays queued. Install it one of three ways.

With skills.sh, for Claude Code, Codex, Cursor and other agents:

```bash
npx skills add skipbox-dev/skills
```

As a Claude Code plugin. Add the marketplace:

```text
/plugin marketplace add skipbox-dev/skills
```

Then install the plugin:

```text
/plugin install skipbox@skipbox-skills
```

By hand: copy [`SKILL.md`](https://github.com/skipbox-dev/skills/blob/main/skills/skipbox-github-runners/SKILL.md) into your agent's skills or rules folder. For Claude Code, that is:

```text
.claude/skills/skipbox-github-runners/SKILL.md
```

## Ask your agent

Open the repository in your agent and ask in your own words:

```text
Move our Linux CI jobs to Skipbox and open a pull request
Which of our workflows cost the most on GitHub Actions? Which should move?
This job fails on Skipbox with "command not found": fix it
This job has been queued since we moved it to Skipbox: find out why
```

The agent starts with one job, so its first run shows whether a tool is missing. It leaves macOS, Windows and Arm jobs on GitHub's runners.

## What the agent can't do for you

- **Sign in and install the Skipbox app.** Do steps 1 and 2 of the [Quickstart](https://docs.skipbox.dev/quickstart) on the account that owns the repository. Which app goes on an organization and which on a personal account is in [Organizations and personal accounts](https://docs.skipbox.dev/accounts).
- **Choose a plan.** The free trial needs no card and starts with the first job: 7 days or 3,000 job-minutes, whichever comes first. After it, you pick the plan. See [Plans](https://docs.skipbox.dev/plans).

Here Skipbox doesn't change your workflows: the change is the pull request your agent opens, and you merge it. To have Skipbox open that pull request instead, press **Open a pull request** beside the repository on your account's page (see [GitHub App permissions](https://docs.skipbox.dev/permissions)).

## Without the skill

Every page of these docs is also Markdown: add `.md` to its address. The list of every page is at `https://docs.skipbox.dev/llms.txt`. An agent without the skill can read the docs directly, starting with these:

- The steps: [Quickstart](https://docs.skipbox.dev/quickstart).
- Which label to write: [Labels and sizes](https://docs.skipbox.dev/labels).
- What the VM has installed: [Runner image](https://docs.skipbox.dev/runner-image).
- A job that passed on GitHub's runners and fails here: [A job fails after moving](https://docs.skipbox.dev/migration).

During the trial, the label is `skipbox`. For anything else, write to hello@skipbox.dev.

Updated 2026-11-12 · https://docs.skipbox.dev/ai-agents