Skip to content

Conversation

@pushpak1300
Copy link
Member

@pushpak1300 pushpak1300 commented Jan 13, 2026

This PR introduces Agent Skills to Laravel Boost, enabling domain-specific knowledge to be loaded on-demand rather than eagerly loading everything at once.

Problem

Laravel Boost loads a single, comprehensive guidelines file upfront, causing:

  • Context bloat: All guidance loaded regardless of relevance
  • Reduced relevance: Generic guidance when specific guidance is needed

Solution

Skills are lightweight, targeted files for specific packages that agents can activate when needed:

  • Detailed patterns for Livewire, Pest, Inertia, Tailwind, etc. move to skills
  • Guidelines become concise, always-needed context (core conventions only)
  • Skills are automatically installed based on packages in composer.json

User Experience

Nothing changes from the user's perspective:

  • boost:install works exactly the same
  • No new prompts or configuration steps
  • Skills are automatically installed for installed packages

Key Behaviors

Automatic Installation

When users run boost:install, all available skills for their installed packages are automatically installed:

composer.json has livewire/livewire → livewire-development skill installed
composer.json has pestphp/pest → pest-testing skill installed

Skill Activation

Users ask the agent to activate a skill when working on specific domains:

  • "Activate livewire-development to help with component patterns"
  • "Activate pest-testing for test assertions"

Override Examples

Example 1: Replace a skill entirely

.ai/skills/nuxt-development/SKILL.md  (user's custom skill)

This skills is copied as it is to skills.

Example 2: Version-specific override

.ai/livewire/3/skill/livewire-development/SKILL.md  (user's Livewire v3 skill)

This overrides only the v3 skill for livewire-developmenet.

Override Priority (Highest to Lowest)

Priority Location Scope
1 (Highest) .ai/skills/{name}/ User explicit skill (overrides all)
2 .ai/{package}/{version}/skill/{name}/ User version-specific override
3 .ai/{package}/skill/{name}/ User root-level override
4 Boost built-in version-specific skill Framework version-specific
5 Boost built-in root-level skill Framework default
6 (Lowest) Third-party package skill From vendor packages

What Skills Include

Each skill has:

  • Frontmatter: Name and description (helps agents discover when to use)
  • When to Use: Clear activation criteria (e.g., "creating new Livewire components")
  • Patterns: Detailed examples, best practices, anti-patterns
  • References: Optional subdirectory with extended content

Test

  • On a normal Test application without any third party guidelines this is how it looks.

We still have opportunity to skim down the guidelines more will explore this in the meantime

With Skills (4.3k tokens) Without Skills (7.2 tokens)
Screenshot 2026-01-16 at 1 29 18 AM Screenshot 2026-01-16 at 1 29 56 AM

For third party applications we now show if third party application have the skills or guidelines like the following.

Screenshot 2026-01-16 at 1 34 11 AM

This is how skills are being installed
Screenshot 2026-01-16 at 1 42 20 AM

For eg this Prompt.

Create a simple counter component that increments when you click a button and it should use fluxui

This is how skills are being activated on demand.

Screenshot 2026-01-16 at 1 45 38 AM

pushpak1300 and others added 30 commits January 12, 2026 16:55
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>

# Conflicts:
#	README.md
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
…n Composer

Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
@pushpak1300 pushpak1300 linked an issue Jan 15, 2026 that may be closed by this pull request
@pushpak1300 pushpak1300 marked this pull request as ready for review January 15, 2026 19:37
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Signed-off-by: Pushpak Chhajed <pushpak1300@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Agent Skills Support

2 participants