laravel-upgrade

laravel-upgrade is a skill for Claude Code, Codex from majdghithan/agent-skills. It costs 174 tokens per session (1,657 once invoked), scanned A, original, MIT.

A guide for upgrading Laravel, a PHP web framework, between major versions from Laravel 8 through 13.

In plain words
What is it for?
It is for planning and carrying out one-version-at-a-time Laravel upgrades, including PHP checks, tests, and decisions about using Laravel Shift.
Why use it?
Major upgrades can break at runtime even when the code still compiles, and upgrading several versions at once makes failures harder to trace.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit It is for planning and carrying out one-version-at-a-time Laravel upgrades, including PHP checks, tests, and decisions about using Laravel Shift.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/majdghithan/agent-skills/laravel-upgrade
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add majdghithan/agent-skills --skill laravel-upgrade
Clone the repo
git clone --depth 1 https://github.com/majdghithan/agent-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for laravel-upgrade

README.md
[![agentmods](https://agentmods.dev/badge/skills/majdghithan/agent-skills/laravel-upgrade/github.svg)](https://agentmods.dev/skills/majdghithan/agent-skills/laravel-upgrade)
Your own site
<a href="https://agentmods.dev/skills/majdghithan/agent-skills/laravel-upgrade"><img src="https://agentmods.dev/badge/skills/majdghithan/agent-skills/laravel-upgrade/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for laravel-upgrade

Your own site · 80×15
<a href="https://agentmods.dev/skills/majdghithan/agent-skills/laravel-upgrade"><img src="https://agentmods.dev/badge/skills/majdghithan/agent-skills/laravel-upgrade.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 174 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,657 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00174 $0.01657
Opus 5 $0.00087 $0.00829
Sonnet 5 $0.00035 $0.00331
Haiku 4.5 $0.00017 $0.00166

Measured 11d ago against content hash 9ff6e404f72f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

laravel-upgrade scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/laravel-upgrade/SKILL.md · 83 lines

How it starts

The opening of the file, as written. The whole thing — 83 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Laravel: version upgrades (8 -> 13)

Laravel's own upgrade guides at laravel.com/docs/{ver}/upgrade are genuinely good and list every mechanical rename. This skill does NOT repeat them. It carries the two things the docs and Shift do not give you: the runtime bites that pass compilation and break later, and the judgment call of whether to hand-upgrade or pay Shift to do it.

The three rules that prevent a bad upgrade

  1. PHP first, framework second. Every major has a hard PHP floor. Bump and deploy the PHP version on its own, confirm the app runs green on the new PHP under the old Laravel, then upgrade Laravel. Doing both at once means you cannot tell which one broke.
  2. Hop, never leap. Upgrade one major at a time (10 -> 11 -> 12, not 10 -> 12). Each hop's guide assumes you came from the one before it. The exception is Shift, which chains hops for you.
  3. Tests are the upgrade plan. If the suite is thin, the "bites" below are what bites you in production instead. Before a multi-version upgrade, add feature tests on the money/auth/critical paths first. No suite -> upgrade one hop, exercise the app hard, then the next.

PHP floor per version (the gate for every hop)

Laravel Min PHP Released Notes
8 7.3 Sep 2020 starting point
9 8.0 Feb 2022 Symfony 6 + Symfony Mailer, Flysystem 3
10 8.1 Feb 2023 Composer 2.2+, native types
11 8.2 Mar 2024 slim skeleton (opt-in for upgrades)
12 8.2 Feb 2025 maintenance release, Carbon 3
13 8.3 Mar 17 2026 supports PHP 8.3 / 8.4 / 8.5

Support policy (there is no LTS anymore, dropped after Laravel 6): each release gets roughly 18 months of bug fixes and 2 years of security fixes. So an app two majors behind is usually already out of security support. That is the real reason to upgrade, not the new features.

Which hop guide to load

Detect first, then read only what you need:

php artisan --version                 # or:
grep laravel/framework composer.json  # current major
php -v                                # can the target even run here?

Read the full file on GitHub · 83 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 83 lines · 0 tokens per session scan A 9ff6e404f72f

Subscribe to this mod's changes

laravel-upgrade is a skill published in the GitHub repository majdghithan/agent-skills (7 stars, last pushed 1mo ago), licensed MIT. It adds 174 tokens to every session and 1,657 once invoked, about $0.0009 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

create-powergrid-plugin

Create a complete PowerGrid plugin from scratch, including PHP class, Column macro, Blade view, Alpine.js component, and registration.

Power-Components/livewire-powergrid · 31 tokens

build-me

Implement a solution write-up (typically the markdown file produced by /solve-me) in this Laravel project, following existing project patterns and Laravel best practices. Cuts the work into commits itself, writes the commit plan to docs/build/ .md, and gets the developer's approval before writing any code. Then builds…

Kerliula/ship-me · 173 tokens

olakunlevpn-filament-skills

Use when writing, reviewing, or refactoring Filament PHP v5 code -- resources, forms, tables, infolists, actions, widgets, panels, relation managers, multi-tenancy, testing, or plugin development. Always apply these standards to all Filament work.

olakunlevpn/olakunlevpn-filament-skills · 64 tokens

laravel-13-expert

Comprehensive Laravel 13.x expert skill covering the entire framework — installation, configuration, routing, controllers, middleware, Blade views, Eloquent ORM, migrations, queues, jobs, events, mail, notifications, caching, Redis, scheduling, service container, service providers, authentication, authorization, AI…

Deixtra-Private-Limited/claude-laravel-13-skill · 105 tokens

laravel-specialist

Build and configure Laravel 10+ applications, including creating Eloquent models and relationships, implementing Sanctum authentication, configuring Horizon queues, designing RESTful APIs with API resources, and building reactive interfaces with Livewire. Use when creating Laravel models, setting up queue workers…

Jeffallan/claude-skills · 86 tokens

php-pro

Use when building PHP applications with modern PHP 8.3+ features, Laravel, or Symfony frameworks. Invokes strict typing, PHPStan level 9, async patterns with Swoole, and PSR standards. Creates controllers, configures middleware, generates migrations, writes PHPUnit/Pest tests, defines typed DTOs and value objects…

Jeffallan/claude-skills · 107 tokens