coolify: Skill for Claude Code

Laravel Actions or lorisleiva/laravel-actions

Overview

Use this skill to implement or update actions based on lorisleiva/laravel-actions with consistent structure and predictable testing patterns.

Quick Workflow

1. Confirm the package is installed with composer show lorisleiva/laravel-actions.
2. Create or edit an action class that uses Lorisleiva\Actions\Concerns\AsAction.
3. Implement handle(...) with the core business logic first.
4. Add adapter methods only when needed for the requested entrypoint:
   • asController (+ route/invokable controller usage)
   • asJob (+ dispatch)
   • asListener (+ event listener wiring)
   • asCommand (+ command signature/description)
5. Add or update tests for the chosen entrypoint.
6. When tests need isolation, use action fakes (MyAction::fake()) and assertions (MyAction::assertDispatched()).

Base Action Pattern

Use this minimal skeleton and expand only what is needed.

<?php

namespace App\Actions;

use Lorisleiva\Actions\Concerns\AsAction;

class PublishArticle
{
    use AsAction;

    public function handle(int $articleId): bool
    {
        return true;
    }
}

Project Conventions

• Place action classes in App\Actions unless an existing domain sub-namespace is already used.
• Use descriptive VerbNoun naming (e.g. PublishArticle, SyncVehicleTaxStatus).
• Keep domain/business logic in handle(...); keep transport and framework concerns in adapter methods (asController, asJob, asListener, asCommand).
• Prefer explicit parameter and return types in all action methods.
• Prefer PHPDoc for complex data contracts (e.g. array shapes), not inline comments.

When to Use an Action

• Use an Action when the same use-case needs multiple entrypoints (HTTP, queue, event, CLI) or benefits from first-class orchestration/faking.
• Keep a plain service class when logic is local, single-entrypoint, and unlikely to be reused as an Action.

Entrypoint Patterns

Run as Object