> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# laravel/agent-skills — la raccolta ufficiale di skill per agenti AI di Laravel

> Presentiamo laravel/agent-skills, il repository di skill per agenti AI mantenuto ufficialmente da Laravel. Spiega la panoramica delle skill fornite come plugin per Claude Code e Cursor, il metodo di installazione e i dettagli di ogni skill.

<Info>
  `laravel/agent-skills` è un repository in sviluppo attivo (aprile 2026). La versione attuale del plugin è `1.0.0`, ma sono attesi cambiamenti e aggiunte di contenuti in futuro.
</Info>

## Cos'è laravel/agent-skills

[laravel/agent-skills](https://github.com/laravel/agent-skills) è la raccolta ufficiale, mantenuta da Laravel, di skill/plugin per agenti AI. È registrato con Taylor Otwell stesso come autore ed è previsto che venga sviluppato come marketplace ufficiale di Laravel.

Originariamente era nato come repository per raccogliere skill per Claude Code, ma è stato rinominato in `agent-skills` e ora fornisce plugin compatibili sia con **Claude Code** sia con **Cursor**.

È un insieme di skill che, quando si sviluppa un'applicazione Laravel con l'aiuto dell'AI, permette all'agente di comprendere le best practice di Laravel e di operare autonomamente anche su servizi ufficiali come Laravel Cloud e Nightwatch.

```mermaid theme={null}
graph TD
    A["laravel/agent-skills<br>(repository ufficiale di skill)"] --> B["laravel-simplifier<br>agente di miglioramento del codice Laravel"]
    A --> C["laravel-cloud<br>skill per il deploy su Laravel Cloud"]
    A --> D["laravel-nightwatch<br>skill di configurazione di Nightwatch"]
    B --> E["Claude Code<br>.claude-plugin"]
    B --> F["Cursor<br>.cursor-plugin"]
    C --> E
    C --> F
    D --> E
    D --> F
    D --> G["server MCP<br>di Nightwatch"]
```

## Struttura del repository

Il repository è suddiviso in directory per ciascuna skill (plugin), e in ogni directory sono contenuti i file di configurazione per Claude Code e per Cursor.

```
laravel/agent-skills/
├── laravel/                      # Agente di miglioramento del codice Laravel
│   ├── .claude-plugin/
│   │   └── plugin.json           # Definizione del plugin per Claude Code
│   ├── .cursor-plugin/
│   │   └── plugin.json           # Definizione del plugin per Cursor
│   └── agents/
│       └── laravel-simplifier.md # System prompt dell'agente
├── laravel-cloud/                # Skill per il deploy su Laravel Cloud
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── .cursor-plugin/
│   │   └── plugin.json
│   └── skills/
│       └── deploying-laravel-cloud/
└── laravel-nightwatch/           # Skill di configurazione di Laravel Nightwatch
    ├── .claude-plugin/
    │   └── plugin.json
    ├── .cursor-plugin/
    │   └── plugin.json
    ├── .mcp.json                 # Configurazione del server MCP di Nightwatch
    └── skills/
        └── configure-nightwatch/
```

## Plugin forniti

### laravel — agente di miglioramento della qualità del codice

**laravel-simplifier** è un agente che rivede il codice PHP/Laravel modificato di recente e ne migliora la chiarezza, la coerenza e la manutenibilità senza cambiarne il comportamento. Nel repository si trova nella directory `laravel/` e, in fase di installazione, si specifica `laravel-simplifier@laravel`.

Funzionalità principali:

* Applicazione delle convenzioni di Laravel e dello standard PSR-12
* Riduzione della complessità e dell'annidamento superflui
* Miglioramento della leggibilità di nomi di variabili e funzioni
* Organizzazione e consolidamento della logica correlata
* Chiarificazione dei branch condizionali tramite l'uso dell'espressione `match`

L'agente, per impostazione predefinita, considera solo "il codice modificato di recente". Se lo invochi al termine di una sessione di coding, individua automaticamente le parti modificate e propone il refactoring.

```
> Review recent changes using the laravel-simplifier agent
```

### laravel-cloud — skill di gestione di deploy e infrastruttura

**laravel-cloud** è una skill che supporta il deploy e la gestione delle risorse su [Laravel Cloud](https://cloud.laravel.com). Conosce a fondo i pattern dei comandi della CLI `cloud` e guida passo passo la procedura di deploy.

Funzionalità principali:

* Guida del workflow di primo deploy o di deploy di app esistenti
* Gestione delle risorse infrastrutturali come database, cache, domini e bucket
* Checklist operative per attività multi-step
* Operazioni conformi ai pattern di comando CRUD della CLI Cloud

```
> Deploy my app to Laravel Cloud
> Set up a database and cache for the staging environment
```

### laravel-nightwatch — skill di configurazione del monitoraggio

**laravel-nightwatch** è una skill che assiste nella configurazione della raccolta dati, dei sampling rate, delle regole di filtraggio e delle policy di redaction di [Laravel Nightwatch](https://nightwatch.laravel.com).

Inoltre, include il **server MCP di Nightwatch**, che permette all'agente AI di consultare e operare direttamente sui problemi di Nightwatch.

| Funzionalità                | Descrizione                                                                                                 |
| --------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Setup e configurazione      | Guida il setup di Nightwatch nell'applicazione                                                              |
| Sampling e filtering        | Controllo del volume di dati tramite regole                                                                 |
| Redaction di PII            | Policy di redaction per proteggere i dati sensibili                                                         |
| Ottimizzazione degli eventi | Ottimizzazione della raccolta di eventi per ambienti di produzione                                          |
| Integrazione MCP            | Visualizzazione dei problemi, controllo degli stack trace, aggiornamento dello stato e aggiunta di commenti |

```
> Configure Nightwatch sampling rates for production
> Set up PII redaction for Nightwatch
```

## Metodo di installazione

### Claude Code

Si installa usando la funzione marketplace di Claude Code.

```bash theme={null}
# Aggiunta del marketplace
/plugin marketplace add laravel/agent-skills

# Installazione di ciascun plugin
/plugin install laravel-simplifier@laravel
/plugin install laravel-cloud@laravel
/plugin install laravel-nightwatch@laravel
```

<Tip>
  Puoi installare solo i plugin che ti servono. Non è necessario installarli tutti.
</Tip>

### Cursor

Nel caso di Cursor, cerca **Laravel** nel pannello del marketplace dei plugin e installalo.

<Steps>
  <Step title="Apri Cursor">
    Apri il pannello "Plugins" dalla barra laterale o dalle impostazioni di Cursor.
  </Step>

  <Step title="Cerca Laravel">
    Digita "**Laravel**" nella barra di ricerca.
  </Step>

  <Step title="Installa i plugin necessari">
    Installa quelli che ti servono tra `laravel`, `laravel-cloud` e `laravel-nightwatch`.
  </Step>
</Steps>

## Esempi d'uso

### Automatizzare la code review con laravel-simplifier

Invocandolo al termine della sessione di coding, il codice scritto viene automaticamente rifinito seguendo le best practice di Laravel.

```
> Review recent changes using the laravel-simplifier agent
```

L'agente lavora autonomamente, individua i file modificati e propone miglioramenti. A meno che tu non lo istruisca esplicitamente, considera solo il codice modificato di recente.

### Deploy su Laravel Cloud

Puoi impartire le operazioni di deploy in linguaggio naturale. L'agente combina ed esegue in modo appropriato i comandi della CLI `cloud`.

```
> Deploy my app to Laravel Cloud
> Set up a database and cache for the staging environment
> Add a custom domain to my production environment
```

### Investigare i problemi in Nightwatch

Poiché il server MCP di Nightwatch è integrato, puoi chiedere direttamente all'AI di indagare sui problemi.

```
> Show me the latest errors in Nightwatch
> What's the stack trace for issue #42?
> Mark issue #42 as resolved
```

## Come funzionano i plugin

Ogni plugin è definito in `.claude-plugin/plugin.json` o in `.cursor-plugin/plugin.json`. Nella definizione dell'agente (file `.md`) viene descritto il system prompt, che regola nel dettaglio come l'AI deve comportarsi.

Un estratto del prompt di laravel-simplifier:

```
You are an expert PHP/Laravel code simplification specialist focused on 
enhancing code clarity, consistency, and maintainability while preserving 
exact functionality...
```

Le skill forniscono all'AI conoscenza aggiuntiva sotto forma di file di contesto (documenti Markdown). Ad esempio, la skill laravel-cloud descrive in dettaglio le procedure operative e i punti di attenzione della CLI Cloud, guidando l'AI affinché non esegua deploy errati.

## Prospettive future

Il repository `laravel/agent-skills` è pensato per essere sviluppato come **marketplace ufficiale di skill AI che copre l'intero ecosistema Laravel**.

Attualmente sono forniti tre plugin per Laravel, Laravel Cloud e Laravel Nightwatch, ma in futuro sono attese estensioni come:

* Supporto per altri pacchetti ufficiali Laravel (Forge, Vapor, Cashier, Sanctum, ecc.)
* Supporto per strumenti AI diversi da Claude Code e Cursor, come GitHub Copilot
* Aggiunta di skill di terze parti dalla community (trasformazione in marketplace)

Ora che lo sviluppo assistito dall'AI sta diventando un workflow standard, il fatto che il team di Laravel fornisca e mantenga ufficialmente le skill AI dovrebbe contribuire notevolmente al miglioramento della qualità dell'intero ecosistema.

<Card title="Repository laravel/agent-skills" icon="github" href="https://github.com/laravel/agent-skills">
  Per i dettagli delle skill e la procedura di installazione, consulta il README del repository ufficiale.
</Card>

<Card title="Laravel Cloud" icon="cloud" href="https://cloud.laravel.com">
  Il servizio di hosting ufficiale di Laravel che si integra con la skill laravel-cloud.
</Card>

<Card title="Laravel Nightwatch" icon="eye" href="https://nightwatch.laravel.com">
  Il servizio ufficiale di monitoraggio degli errori di Laravel che si integra con la skill laravel-nightwatch.
</Card>


## Related topics

- [Laravel PAO — strumento di ottimizzazione dell'output per agenti AI](/it/blog/pao-introduction.md)
- [Agenti personalizzati](/it/packages/laravel-copilot-sdk/custom-agents.md)
- [Laravel Agent Detector — pacchetto per rilevare gli agenti AI](/it/blog/agent-detector-introduction.md)
- [Skills](/it/packages/laravel-copilot-sdk/skills.md)
- [Creare un agente personalizzato per Boost](/it/advanced/boost-custom-agent.md)