# Configure com um agente de IA para programação

> Peça ao Claude Code, ao Codex, ao Cursor ou a outro agente de IA para programação que mova os seus trabalhos do GitHub Actions para o Skipbox: instale a skill, peça e revise o pull request.

O seu agente de IA para programação pode mover os seus trabalhos do GitHub Actions para o Skipbox. Você instala o GitHub App. O agente encontra os trabalhos que vale a pena mover, troca a linha `runs-on` deles, adiciona os steps de configuração de que cada trabalho precisa e abre um pull request para você revisar.

## Instale a skill

A skill é um arquivo Markdown em [skipbox-dev/skills](https://github.com/skipbox-dev/skills) no GitHub. Ela diz ao agente quais trabalhos mover, os rótulos e os tamanhos, o que a imagem do executor tem e como consertar um trabalho que falha ou fica na fila. Instale-a de um destes três jeitos.

Com o skills.sh, para Claude Code, Codex, Cursor e outros agentes:

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

Como plugin do Claude Code. Adicione o marketplace:

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

Depois instale o plugin:

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

À mão: copie o [`SKILL.md`](https://github.com/skipbox-dev/skills/blob/main/skills/skipbox-github-runners/SKILL.md) para a pasta de skills ou de regras do seu agente. No Claude Code, é:

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

## Peça ao seu agente

Abra o repositório no seu agente e peça com as suas palavras:

```text
Mova os nossos trabalhos de CI Linux para o Skipbox e abra um pull request
Quais dos nossos workflows custam mais no GitHub Actions? Quais deveriam mudar?
Este trabalho falha no Skipbox com "command not found": conserte
Este trabalho está na fila desde que o movemos para o Skipbox: descubra por quê
```

O agente começa por um trabalho, então a primeira execução mostra se falta alguma ferramenta. Ele deixa os trabalhos macOS, Windows e Arm nos executores do GitHub.

## O que você faz no lugar do agente

- **Entrar e instalar o app do Skipbox.** Faça os passos 1 e 2 do [Início rápido](https://docs.skipbox.dev/pt-br/quickstart) na conta dona do repositório. Qual app vai em uma organização e qual vai em uma conta pessoal está em [Organizações e contas pessoais](https://docs.skipbox.dev/pt-br/accounts).
- **Escolher um plano.** O teste grátis não pede cartão e começa com o primeiro trabalho: 7 dias ou 3.000 minutos de trabalhos, o que vier primeiro. Depois dele, você escolhe o plano. Veja [Planos](https://docs.skipbox.dev/pt-br/plans).

Aqui o Skipbox não altera os seus workflows: a mudança é o pull request que o seu agente abre, e você faz o merge. Para o próprio Skipbox abrir esse pull request, clique em **Abrir um pull request** ao lado do repositório na página da sua conta (veja [Permissões do GitHub App](https://docs.skipbox.dev/pt-br/permissions)).

## Sem a skill

Cada página desta documentação também existe em Markdown: acrescente `.md` ao endereço. A lista de todas as páginas está em `https://docs.skipbox.dev/llms.txt`. Um agente sem a skill pode ler a documentação diretamente, começando por estas:

- Os passos: [Início rápido](https://docs.skipbox.dev/pt-br/quickstart).
- Qual rótulo escrever: [Rótulos e tamanhos](https://docs.skipbox.dev/pt-br/labels).
- O que a VM tem instalado: [Imagem do executor](https://docs.skipbox.dev/pt-br/runner-image).
- Um trabalho que passava nos executores do GitHub e falha aqui: [Um trabalho falha depois da mudança](https://docs.skipbox.dev/pt-br/migration).

Durante o teste, o rótulo é `skipbox`. Para qualquer outra coisa, escreva para hello@skipbox.dev.

Atualizado em 2026-11-12 · https://docs.skipbox.dev/pt-br/ai-agents
