# Configurare con un agente di coding IA

> Fai spostare i tuoi job GitHub Actions su Skipbox a Claude Code, Codex, Cursor o un altro agente di coding IA: installa la skill, chiedi, e rivedi la pull request.

Il tuo agente di coding IA può spostare i tuoi job GitHub Actions su Skipbox. Tu installi la GitHub App. L'agente trova i job che conviene spostare, cambia la loro riga `runs-on`, aggiunge gli step di setup che servono a ogni job, e apre una pull request da rivedere.

## Installa la skill

La skill è un file Markdown in [skipbox-dev/skills](https://github.com/skipbox-dev/skills) su GitHub. Dice all'agente quali job spostare, le etichette e le dimensioni, cosa contiene l'immagine del runner, e come sistemare un job che fallisce o resta in coda. Installala in uno di questi tre modi.

Con skills.sh, per Claude Code, Codex, Cursor e altri agenti:

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

Come plugin di Claude Code. Aggiungi il marketplace:

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

Poi installa il plugin:

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

A mano: copia [`SKILL.md`](https://github.com/skipbox-dev/skills/blob/main/skills/skipbox-github-runners/SKILL.md) nella cartella delle skill o delle regole del tuo agente. Per Claude Code è:

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

## Chiedi al tuo agente

Apri il repository nel tuo agente e chiedi con parole tue:

```text
Sposta i nostri job di CI Linux su Skipbox e apri una pull request
Quali dei nostri workflow costano di più su GitHub Actions? Quali conviene spostare?
Questo job fallisce su Skipbox con "command not found": sistemalo
Questo job è in coda da quando l'abbiamo spostato su Skipbox: scopri perché
```

L'agente parte da un solo job, così la sua prima esecuzione mostra se manca un tool. Lascia i job macOS, Windows e Arm sui runner di GitHub.

## Cosa l'agente non può fare al posto tuo

- **Accedere e installare l'app di Skipbox.** Fai i passi 1 e 2 dell'[Avvio rapido](https://docs.skipbox.dev/it/quickstart) sull'account che possiede il repository. Quale app va su un'organizzazione e quale su un account personale è in [Organizzazioni e account personali](https://docs.skipbox.dev/it/accounts).
- **Scegliere un piano.** La prova gratuita non chiede la carta e parte con il primo job: 7 giorni o 3000 minuti di job, quello che arriva prima. Dopo, scegli il piano. Vedi [Piani](https://docs.skipbox.dev/it/plans).

Qui Skipbox non cambia i tuoi workflow: la modifica è la pull request che apre il tuo agente, e il merge lo fai tu. Per far aprire quella pull request a Skipbox, premi **Apri una pull request** accanto al repository nella pagina del tuo account (vedi [Permessi della GitHub App](https://docs.skipbox.dev/it/permissions)).

## Senza la skill

Ogni pagina di questa documentazione è anche in Markdown: aggiungi `.md` al suo indirizzo. L'elenco di tutte le pagine è in `https://docs.skipbox.dev/llms.txt`. Un agente senza la skill può leggere direttamente la documentazione, partendo da queste:

- I passi: [Avvio rapido](https://docs.skipbox.dev/it/quickstart).
- Quale etichetta scrivere: [Etichette e dimensioni](https://docs.skipbox.dev/it/labels).
- Cosa è installato sulla VM: [Immagine del runner](https://docs.skipbox.dev/it/runner-image).
- Un job che passava sui runner di GitHub e qui fallisce: [Un job fallisce dopo il passaggio](https://docs.skipbox.dev/it/migration).

Durante la prova, l'etichetta è `skipbox`. Per qualsiasi altra cosa, scrivi a hello@skipbox.dev.

Aggiornata il giorno 2026-11-12 · https://docs.skipbox.dev/it/ai-agents
