PHPackages                             fperdomo/laravel-agent-skill - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. fperdomo/laravel-agent-skill

ActiveLibrary[Utility & Helpers](/categories/utility)

fperdomo/laravel-agent-skill
============================

Laravel Best Practices skill for Claude Code and Codex — enforces SRP, FormRequests, service classes, Eloquent, Inertia (React + Vue) conventions.

v1.0.8(1mo ago)1284↓50%MITPHPPHP >=8.1

Since Jan 18Pushed 1mo agoCompare

[ Source](https://github.com/masterfermin02/laravel-agent-skill)[ Packagist](https://packagist.org/packages/fperdomo/laravel-agent-skill)[ RSS](/packages/fperdomo-laravel-agent-skill/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (6)Versions (9)Used By (0)

Laravel Best Practices Skill Installer
======================================

[](#laravel-best-practices-skill-installer)

This package publishes an AI agent skill covering Laravel best practices — including Inertia + React conventions — into multiple locations to support various AI agents and editors.

Install
-------

[](#install)

### Via Laravel Boost (recommended)

[](#via-laravel-boost-recommended)

Install individual skills directly — no Composer package required:

```
# Laravel best practices skill
php artisan boost:add-skill masterfermin02/laravel-agent-skill --skill laravel-best-practices

# PHP upgrade with Rector skill
php artisan boost:add-skill masterfermin02/laravel-agent-skill --skill php-update-with-rector

# Laravel upgrade with Rector skill
php artisan boost:add-skill masterfermin02/laravel-agent-skill --skill laravel-update-with-rector
```

### Via npx skills

[](#via-npx-skills)

```
# Laravel best practices skill
npx skills add https://github.com/masterfermin02/laravel-agent-skill --skill laravel-best-practices

# PHP upgrade with Rector skill
npx skills add https://github.com/masterfermin02/laravel-agent-skill --skill php-update-with-rector

# Laravel upgrade with Rector skill
npx skills add https://github.com/masterfermin02/laravel-agent-skill --skill laravel-update-with-rector
```

### Via Claude Code plugin

[](#via-claude-code-plugin)

```
/plugin install https://github.com/masterfermin02/laravel-agent-skill
```

### Via Composer

[](#via-composer)

```
composer require fperdomo/laravel-agent-skill --dev
```

Usage
-----

[](#usage)

### Quick install — everything

[](#quick-install--everything)

```
php artisan lbpa:install

# Overwrite existing files
php artisan lbpa:install --force
```

### Laravel Boost — install all at once

[](#laravel-boost--install-all-at-once)

```
php artisan boost:install
```

To keep skills up-to-date when dependencies are updated, add this to your project's `composer.json`:

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

To publish manually to the Boost location (`.ai/skills/`):

```
php artisan vendor:publish --tag=lbpa-boost
# Publishes to: .ai/skills/laravel-best-practices/ and .ai/skills/inertia-development/
```

### Publish to Codex skill locations

[](#publish-to-codex-skill-locations)

**Project workspace (primary):**

```
php artisan vendor:publish --tag=lbpa-skill
# Publishes to: .codex/skills/laravel-best-practices/
```

**User home directory (global, shared across all projects):**

```
php artisan vendor:publish --tag=lbpa-skill-home
# Publishes to: ~/.codex/skills/laravel-best-practices/
```

**VS Code:**

```
php artisan vendor:publish --tag=lbpa-skill-vscode
# Publishes to: .vscode/codex/skills/laravel-best-practices/
```

**JetBrains IDEs (PhpStorm, IntelliJ, etc.):**

```
php artisan vendor:publish --tag=lbpa-skill-jetbrains
# Publishes to: .idea/codex/skills/laravel-best-practices/
```

**All Codex locations at once:**

```
php artisan vendor:publish --tag=lbpa-skill-all
```

### Publish AI agent adapters

[](#publish-ai-agent-adapters)

```
php artisan vendor:publish --tag=lbpa-claude    # → CLAUDE.md
php artisan vendor:publish --tag=lbpa-copilot   # → .github/copilot-instructions.md
php artisan vendor:publish --tag=lbpa-agents    # → AGENTS.md
```

**Everything (all adapters + all skill locations):**

```
php artisan vendor:publish --tag=lbpa-all
```

---

PHP Upgrade with Rector Skill
-----------------------------

[](#php-upgrade-with-rector-skill)

Upgrades a PHP project to a newer PHP version using Rector.

### Install

[](#install-1)

**Project workspace:**

```
php artisan vendor:publish --tag=rector-php
# Publishes to: .codex/skills/php-update-with-rector/
```

**User home directory (global):**

```
php artisan vendor:publish --tag=rector-php-home
# Publishes to: ~/.codex/skills/php-update-with-rector/
```

**VS Code:**

```
php artisan vendor:publish --tag=rector-php-vscode
# Publishes to: .vscode/codex/skills/php-update-with-rector/
```

**JetBrains IDEs:**

```
php artisan vendor:publish --tag=rector-php-jetbrains
# Publishes to: .idea/codex/skills/php-update-with-rector/
```

### Install via npx skills

[](#install-via-npx-skills)

```
npx skills add https://github.com/masterfermin02/laravel-agent-skill --skill php-update-with-rector
```

### Install via Laravel Boost

[](#install-via-laravel-boost)

```
php artisan boost:add-skill masterfermin02/laravel-agent-skill --skill php-update-with-rector
```

---

Laravel Upgrade with Rector Skill
---------------------------------

[](#laravel-upgrade-with-rector-skill)

Upgrades a Laravel application or package to a newer Laravel version (up to Laravel 13) using Rector and `driftingly/rector-laravel`.

### Install

[](#install-2)

**Project workspace:**

```
php artisan vendor:publish --tag=rector-laravel
# Publishes to: .codex/skills/laravel-update-with-rector/
```

**User home directory (global):**

```
php artisan vendor:publish --tag=rector-laravel-home
# Publishes to: ~/.codex/skills/laravel-update-with-rector/
```

**VS Code:**

```
php artisan vendor:publish --tag=rector-laravel-vscode
# Publishes to: .vscode/codex/skills/laravel-update-with-rector/
```

**JetBrains IDEs:**

```
php artisan vendor:publish --tag=rector-laravel-jetbrains
# Publishes to: .idea/codex/skills/laravel-update-with-rector/
```

### Install via npx skills

[](#install-via-npx-skills-1)

```
npx skills add https://github.com/masterfermin02/laravel-agent-skill --skill laravel-update-with-rector
```

### Install via Laravel Boost

[](#install-via-laravel-boost-1)

```
php artisan boost:add-skill masterfermin02/laravel-agent-skill --skill laravel-update-with-rector
```

---

What's included
---------------

[](#whats-included)

### Backend rules

[](#backend-rules)

IDRuleSeveritySRP-001Single Responsibility PrinciplehighFUNC-001Methods should do one thingmediumMVC-001Skinny controllers; move logic outhighVAL-001Validation in FormRequest classes**critical**SVC-001Business logic in service/action classeshighAUTH-001Use Policies for authorizationhighCONF-001Never call `env()` outside config fileshighDRY-001Don't repeat yourselfmediumELO-001Prefer Eloquent + Collections (`sole()`, `firstOrCreate()`, casts)lowBLADE-001No queries in Blade; eager load to avoid N+1**critical**PERF-001Chunk/stream large dataset operationsmediumNAMING-001Follow Laravel naming conventionsmedium### Inertia + React rules

[](#inertia--react-rules)

IDRuleINRT-001Directory conventions (`common`, `modules`, `pages`, `shadcn`)INRT-002Page components: `Page` suffix, default exportINRT-003One component per file, PascalCase, function declarationsINRT-004Wrap shadcn components; avoid direct app-wide importsINRT-005No barrel files; absolute aliased importsINRT-006Type page props with TypeScript interfacesINRT-007Use `useForm` for submissions; avoid raw axios/fetchINRT-008Use `usePage` for shared data; avoid prop drillingINRT-009Use `` for internal navigation; avoid plain ``INRT-010Use partial reloads (`router.reload`) instead of full visits### Inertia + Vue rules

[](#inertia--vue-rules)

IDRuleINRT-VUE-001Directory conventionsINRT-VUE-002Page components: `Page` suffix, default exportINRT-VUE-003One component per `.vue` file, ``INRT-VUE-004Wrap third-party UI library componentsINRT-VUE-005No barrel files; absolute aliased importsPublished structure
-------------------

[](#published-structure)

```
.ai/skills/laravel-best-practices/         # Laravel Boost — general skill
  SKILL.md
.ai/skills/inertia-development/            # Laravel Boost — Inertia React + Vue skill
  SKILL.md

.codex/skills/laravel-best-practices/      # Codex / project workspace
  SKILL.md
  references/
    rulebook.json
    laravel-best-practices-summary.md
    inertia-react.md
    inertia-react-summary.md
    inertia-vue.md
  scripts/
    detect-laravel-context.php
    review-diff.sh

CLAUDE.md                                  # Claude Code adapter
.github/copilot-instructions.md            # GitHub Copilot adapter
AGENTS.md                                  # Generic agent adapter

```

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance88

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Total

8

Last Release

59d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/17c416be607cbb47c55e76e115e3c35c3d74906ff422e808e4bba3be1dfb5cd6?d=identicon)[masterfermin02](/maintainers/masterfermin02)

---

Top Contributors

[![masterfermin02](https://avatars.githubusercontent.com/u/4625540?v=4)](https://github.com/masterfermin02 "masterfermin02 (19 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/fperdomo-laravel-agent-skill/health.svg)

```
[![Health](https://phpackages.com/badges/fperdomo-laravel-agent-skill/health.svg)](https://phpackages.com/packages/fperdomo-laravel-agent-skill)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[orchestra/canvas

Code Generators for Laravel Applications and Packages

20917.2M158](/packages/orchestra-canvas)[illuminate/pipeline

The Illuminate Pipeline package.

9346.6M213](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10532.5M862](/packages/illuminate-pagination)[spatie/laravel-pjax

A pjax middleware for Laravel 5

513371.8k11](/packages/spatie-laravel-pjax)[spatie/laravel-mix-preload

Add preload and prefetch links based your Mix manifest

169176.0k2](/packages/spatie-laravel-mix-preload)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)