> ## 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 — Laravel's official AI agent skills

> An introduction to Laravel's officially managed AI agent skills repository, laravel/agent-skills. An overview of skills provided as plugins for Claude Code and Cursor, including installation and details on each skill.

<Info>
  `laravel/agent-skills` is a repository under active development (as of April 2026). The current plugin version is `1.0.0`, but changes and additions are expected going forward.
</Info>

## What is laravel/agent-skills?

[laravel/agent-skills](https://github.com/laravel/agent-skills) is an officially maintained collection of AI agent skills and plugins from Laravel. Taylor Otwell is listed as an author, and it is being developed as Laravel's official marketplace.

The repository originally started as a place to host Claude Code skills, but was renamed to `agent-skills` and now offers plugins compatible with both **Claude Code** and **Cursor**.

It's a set of skills that lets AI agents understand Laravel best practices and autonomously operate official services like Laravel Cloud and Nightwatch when you develop Laravel apps with AI.

```mermaid theme={null}
graph TD
    A["laravel/agent-skills<br>(official skills repo)"] --> B["laravel-simplifier<br>Laravel code improvement agent"]
    A --> C["laravel-cloud<br>Laravel Cloud deploy skill"]
    A --> D["laravel-nightwatch<br>Nightwatch configuration skill"]
    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>MCP server"]
```

## Repository structure

The repository has a directory per skill (plugin), and each directory contains configuration files for both Claude Code and Cursor.

```
laravel/agent-skills/
├── laravel/                      # Laravel code improvement agent
│   ├── .claude-plugin/
│   │   └── plugin.json           # Claude Code plugin definition
│   ├── .cursor-plugin/
│   │   └── plugin.json           # Cursor plugin definition
│   └── agents/
│       └── laravel-simplifier.md # Agent system prompt
├── laravel-cloud/                # Laravel Cloud deploy skill
│   ├── .claude-plugin/
│   │   └── plugin.json
│   ├── .cursor-plugin/
│   │   └── plugin.json
│   └── skills/
│       └── deploying-laravel-cloud/
└── laravel-nightwatch/           # Laravel Nightwatch configuration skill
    ├── .claude-plugin/
    │   └── plugin.json
    ├── .cursor-plugin/
    │   └── plugin.json
    ├── .mcp.json                 # Nightwatch MCP server configuration
    └── skills/
        └── configure-nightwatch/
```

## Provided plugins

### laravel — code quality improvement agent

**laravel-simplifier** is an agent that reviews recently changed PHP/Laravel code and improves clarity, consistency, and maintainability without changing behavior. It lives in the `laravel/` directory inside the repository and is installed as `laravel-simplifier@laravel`.

Key features:

* Applies Laravel conventions and the PSR-12 standard
* Reduces unnecessary complexity and nesting
* Improves variable and function name readability
* Organizes and consolidates related logic
* Clarifies conditional branching using `match` expressions

By default the agent targets only "recently changed code." Calling it at the end of a coding session automatically identifies the changed sections and suggests refactorings.

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

### laravel-cloud — deployment and infrastructure management skill

**laravel-cloud** is a skill that assists with deployment and resource management on [Laravel Cloud](https://cloud.laravel.com). It's fully familiar with `cloud` CLI command patterns and guides you through deployment steps.

Key features:

* Guides workflows for initial deploys and deploying existing apps
* Manages infrastructure resources such as databases, caches, domains, and buckets
* Operational checklists for multi-step tasks
* Operates according to the Cloud CLI's CRUD command patterns

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

### laravel-nightwatch — monitoring configuration skill

**laravel-nightwatch** is a skill that helps configure [Laravel Nightwatch](https://nightwatch.laravel.com) data collection, sampling rates, filtering rules, and redaction policies.

It also bundles a **Nightwatch MCP server**, allowing AI agents to directly view and operate on Nightwatch issues.

| Feature                 | Description                                                        |
| ----------------------- | ------------------------------------------------------------------ |
| Setup and configuration | Guides Nightwatch setup for your app                               |
| Sampling and filtering  | Controls data volume with rule configuration                       |
| PII redaction           | Redaction policies to protect sensitive data                       |
| Event optimization      | Optimizes event collection for production                          |
| MCP integration         | View issues, inspect stack traces, update status, and add comments |

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

## Installation

### Claude Code

Install using Claude Code's marketplace feature.

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

# Install individual plugins
/plugin install laravel-simplifier@laravel
/plugin install laravel-cloud@laravel
/plugin install laravel-nightwatch@laravel
```

<Tip>
  You can install only the plugins you need—there's no need to install all of them.
</Tip>

### Cursor

In Cursor, open the plugin marketplace panel and search for **Laravel** to install.

<Steps>
  <Step title="Open Cursor">
    Open the "Plugins" panel from Cursor's sidebar or settings.
  </Step>

  <Step title="Search for Laravel">
    Type "**Laravel**" into the search bar.
  </Step>

  <Step title="Install the plugins you need">
    Install what you need from `laravel`, `laravel-cloud`, and `laravel-nightwatch`.
  </Step>
</Steps>

## Usage examples

### Automating code review with laravel-simplifier

Call it at the end of a coding session to automatically refine your code following Laravel best practices.

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

The agent runs autonomously, identifies changed files, and proposes improvements. Unless you explicitly instruct otherwise, only recently changed code is targeted.

### Deploying to Laravel Cloud

You can instruct deployment tasks in natural language. The agent combines and executes the appropriate `cloud` CLI commands.

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

### Investigating issues in Nightwatch

Because the Nightwatch MCP server is integrated, you can ask the AI to investigate issues directly.

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

## How plugins work

Each plugin is defined in `.claude-plugin/plugin.json` or `.cursor-plugin/plugin.json`. The agent definition (`.md` file) contains the system prompt, which precisely specifies how the AI should behave.

An excerpt from the laravel-simplifier prompt:

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

Skills provide additional knowledge to the AI in the form of context files (Markdown documents). For example, the laravel-cloud skill contains detailed Cloud CLI operations and cautions, guiding the AI to avoid mistaken deployments.

## Future outlook

The `laravel/agent-skills` repository is being developed as **the official AI skill marketplace covering the entire Laravel ecosystem**.

Currently three plugins are provided (Laravel, Laravel Cloud, and Laravel Nightwatch), but future expansions expected include:

* Support for other official Laravel packages (Forge, Vapor, Cashier, Sanctum, etc.)
* Support for AI tools other than Claude Code and Cursor, such as GitHub Copilot
* Community-contributed third-party skills (marketplace expansion)

As AI-driven development becomes a standard workflow, having the Laravel team officially provide and manage AI skills should significantly contribute to the ecosystem's overall quality.

<Card title="laravel/agent-skills repository" icon="github" href="https://github.com/laravel/agent-skills">
  See the official repository README for skill details and installation instructions.
</Card>

<Card title="Laravel Cloud" icon="cloud" href="https://cloud.laravel.com">
  Laravel's official hosting service that integrates with the laravel-cloud skill.
</Card>

<Card title="Laravel Nightwatch" icon="eye" href="https://nightwatch.laravel.com">
  Laravel's official error monitoring service that integrates with the laravel-nightwatch skill.
</Card>


## Related topics

- [Laravel Agent Detector — AI agent detection package](/en/blog/agent-detector-introduction.md)
- [Laravel PAO — output optimization for AI agents](/en/blog/pao-introduction.md)
- [Skills](/en/packages/laravel-copilot-sdk/skills.md)
- [Creating a Custom Agent for Boost](/en/advanced/boost-custom-agent.md)
- [Laravel Package Skeleton — the official starter template for packages](/en/blog/package-skeleton-introduction.md)