Set up with an AI coding agent

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 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:

npx skills add skipbox-dev/skills

As a Claude Code plugin. Add the marketplace:

/plugin marketplace add skipbox-dev/skills

Then install the plugin:

/plugin install skipbox@skipbox-skills

By hand: copy SKILL.md into your agent's skills or rules folder. For Claude Code, that is:

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

Ask your agent

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

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 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.
• 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.

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).

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.
• Which label to write: Labels and sizes.
• What the VM has installed: Runner image.
• A job that passed on GitHub's runners and fails here: A job fails after moving.

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