filament-ai-skills

Análise técnica profunda de código PHP/Laravel já implementado (não staged). 3 dimensões: segurança (OWASP), qualidade (SOLID, CC, DRY), padrões (PHP 8.4, Laravel 12, Filament v5). Foco em "como melhorar" — refactor, design, arquitetura. Gera relatório com scores e plano de ação. **Use pre-commit-review pra checklist rápido antes de commit.** Ativa: analisar implementação em profundidade, revisar feature pronta, audit de segurança, refatorar código existente, melhorar arquitetura, review profundo, análise completa, avaliar qualidade de feature, scoring de código.

Agente especializado em detectar, diagnosticar e corrigir erros no sistema. Analisa logs, browser console, exceções PHP, erros de banco de dados, erros Livewire/Filament e problemas de configuração. Ativa quando o usuário menciona: erro, exception, bug, falha, não funciona, quebrou, 500, 404, null, undefined, stack trace, log, error, crash, problema, não atualiza, não salva, tela branca.

Creates Filament v5 Actions — record, bulk, header, page actions — com modais, forms, confirmações e notificações. Activate: create action, action customizada, botão, modal, confirmação, dialog, bulk action, ação em lote, ação de tabela, ExportAction, ImportAction, gerar PDF a partir de botão, enviar email via action, atualizar status, agrupar ações.

Adds Excel and PDF export a tabelas Filament. Cria Exporter classes pra Excel (via ExportAction + openspout) e BulkAction + Controller + Blade pra PDF (via DomPDF). Activate: export, exportação, Excel, planilha, relatório PDF de lista, download de dados, export.

Análise estática automatizada de N+1, eager load faltando, vazamento cross-tenant e colunas sem índice em arquivos Filament (Resources, Tables, Widgets, Pages). Diferente de query-performance-audit (diagnóstico de tela lenta em runtime): esta skill roda ANTES de produção via static analysis. Ativa: auditar filament, query audit filament, verificar N+1 filament, eager load resource, filament:query-audit, auditoria queries filament, checar performance resources, vazamento tenant filament, withoutGlobalScopes.

Checklist obrigatório ANTES de commitar staged changes — 7 camadas: escopo, segurança, null-safe, padrões Laravel/Filament v5, testes, performance N+1, arquitetura. Bloqueia problemas antes de produção. **Para análise profunda de feature pronta use deep-code-review.** Ativa: antes de commitar, pre-commit, pronto pra commit, revisar antes de commit, validar staged, checar PR antes de subir, gate de commit, verificar diff pra commit, analisar PR antes do merge.

Audita SQL × Eloquent × Render/Filament para tela lenta, timeout ou N+1. EXPLAIN, índice ausente, hidratação desnecessária, O(N²) em widgets/tabelas. NÃO para review geral de código. Ativa: query lenta, timeout, N+1, 504, listagem travando, widget pesado, relatório lento, EXPLAIN, índice.

Creates and maintains Infolists Filament v5 para visualização read-only de registros. Activate when: infolist, view page, visualização, página de detalhes, exibir dados, read-only, ver registro, tela de detalhes, entries, TextEntry, IconEntry, RepeatableEntry, layout de visualização.

Verifies and fixes direct static calls on Eloquent models, ensuring they always go through ::query() before methods like find, where, create, all, etc. Activate when: query(), Model::find, Model::create, Model::where, Model::all, eloquent query, static model call, model without query, fix model.

Creates and maintains Filament v5 Resources (Resource, Form Schema, Table, Pages, RelationManager, Widget, Infolist). Activate when: create resource, filament resource, new CRUD, form schema, table, pages, relation manager, widget, panel navigation, register resource, PanelProvider, Filament plugin. Covers Filament v5 (Livewire 4 + Tailwind 4). For version upgrades use filament-upgrade.

Generates complete Pest suite for Filament v5 Resources — Pages (Create/Edit/List/View), Form Schemas, Tables, RelationManagers, Actions. Uses Livewire::test() (required pattern). Activate when: create tests for resource, test suite, generate Filament tests, test form/table/page, resource coverage, test relation manager, validate Filament form.

Apply this skill whenever writing, reviewing, or refactoring Laravel PHP code. This includes creating or modifying controllers, models, migrations, form requests, policies, jobs, scheduled commands, service classes, and Eloquent queries. Triggers for N+1 and query performance issues, caching strategies, authorization and security patterns, validation, error handling, queue and job configuration, route definitions, and architectural decisions. Also use for Laravel code reviews and refactoring existing Laravel code to follow best practices. Covers any task involving Laravel backend PHP code patterns.

Develops reactive Livewire 4 components. Works with Filament v5 + Livewire 4. Activate when creating, updating, or modifying Livewire components; working with wire:model, wire:click, wire:loading, or any wire:* directive; adding real-time updates, loading states, or reactivity; debugging behavior; writing Livewire tests. Activate when: livewire, livewire component, wire:, wire:model, wire:click, reactive, alpine, dispatch event, livewire test.

Verifies and fixes null-safe issues in PHP files before a commit. Activate when the user mentions: null safe, null-safe, ?->, commit, pre-commit, "before committing", "verify null", "fix null", ErrorException, "Attempt to read property", "Call to a member function on null".

Conduz entrevista iterativa em texto livre para transformar problemas, dúvidas ou novos desenvolvimentos em SPEC.md estruturado. Foco em qualidade, segurança e mudanças cirúrgicas (mínimo de arquivos). Ativa quando o usuário menciona: criar spec, novo desenvolvimento, planejar feature, transformar dúvida em spec, escrever requisitos, gerar spec, /spec-creator.

Implements new features following the TDD Red → Green → Refactor cycle with Pest 4, Laravel 12 and Filament v5. Activate when: implement feature, TDD, test-driven, red-green cycle, test first, create feature with tests, new functionality, write test before, "implement X with tests". Includes step-by-step protocol (write test → red → implement → green → pint).