Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Laravel Architecture · hoangnguyen0403 | DecimalAI

hoangnguyen0403/laravel-architecture

SkillScore91Maintained

Enforce core architectural standards for scalable Laravel applications. Use when structuring controllers, service layers, action classes, Form Requests, or Service Container bindings in Laravel projects.

codingby hoangnguyen0403

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Coding pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/hoangnguyen0403-laravel-architecture/SKILL.md

decimalai skills pull hoangnguyen0403-laravel-architecture --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/hoangnguyen0403-laravel-architecture/SKILL.md https://app.decimal.ai/s/hoangnguyen0403-laravel-architecture/SKILL.md

Raw file: /s/hoangnguyen0403-laravel-architecture/SKILL.md ↗ · machine-readable summary at /s/hoangnguyen0403-laravel-architecture.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

Runs

all versions · 30d

Eval pass

95%

global

Used when offered

64%

used / offered · all versions

By model· real traffic, every org · 30d — not the benchmark

Model	Eval pass	Runs
gemini-3.6-flash	95%	21

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 9d ago

Yes — +50% lift-18% tokens0% turns86% of whole cases pass with skill (19/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	-12%	0%
case-02	✗→✓	▲ Improved	-16%	0%
case-05	✗→✓	▲ Improved	-14%	0%
case-06	✗→✓	▲ Improved	-9%	0%
case-08	✗→✓	▲ Improved	-34%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 8/22/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

HoangNguyen0403 / agent-skills-standard

skills/laravel/laravel-architecture/SKILL.md

View on GitHub ↗

License Apache-2.0Imported 8/22/2026Version v1Bundled 1 file

Skill contents

references/

SKILL.md

Laravel Architecture

Priority: P0 (CRITICAL)

Structure

See project structure for recommended directory layout.

Workflow

Create Form Request for validation (php artisan make:request StoreUserRequest).
Create Action class with single handle() method for use case.
Inject Action into controller via constructor DI.
Bind interfaces in AppServiceProvider for swappable implementations.

Controller Pattern

See implementation examples for slim controller, action class, and service container binding patterns.

Validation

Use Form Requests with authorize() and rules() methods.
Call $request->validated() in controller for mass assignment.
Never use inline $request->validate().

Anti-Patterns

No logic in Controllers: Move to Services or Action classes.
No manual instantiation: Use Service Container via DI.
No inline $request->validate(): Favor Form Request classes.
No excessive global helpers: Use class-based logic instead.

References

Slim Controller Patterns

Canonical response anchors

When this skill applies, preserve the following domain terminology or equivalent concrete examples in the answer when relevant:

No logic in

Additional task-grounded exact anchors: handle()

Illustrative Want to see what hoangnguyen0403/laravel-architecture would put in front of your model? Preview the rendered body and check its trigger phrases — no LLM call, no signup.

Latest benchmark · publisher runVerified

9/19/2026, 00:56 UTC · 22 cases

Lift

+50%

86% vs 36%

Agent turns

1.0 vs 1.0

Tokens

-18%

1,970.55 vs 2,397.86

fail → pass · 11pass → pass · 8fail → fail · 3

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I'm building a user registration feature in my Laravel 11 application. Could you show me how to structure the code for handling this feature cleanly? Please provide the request validation class, the core business logic class, and the controller method, following standard Laravel architectural practices.	fail→pass	21,276	17,031	-20%	1	1	0%	2,813	2,462	-12%	0	0	—
case-12 I need to support multiple notification providers (Twitch, Discord) in Laravel. How should I register the binding in `AppServiceProvider` and inject the contract into my notification action class?	pass→pass	21,662	14,784	-32%	1	1	0%	3,026	1,960	-35%	0	0	—
case-02 My current Laravel controller method for processing subscription payments is getting way too bloated with inline validation, database transactions, and notification logic all in one place. How should I refactor this into separate classes so the controller stays thin and testable? Please give me the refactored code structure.	fail→pass	21,491	10,365	-52%	1	1	0%	2,891	2,431	-16%	0	0	—
case-03 I need to implement an endpoint for creating new blog posts in Laravel. What is the recommended workflow and file organization for handling the incoming request data, processing the post creation logic, and wiring everything up in the controller?	fail→fail	22,410	15,338	-32%	1	1	0%	3,292	2,077	-37%	0	0	—
case-04 I am implementing an update user profile endpoint in Laravel. To keep the code short, I plan to run `$request->validate(['name' => 'required'])` right inside the controller method before calling my service class. Please provide the refactored controller and validation class code.	pass→pass	16,840	14,082	-16%	1	1	0%	1,827	1,923	+5%	0	0	—
case-05 I am writing a dedicated action class `CreateOrderAction` for processing ecommerce orders in Laravel. My team usually names the main method `execute()`. Show me the complete `CreateOrderAction` class and how to invoke it from an `OrderController`.	fail→pass	20,115	15,652	-22%	1	1	0%	2,677	2,311	-14%	0	0	—
case-06 In my Laravel API controller for resetting passwords, I instantiate the action class directly inside the controller method using `$action = new ResetPasswordAction(); $action->execute($request->all());`. Show me how this controller and action should be properly structured.	fail→pass	18,818	15,244	-19%	1	1	0%	2,397	2,175	-9%	0	0	—
case-07 I have a `PaymentGatewayInterface` and a `StripePaymentGateway` implementation in my Laravel application. Show me where and how to bind this interface in the application service provider, and how to inject it into a payment action class.	pass→pass	16,616	48,845	+194%	1	1	0%	1,876	1,622	-14%	0	0	—
case-08 Outline a multi-step workflow for implementing a 'TransferFunds' feature in Laravel, from validation to interface binding. Provide the concrete file structure and code following standard application architectural guidelines.	fail→pass	24,689	15,566	-37%	1	1	0%	3,956	2,603	-34%	0	0	—
case-09 Here is my current Laravel controller method: ```php public function store(Request $request) { $validated = $request->validate(['email' => 'required\|email', 'amount' => 'required\|numeric']); $user = User::where('email', $validated['email'])->first(); $user->balance += $validated['amount']; $user->save(); Mail::to($user)->send(new BalanceUpdated($user)); return response()->json(['status' => 'success']); } ``` Show me the refactored slim controller and action class.	fail→pass	12,665	14,238	+12%	1	1	0%	2,177	2,078	-5%	0	0	—
case-10 When saving data from an incoming request in a Laravel controller, is it better to pass `$request->all()`, `$request->input()`, or `$request->validated()` to the action class? Show a concrete code snippet of the controller calling the action.	fail→pass	18,043	14,528	-19%	1	1	0%	2,354	1,853	-21%	0	0	—
case-11 In my Laravel action class for generating invoices, I am using global helpers like `request()`, `auth()`, and `session()` throughout the class methods. Show me how to refactor this action class to eliminate global helper dependencies.	fail→pass	15,331	16,414	+7%	1	1	0%	2,631	2,077	-21%	0	0	—
case-13 Create a Form Request class named `StoreArticleRequest` for a published article submission endpoint in Laravel. Show what methods must be implemented.	pass→pass	18,011	13,128	-27%	1	1	0%	2,513	1,727	-31%	0	0	—
case-14 I am writing an invokable Laravel controller `ProcessRefundController`. I plan to inject `ProcessRefundAction $action` directly into the `__invoke(Request $request, ProcessRefundAction $action)` method. Is this recommended or should constructor injection be used? Provide the complete code.	fail→pass	19,519	14,134	-28%	1	1	0%	2,324	1,928	-17%	0	0	—
case-15 A junior developer submitted a PR in our Laravel codebase with business logic inside controller methods, inline `$request->validate()` calls, and manual `new Service()` instantiations. List the exact anti-patterns violated and provide corrected code examples.	fail→fail	17,943	14,849	-17%	1	1	0%	3,255	2,040	-37%	0	0	—
case-16 What is the primary rule regarding controller responsibilities when organizing business domain code in a Laravel project? Explain the rule and demonstrate it with a user registration example.	fail→pass	18,908	7,872	-58%	1	1	0%	2,593	1,785	-31%	0	0	—
case-17 What method name should be defined on Action classes when creating single-purpose business logic handlers in a Laravel application? Provide a complete code example for `CancelSubscriptionAction`.	fail→fail	17,154	12,977	-24%	1	1	0%	2,082	1,531	-26%	0	0	—
case-18 Show the artisan CLI command used to create a new validation Form Request for updating product stock in Laravel, and show how the generated class is injected into the controller method signature.	pass→pass	8,050	8,933	+11%	1	1	0%	1,289	1,821	+41%	0	0	—
case-19 I have a `UserController` in Laravel that handles showing, updating, and deleting users. I need to use `UpdateUserAction` and `DeleteUserAction`. How should these actions be injected and called inside the controller?	fail→pass	13,594	14,719	+8%	1	1	0%	2,383	2,107	-12%	0	0	—
case-20 I have an Eloquent query in Laravel fetching 100 posts along with their authors and comments: `$posts = Post::all();`. This is causing an N+1 query problem. How should I refactor this query to optimize database performance?	pass→pass	10,358	14,002	+35%	1	1	0%	1,763	1,705	-3%	0	0	—
case-21 I need to write a Laravel database migration to create a `discounts` table with columns for code (string, unique), value (decimal 8, 2), status (enum 'active', 'expired'), and soft deletes. Provide the migration code using `Schema::create`.	pass→pass	6,526	11,332	+74%	1	1	0%	1,078	1,433	+33%	0	0	—
case-22 I want to create an anonymous Blade component in Laravel for an alert banner that accepts a `type` prop (info, warning, danger) and displays a slot for the message content. How do I construct this Blade view file?	pass→pass	10,332	13,395	+30%	1	1	0%	1,556	1,703	+9%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +50 percentage points is the difference between those two pass rates over the 22 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 36.4%
Pass rate with the skill: 86.4%
Cases attempted: 22
Cases counted toward lift: 22
Cases that regressed: 0
Skill version measured: v1
Run completed: 9/19/2026, 00:56 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-01

Prompt

I'm building a user registration feature in my Laravel 11 application. Could you show me how to structure the code for handling this feature cleanly? Please provide the request validation class, the core business logic class, and the controller method, following standard Laravel architectural practices.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals2 of 4 complete

BenchmarkPass rate WITH skill on a verified run86

Live evalPass rate on real evaluated traces95%

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns-7% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 2 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 9 days ago

Other measured skills in the registry, with their headline benchmark lift.