> ## 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 — Colección oficial de skills para agentes de IA de Laravel

> Presentamos «laravel/agent-skills», el repositorio oficial de skills para agentes de IA gestionado por Laravel. Se explica el resumen de las skills provistas como plugins para Claude Code y Cursor, cómo instalarlas y los detalles de cada una.

<Info>
  `laravel/agent-skills` es un repositorio en desarrollo activo (a fecha de abril de 2026). La versión actual del plugin es `1.0.0`, pero se esperan cambios y adiciones en el futuro.
</Info>

## ¿Qué es laravel/agent-skills?

[laravel/agent-skills](https://github.com/laravel/agent-skills) es un repositorio de colección de skills/plugins para agentes de IA gestionado oficialmente por Laravel. Taylor Otwell figura como autor, y está previsto que se desarrolle como un marketplace oficial de Laravel.

Originalmente comenzó como repositorio para colocar skills orientadas a Claude Code, pero se renombró a `agent-skills` y ahora ofrece plugins compatibles tanto con **Claude Code** como con **Cursor**.

Es un conjunto de skills concebido para que, al desarrollar aplicaciones Laravel con IA, los agentes comprendan las mejores prácticas de Laravel y puedan operar de forma autónoma servicios oficiales como Laravel Cloud o Nightwatch.

```mermaid theme={null}
graph TD
    A["laravel/agent-skills<br>(repositorio oficial de skills)"] --> B["laravel-simplifier<br>Agente de mejora de código Laravel"]
    A --> C["laravel-cloud<br>Skill de despliegue en Laravel Cloud"]
    A --> D["laravel-nightwatch<br>Skill de configuración de Nightwatch"]
    B --> E["Claude Code<br>.claude-plugin"]
    B --> F["Cursor<br>.cursor-plugin"]
    C --> E
    C --> F
    D --> E
    D --> F
    D --> G["Nightwatch<br>Servidor MCP"]
```

## Estructura del repositorio

El repositorio se divide en directorios por skill (plugin), y cada directorio contiene archivos de configuración para Claude Code y para Cursor.

```
laravel/agent-skills/
├── laravel/                      # Agente de mejora de código Laravel
│   ├── .claude-plugin/
│   │   └── plugin.json           # Definición del plugin de Claude Code
│   ├── .cursor-plugin/
│   │   └── plugin.json           # Definición del plugin de Cursor
│   └── agents/
│       └── laravel-simplifier.md # Prompt de sistema del agente
├── laravel-cloud/                # Skill de despliegue en Laravel Cloud
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── .cursor-plugin/
│   │   └── plugin.json
│   └── skills/
│       └── deploying-laravel-cloud/
└── laravel-nightwatch/           # Skill de configuración de Laravel Nightwatch
    ├── .claude-plugin/
    │   └── plugin.json
    ├── .cursor-plugin/
    │   └── plugin.json
    ├── .mcp.json                 # Configuración del servidor MCP de Nightwatch
    └── skills/
        └── configure-nightwatch/
```

## Plugins disponibles

### laravel — Agente de mejora de calidad de código

**laravel-simplifier** es un agente que revisa el código PHP/Laravel modificado recientemente y aumenta la claridad, consistencia y mantenibilidad del código sin cambiar su funcionalidad. En el repositorio se almacena en el directorio `laravel/`, y al instalarlo se indica como `laravel-simplifier@laravel`.

Funciones principales:

* Aplicación de las convenciones de Laravel y del estándar PSR-12
* Reducción de complejidad y anidamientos innecesarios
* Mejora de la legibilidad de nombres de variables y funciones
* Reorganización y consolidación de lógica relacionada
* Clarificación de condicionales mediante el uso de la expresión `match`

Por defecto, el agente sólo se centra en el "código modificado recientemente". Si lo invocas al finalizar una sesión de codificación, identifica automáticamente los cambios y propone refactorizaciones.

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

### laravel-cloud — Skill de despliegue y gestión de infraestructura

**laravel-cloud** es una skill que ayuda con el despliegue y la gestión de recursos en [Laravel Cloud](https://cloud.laravel.com). Conoce a fondo los patrones de comandos del CLI `cloud` y guía el procedimiento de despliegue paso a paso.

Funciones principales:

* Guía del flujo de despliegue inicial y de aplicaciones existentes
* Gestión de recursos de infraestructura como bases de datos, cachés, dominios y buckets
* Checklists de operación para tareas de varios pasos
* Operaciones acordes al patrón de comandos CRUD del Cloud CLI

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

### laravel-nightwatch — Skill de configuración de monitorización

**laravel-nightwatch** es una skill que ayuda con la configuración de recopilación de datos, tasas de muestreo, reglas de filtrado y políticas de redacción de [Laravel Nightwatch](https://nightwatch.laravel.com).

Además, incluye un **servidor MCP de Nightwatch** que permite a los agentes de IA consultar y operar directamente los issues de Nightwatch.

| Función                 | Descripción                                                                               |
| ----------------------- | ----------------------------------------------------------------------------------------- |
| Setup y configuración   | Guía la instalación de Nightwatch en la aplicación                                        |
| Muestreo y filtrado     | Control del volumen de datos mediante configuración de reglas                             |
| Redacción de PII        | Políticas de redacción para proteger datos sensibles                                      |
| Optimización de eventos | Optimización de recopilación de eventos para producción                                   |
| Integración MCP         | Consulta de issues, revisión de trazas, actualización de estados y añadido de comentarios |

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

## Cómo instalar

### Claude Code

Se instala usando la función de marketplace de Claude Code.

```bash theme={null}
# Añadir el marketplace
/plugin marketplace add laravel/agent-skills

# Instalar cada plugin
/plugin install laravel-simplifier@laravel
/plugin install laravel-cloud@laravel
/plugin install laravel-nightwatch@laravel
```

<Tip>
  Puedes instalar solo los plugins que necesites. No es necesario instalarlos todos.
</Tip>

### Cursor

En Cursor, busca **Laravel** en el panel del marketplace de plugins e instala.

<Steps>
  <Step title="Abre Cursor">
    Abre el panel «Plugins» desde la barra lateral o desde los ajustes de Cursor.
  </Step>

  <Step title="Busca Laravel">
    Escribe «**Laravel**» en la barra de búsqueda.
  </Step>

  <Step title="Instala los plugins que necesites">
    Instala de entre `laravel`, `laravel-cloud` y `laravel-nightwatch` los que necesites.
  </Step>
</Steps>

## Ejemplos de uso

### Automatizar la revisión de código con laravel-simplifier

Al invocarlo al final de una sesión de codificación, refina automáticamente el código escrito conforme a las mejores prácticas de Laravel.

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

El agente actúa de forma autónoma, identifica los archivos modificados y propone mejoras. Salvo indicación explícita, sólo se centra en el código modificado recientemente.

### Desplegar en Laravel Cloud

Puedes indicar el trabajo de despliegue en lenguaje natural. El agente combina y ejecuta adecuadamente los comandos del 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
```

### Investigar issues en Nightwatch

Como el servidor MCP de Nightwatch está integrado, puedes pedirle directamente a la IA que investigue issues.

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

## Cómo funcionan los plugins

Cada plugin se define en `.claude-plugin/plugin.json` o en `.cursor-plugin/plugin.json`. La definición del agente (archivo `.md`) contiene el prompt de sistema, en el que se estipula con detalle cómo debe comportarse la IA.

Fragmento del 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...
```

Las skills aportan conocimiento adicional a la IA en forma de archivos de contexto (documentos Markdown). Por ejemplo, la skill de laravel-cloud describe con detalle los pasos y precauciones para operar el Cloud CLI, guiando a la IA para no ejecutar despliegues erróneos.

## Perspectivas futuras

Está previsto que el repositorio `laravel/agent-skills` se consolide como el **marketplace oficial de skills de IA que cubre todo el ecosistema Laravel**.

Actualmente ofrece tres plugins (Laravel, Laravel Cloud y Laravel Nightwatch), pero se esperan ampliaciones como las siguientes:

* Soporte para otros paquetes oficiales de Laravel (Forge, Vapor, Cashier, Sanctum, etc.)
* Soporte para otras herramientas de IA además de Claude Code y Cursor, como GitHub Copilot
* Añadido de skills de terceros por parte de la comunidad (a modo de marketplace)

Ahora que el desarrollo con IA se está convirtiendo en un flujo de trabajo estándar, el hecho de que el equipo de Laravel ofrezca y gestione oficialmente skills de IA debería contribuir enormemente a la calidad general del ecosistema.

<Card title="Repositorio de laravel/agent-skills" icon="github" href="https://github.com/laravel/agent-skills">
  Consulta el README del repositorio oficial para ver detalles de las skills y los procedimientos de instalación.
</Card>

<Card title="Laravel Cloud" icon="cloud" href="https://cloud.laravel.com">
  Es el servicio de hosting oficial de Laravel con el que se integra la skill laravel-cloud.
</Card>

<Card title="Laravel Nightwatch" icon="eye" href="https://nightwatch.laravel.com">
  Es el servicio oficial de monitorización de errores de Laravel con el que se integra la skill laravel-nightwatch.
</Card>


## Related topics

- [Laravel PAO — Herramienta de optimización de salida para agentes de IA](/es/blog/pao-introduction.md)
- [Laravel Agent Detector — Paquete de detección de agentes de IA](/es/blog/agent-detector-introduction.md)
- [Crear un agente personalizado de Boost](/es/advanced/boost-custom-agent.md)
- [Skills](/es/packages/laravel-copilot-sdk/skills.md)
- [Laravel Package Skeleton — Plantilla oficial para paquetes](/es/blog/package-skeleton-introduction.md)
