> ## 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 collection officielle de skills d'agents IA Laravel

> Présentation du dépôt de skills d'agents IA « laravel/agent-skills » géré officiellement par Laravel. Vue d'ensemble des skills fournis sous forme de plugins pour Claude Code et Cursor, méthode d'installation et détails de chaque skill.

<Info>
  `laravel/agent-skills` est un dépôt en développement actif (à la date d'avril 2026). La version actuelle du plugin est `1.0.0`, mais des modifications et ajouts sont attendus par la suite.
</Info>

## Qu'est-ce que laravel/agent-skills ?

[laravel/agent-skills](https://github.com/laravel/agent-skills) est un dépôt de collection de skills et de plugins pour agents IA, géré officiellement par Laravel. Taylor Otwell lui-même est enregistré comme auteur, et il est destiné à devenir la marketplace officielle Laravel.

À l'origine, ce dépôt hébergeait uniquement des skills pour Claude Code, mais il a été renommé `agent-skills` et propose désormais des plugins compatibles à la fois avec **Claude Code** et **Cursor**.

Il s'agit d'un ensemble de skills conçus pour permettre aux agents IA de comprendre les bonnes pratiques Laravel et d'exploiter de manière autonome les services officiels tels que Laravel Cloud ou Nightwatch, lors du développement d'applications Laravel assisté par IA.

```mermaid theme={null}
graph TD
    A["laravel/agent-skills<br>(dépôt de skills officiels)"] --> B["laravel-simplifier<br>Agent d'amélioration du code Laravel"]
    A --> C["laravel-cloud<br>Skill de déploiement Laravel Cloud"]
    A --> D["laravel-nightwatch<br>Skill de configuration Nightwatch"]
    B --> E["Claude Code<br>.claude-plugin"]
    B --> F["Cursor<br>.cursor-plugin"]
    C --> E
    C --> F
    D --> E
    D --> F
    D --> G["Serveur MCP<br>Nightwatch"]
```

## Structure du dépôt

Le dépôt est organisé par répertoire pour chaque skill (plugin), et chaque répertoire contient les fichiers de configuration pour Claude Code et Cursor.

```
laravel/agent-skills/
├── laravel/                      # Agent d'amélioration du code Laravel
│   ├── .claude-plugin/
│   │   └── plugin.json           # Définition du plugin Claude Code
│   ├── .cursor-plugin/
│   │   └── plugin.json           # Définition du plugin Cursor
│   └── agents/
│       └── laravel-simplifier.md # Prompt système de l'agent
├── laravel-cloud/                # Skill de déploiement Laravel Cloud
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── .cursor-plugin/
│   │   └── plugin.json
│   └── skills/
│       └── deploying-laravel-cloud/
└── laravel-nightwatch/           # Skill de configuration Laravel Nightwatch
    ├── .claude-plugin/
    │   └── plugin.json
    ├── .cursor-plugin/
    │   └── plugin.json
    ├── .mcp.json                 # Configuration du serveur MCP Nightwatch
    └── skills/
        └── configure-nightwatch/
```

## Plugins fournis

### laravel — agent d'amélioration de la qualité du code

**laravel-simplifier** est un agent qui passe en revue le code PHP/Laravel modifié récemment et améliore sa clarté, sa cohérence et sa maintenabilité sans en changer le comportement. Dans le dépôt, il se trouve dans le répertoire `laravel/` ; il s'installe avec `laravel-simplifier@laravel`.

Fonctionnalités principales :

* Application des conventions Laravel et de la norme PSR-12
* Réduction de la complexité et de l'imbrication inutiles
* Amélioration de la lisibilité des noms de variables et de fonctions
* Organisation et regroupement des logiques associées
* Clarification des branchements conditionnels grâce à l'expression `match`

Par défaut, l'agent ne cible que le « code récemment modifié ». En l'appelant à la fin d'une session de codage, il identifie automatiquement les zones modifiées et propose des refactorings.

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

### laravel-cloud — skill de déploiement et de gestion d'infrastructure

**laravel-cloud** est un skill qui assiste le déploiement et la gestion des ressources sur [Laravel Cloud](https://cloud.laravel.com). Il maîtrise les schémas de commandes du CLI `cloud` et guide pas à pas la procédure de déploiement.

Fonctionnalités principales :

* Guides pour le premier déploiement et le workflow de déploiement d'applications existantes
* Gestion des ressources d'infrastructure : base de données, cache, domaine, bucket, etc.
* Checklists opérationnelles pour les tâches multi-étapes
* Opérations conformes aux schémas CRUD du CLI Cloud

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

### laravel-nightwatch — skill de configuration de la supervision

**laravel-nightwatch** est un skill qui aide à configurer la collecte de données, les taux d'échantillonnage, les règles de filtrage et les politiques de redaction de [Laravel Nightwatch](https://nightwatch.laravel.com).

De plus, il embarque le **serveur MCP Nightwatch**, ce qui permet aux agents IA de consulter et manipuler directement les problèmes Nightwatch.

| Fonction                    | Description                                                                                             |
| --------------------------- | ------------------------------------------------------------------------------------------------------- |
| Setup et configuration      | Guide de la mise en place de Nightwatch dans l'application                                              |
| Échantillonnage et filtrage | Contrôle du volume de données via des règles                                                            |
| Redaction PII               | Politique de redaction protégeant les données sensibles                                                 |
| Optimisation des événements | Optimisation de la collecte d'événements pour la production                                             |
| Intégration MCP             | Consultation des problèmes, vérification des stack traces, mise à jour de statut, ajout de commentaires |

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

## Méthode d'installation

### Claude Code

L'installation se fait via la fonctionnalité marketplace de Claude Code.

```bash theme={null}
# Ajout à la marketplace
/plugin marketplace add laravel/agent-skills

# Installation de chaque plugin
/plugin install laravel-simplifier@laravel
/plugin install laravel-cloud@laravel
/plugin install laravel-nightwatch@laravel
```

<Tip>
  Vous pouvez n'installer que les plugins nécessaires. Il n'est pas obligatoire de tout installer.
</Tip>

### Cursor

Sur Cursor, ouvrez le panneau marketplace des plugins et recherchez **Laravel** pour installer.

<Steps>
  <Step title="Ouvrir Cursor">
    Ouvrez le panneau « Plugins » depuis la barre latérale ou les paramètres de Cursor.
  </Step>

  <Step title="Rechercher Laravel">
    Saisissez « **Laravel** » dans la barre de recherche.
  </Step>

  <Step title="Installer les plugins nécessaires">
    Installez les plugins de votre choix parmi `laravel`, `laravel-cloud` et `laravel-nightwatch`.
  </Step>
</Steps>

## Exemples d'utilisation

### Automatiser la revue de code avec laravel-simplifier

En l'appelant à la fin d'une session de codage, il affine automatiquement le code écrit conformément aux bonnes pratiques Laravel.

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

L'agent fonctionne de manière autonome, identifie les fichiers modifiés et propose des améliorations. Sauf indication explicite contraire, seul le code récemment modifié est pris en compte.

### Déploiement sur Laravel Cloud

Vous pouvez indiquer les opérations de déploiement en langage naturel. L'agent combine et exécute les commandes du CLI `cloud` de manière appropriée.

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

### Investiguer des problèmes dans Nightwatch

Grâce à l'intégration du serveur MCP Nightwatch, vous pouvez demander directement à l'IA d'enquêter sur les problèmes.

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

## Fonctionnement des plugins

Chaque plugin est défini par `.claude-plugin/plugin.json` ou `.cursor-plugin/plugin.json`. La définition de l'agent (fichier `.md`) contient le prompt système décrivant en détail le comportement attendu de l'IA.

Extrait du prompt de laravel-simplifier :

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

Les skills fournissent à l'IA des connaissances supplémentaires sous forme de fichiers de contexte (documents Markdown). Par exemple, le skill laravel-cloud décrit en détail la marche à suivre et les points de vigilance du CLI Cloud, afin de guider l'IA pour qu'elle n'exécute pas de déploiement erroné.

## Perspectives

Le dépôt `laravel/agent-skills` est appelé à devenir la **marketplace officielle de skills IA couvrant l'ensemble de l'écosystème Laravel**.

Actuellement, trois plugins sont proposés (Laravel, Laravel Cloud, Laravel Nightwatch), mais on peut anticiper les extensions suivantes :

* Prise en charge d'autres packages officiels Laravel (Forge, Vapour, Cashier, Sanctum, etc.)
* Prise en charge d'outils IA autres que Claude Code et Cursor, tels que GitHub Copilot
* Ajout de skills tiers issus de la communauté (marketplace)

Alors que le développement assisté par IA devient un workflow standard, le fait que l'équipe Laravel fournisse et gère officiellement des skills IA devrait contribuer significativement à l'amélioration de la qualité de l'ensemble de l'écosystème.

<Card title="Dépôt laravel/agent-skills" icon="github" href="https://github.com/laravel/agent-skills">
  Consultez le README du dépôt officiel pour les détails des skills et la procédure d'installation.
</Card>

<Card title="Laravel Cloud" icon="cloud" href="https://cloud.laravel.com">
  Service d'hébergement officiel Laravel avec lequel le skill laravel-cloud interagit.
</Card>

<Card title="Laravel Nightwatch" icon="eye" href="https://nightwatch.laravel.com">
  Service officiel Laravel de supervision d'erreurs avec lequel le skill laravel-nightwatch interagit.
</Card>


## Related topics

- [Laravel Agent Detector — package de détection d'agents IA](/fr/blog/agent-detector-introduction.md)
- [Skills](/fr/packages/laravel-copilot-sdk/skills.md)
- [Laravel et le développement IA](/fr/ai.md)
- [Créer un agent personnalisé pour Boost](/fr/advanced/boost-custom-agent.md)
- [Laravel Boost](/fr/boost.md)
