القائمة
Always prefer Laravel's built-in helper classes over native PHP functions. Use `Arr::`, `Str::`, and Collection methods instead of native PHP equivalents.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Readonly data containers with typed factory methods (`fromArray`, `fromModel`, `fromCollection`, `fromRequest`) used to pass structured data between application layers — especially for external API responses, Eloquent models, and service boundaries. Use this skill whenever creating, reviewing, or refactoring DTOs, Data Transfer Objects, value objects for inter-layer communication, or mapping payloads from APIs, models, or collections into typed PHP objects. Also trigger when the user mentions spatie/laravel-data alternatives, data mapping, or payload normalization in a Laravel context.
Eloquent model conventions for mass assignment, casts, relationship naming, activity logging, and mandatory model tests (CRUD + relations).
Single-purpose business logic classes that encapsulate one well-defined business operation. Actions are the primary location for business logic in Laravel applications, invoked from controllers, commands, or jobs.
Albatros accounting API integration via Saloon. Use when working with app/Services/Albatros/, AlbatrosConnector, or Albatros DTOs.
Laravel Blade template conventions covering components, output escaping, security, structure, and formatting.
Artisan console command classes that serve as the CLI entry point for operations. Commands validate input and delegate all business logic to Actions or Services.
| name | helperfunctions |
| description | Always prefer Laravel's built-in helper classes over native PHP functions. Use `Arr::`, `Str::`, and Collection methods instead of native PHP equivalents. |
| compatible_agents | ["architect","implement","refactor","review"] |
Illuminate\Support\Arr for array helpers.Illuminate\Support\Str for string helpers.collect() only when collection operations improve clarity.array_*, str_*, manual loops).Arr::, Str::, or Collection methods where a direct equivalent exists.Str::of(), collections) for multi-step transformations.use Illuminate\Support\Arr;
use Illuminate\Support\Str;
// Arrays
$city = Arr::get($payload, 'user.address.city', 'Unknown');
$safe = Arr::except($payload, ['password', 'token']);
// Strings
$slug = Str::of($title)->trim()->lower()->slug();
// Collections
$adminEmails = collect($users)
->filter(fn (User $user) => $user->isAdmin())
->pluck('email')
->values();
array_*/str_* calls with Laravel helpers in the same transformation flow.use imports and relying on fully qualified class names repeatedly.