laravel-dev
Installation
SKILL.md
Laravel 13 Development
Guidance for building and maintaining Laravel 13.x applications (released March 2026, PHP 8.3 minimum). The goal is correct, idiomatic, convention-following code — verified against the real API and the project's own conventions, never invented.
Core operating principle: verify, don't guess
Laravel has a large, fast-moving surface area. The single biggest failure mode is confidently writing a method signature, attribute, config key, or helper that doesn't exist or changed between versions. To avoid that:
- Read the project first. Before writing a model/controller/test, open 1–2 existing siblings in the same directory and match their style (naming, return types, traits, test framework, formatting). The repo's own conventions outrank any default in this skill.
- Confirm the framework version. Check
composer.json(laravel/framework) andphp -v. Don't assume 13.x — a repo may still be on 11.x or 12.x, which changes available APIs. If unsure, runphp artisan about. - Ground unfamiliar APIs in the bundled complete API reference. This skill ships the entire Laravel 13 API so you never have to guess a class, method, attribute, or signature:
- Complete API index (every namespace + every class, with the URL pattern to resolve any of them):
references/api/index.md. Read it to find the right class/namespace, then get the exact signature from one of the next two sources. - Authoritative source in this repo (best — version-exact): read
vendor/laravel/framework/src/<FQCN with / for \>.phpwith Read/Grep. The installed source always wins over any doc. - Generated per-class signatures for the installed version: if
references/api/generated/exists, read the namespace file there (e.g.Database_Eloquent.md). To create/refresh it, run the generator (see "Complete API" below). - Online API reference (version-pinned):
https://api.laravel.com/docs/13.x/<FQCN with / for \>.html, e.g.…/Illuminate/Database/Eloquent/Model.html. Prose guides:https://laravel.com/docs/13.x. If the Context7 MCP server is available it's a fast way to pull current docs.
- Complete API index (every namespace + every class, with the URL pattern to resolve any of them):
- Prefer existing tools over new code. Before building a helper, check whether Laravel, a first-party package (Sanctum, Horizon, Pennant, Reverb, Scout, Telescope), or an installed composer package already solves it.
If a fact can't be verified, say so explicitly rather than presenting a guess as fact.