# Início rápido

> Rode o seu primeiro trabalho do GitHub Actions no Skipbox: entre, instale o app, troque uma linha de runs-on e faça push.

Você precisa de um repositório em uma organização do GitHub ou em uma conta pessoal, público ou privado, com pelo menos um workflow em `.github/workflows`. Os passos levam poucos minutos, e o teste grátis não pede cartão.

## 1. Entre com o GitHub

Abra o [skipbox.dev](https://skipbox.dev/?lang=pt-BR) e entre com o GitHub. Entrar não cobra nada.

## 2. Instale o app do Skipbox

O Skipbox mostra dois botões de instalação. Escolha o da conta cujos trabalhos você quer rodar:

- **Uma organização:** instale o app **Skipbox CI**. Quem instala é um proprietário da organização. Se você não é proprietário, o GitHub envia o seu pedido aos proprietários, e o proprietário que o instala entra no Skipbox uma vez.
- **A sua conta pessoal:** instale o app **Skipbox (personal)**.

Depois, o GitHub pergunta se o app pode usar todos os repositórios ou só alguns. O Skipbox roda trabalhos de repositórios públicos e privados; em uma organização com um repositório público, permita o Skipbox nos repositórios públicos uma vez (o botão na sua página de repositórios), já que o GitHub mantém os executores auto-hospedados longe deles até um proprietário permitir. Veja [Organizações e contas pessoais](https://docs.skipbox.dev/pt-br/accounts) e [Permissões do GitHub App](https://docs.skipbox.dev/pt-br/permissions).

## 3. Troque o runs-on de um trabalho

Abra um arquivo de workflow e defina o `runs-on` de um trabalho como `skipbox`:

```yaml
jobs:
  test:
    runs-on: skipbox
    steps:
      - uses: actions/checkout@v4
      - run: make test
```

O seu painel lista os seus repositórios com um link **Editar no GitHub** para cada workflow, então você pode fazer a mudança no editor do GitHub. Ou clique em **Abrir um pull request** ao lado de um repositório: o Skipbox abre um pull request que troca as linhas `runs-on` por você, depois que o GitHub pede para você instalar o app Skipbox Migrate nesse repositório ([Permissões do GitHub App](https://docs.skipbox.dev/pt-br/permissions)). Faça o merge e pule o passo 4.

## 4. Faça commit e push

Faça commit da mudança. A próxima execução desse trabalho roda no Skipbox e aparece no seu painel. O seu teste grátis começa com esse primeiro trabalho: 7 dias ou 3.000 minutos de trabalhos, o que vier primeiro. Veja [Teste grátis](https://docs.skipbox.dev/pt-br/trial).

## Volte para os executores do GitHub

Volte o `runs-on` para o que era, como `ubuntu-latest`, e faça commit. O Skipbox não mudou mais nada no seu repositório.

## O que ler em seguida

- Peça ao seu agente de IA para programação que mova o resto dos seus trabalhos: [Configure com um agente de IA para programação](https://docs.skipbox.dev/pt-br/ai-agents).
- VMs maiores: [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 não começa: [Um trabalho fica na fila](https://docs.skipbox.dev/pt-br/job-queued).

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