Mastering Laravel Boost 2.0: Optimizing AI Context with Skills and MCP

AI agents have changed how we write code, but they often struggle with the nuances of specific frameworks. Standard models like Claude 3.5 Sonnet or GPT-4o possess vast general knowledge but lack the hyper-specific context of your local Laravel project. This lead to hallucinations, outdated syntax, or the AI suggesting patterns that conflict with your application's architecture.

Laravel Boost solves this by acting as a bridge. It injects project-specific metadata, documentation, and "skills" directly into your AI agent's reasoning loop. Instead of manually feeding documentation to a chat window, Boost automates the context delivery. Version 2.0 introduces a major shift from a monolithic guideline approach to a modular, "skills-first" architecture. This reduces context bloat, saves on token costs, and makes the AI significantly more accurate by only providing the information it needs at that exact moment.

Prerequisites

To follow this guide and implement Boost 2.0, you should be comfortable with the following:

• PHP 8.2+: Boost 2.0 has officially dropped support for PHP 8.1.
• Laravel 11 or 12: Older versions like Laravel 10 are supported only by legacy versions of Boost (v1.x).
• Composer: Basic knowledge of managing PHP dependencies.
• AI Coding Agents: Familiarity with tools like Cursor, Claude Code, GitHub Copilot, or Juni.

Key Libraries & Tools

• Laravel Boost: The core CLI tool and package that manages AI context and skills.
• Laravel MCP: A package for building Model Context Protocol servers, allowing AI agents to interact with your app's internal state (routes, database schemas, etc.).
• Remotion: A React-based framework for programmatic video creation, often used as a demonstration of complex AI skill integration.
• Prism: A Laravel package for working with LLMs, used to demonstrate how documentation can be bundled directly into vendor folders for AI consumption.

Code Walkthrough: Installing and Configuring Boost 2.0

Setting up Boost 2.0 is a methodical process. It begins with the Laravel installer and moves into a randomized, aesthetically pleasing configuration CLI.

1. Installation

First, ensure your Laravel installer is up to date to access the built-in Boost prompts during new project creation. If you are adding it to an existing project, use Composer:

composer require laravel/boost --dev

2. Initialization

Run the install command to start the interactive configuration.

php artisan boost:install

This command triggers a CLI interface featuring randomized gradients—a touch of "developer joy" added by Pushpak Chhajed. You will be prompted to select which features to configure: AI Guidelines, Agent Skills, or the Model Context Protocol server.

3. Selecting Your AI Agent

Boost 2.0 simplifies agent selection. Instead of choosing both an IDE and an agent, you now choose the specific agentic tool you use daily, such as Claude Code or Cursor. Boost will then automatically determine the correct file paths for these tools.

4. Automated Skill Syncing

To ensure your AI context stays updated as your project evolves, add the update command to your composer.json file:

"scripts": {
    "post-update-cmd": [
        "@php artisan boost:update"
    ]
}

This ensures that every time you update your dependencies, Boost re-scans your composer.json and syncs the relevant skills for packages like Inertia.js, Tailwind CSS, or Livewire.

Deep Dive into Skills vs. Guidelines

Understanding the distinction between these two features is critical for a clean development workflow.

Guidelines: The Global Rules

Guidelines are persistent. They contain high-level rules that the AI should always know. For example, if you always use Pest for testing or strictly follow an Action-based architecture, these belong in your guidelines. However, shoving every package's documentation into a guideline leads to "context fatigue," where the AI becomes overwhelmed and starts to hallucinate.

Skills: The On-Demand Context

Skills are modular Markdown files. They aren't loaded into the AI's memory until they are needed. Each skill has a name and a description in its front matter. When you ask the AI to "build a new UI component with Tailwind," the agent sees the keyword "Tailwind," looks at its available skills, and activates the Tailwind CSS skill. This keeps the prompt lean and the output precise.

Syntax Notes: Custom Skill Creation

Creating a custom skill allows you to automate highly specific tasks, like generating pull request descriptions or adhering to internal API versioning standards. Skills rely on a specific Markdown front matter format.

---
name: my-custom-skill
description: Use this skill when generating API endpoints or PR descriptions.
---

# My Custom Skill Rules
- Always use the `App\Actions` namespace for business logic.
- Ensure all API responses are wrapped in a standard `JsonResource`.
- Pull Request descriptions must include a 'Breaking Changes' section.

When you save this in a local .boost/skills directory and run php artisan boost:update, Boost replicates this file into the hidden configuration folders of your chosen AI agents (e.g., .cursor/rules or .claudecode/skills).

Practical Examples

Automating Pull Requests

You can create a skill that teaches an agent how to use the GitHub CLI. By invoking the skill with a slash command (e.g., /create-pr), the AI can analyze your staged changes, write a formatted description, and execute the CLI command to open the PR.

Package-Specific Intelligence

If you build a project using Filament, you don't want the AI thinking about Filament when you are just debugging a console command. By using a Filament skill, the AI only accesses those specific layout and component rules when you are actively working on the admin panel.

Tips & Gotchas

• Git Management: Never commit the auto-generated agent folders (like .cursor/rules) to your repository. These are local mirrors. Only commit the .boost folder and your boost.json file. This allows your teammates to run boost:install and get the exact same AI behavior on their machines.
• Hallucination Prevention: If your AI starts ignoring your project structure, check your guideline length. If it exceeds 500 lines, move package-specific rules into individual skills.
• Legacy Projects: Do not attempt to use Boost 2.0 on Laravel 10 projects. The dependency tree for the new Model Context Protocol features and skills requires the modern internals found in Laravel 11 and up.
• Manual Invocation: If an agent fails to auto-detect a skill, you can usually force it by using a slash command in the chat interface. Most modern agents support / to list and select active skills.