---

#What is this?

A collection of Cursor IDE configurations optimized for development with Laravel, Filament, Livewire, and Pest. Just extract the .cursor/ folder into the root of your project and your agent will already be trained on modern PHP ecosystem conventions.

---

#📁 Structure

.cursor/
├── rules/          # Passive guides — activated by context or always-on
│   ├── laravel-filament-project.mdc
│   ├── filament-upgrade.mdc
│   ├── pest-test.mdc
│   └── ... (31 rules)
│
├── skills/         # Active capabilities — invoked by the agent when relevant
│   ├── laravel-filament-project/
│   │   └── SKILL.md
│   ├── pest-test/
│   │   └── SKILL.md
│   └── ... (30 skills)
│
├── agents/         # Autonomous specialists — handle long and complex tasks
│   ├── code-reviewer.md
│   ├── laravel-upgrader.md
│   ├── pest-tester.md
│   └── ... (17 agents)
│
└── commands/       # Reusable workflows triggered with /command-name in chat
    ├── git-commit.md
    ├── laravel-migrate.md
    ├── pest-run.md
    └── ... (11 commands)

---

#🧩 Configuration Types

#Rules — .cursor/rules/*.mdc

Passive instructions that Cursor reads automatically. They work like a persistent style guide — no need to invoke anything.

---
description: Filament v5 conventions — forms, tables, resources
alwaysApply: false   # activated by context
---

---

#Skills — .cursor/skills/<n>/SKILL.md

Specialized capabilities with detailed step-by-step instructions. The agent invokes them automatically when the task matches the description, or you can reference them directly in chat.

.cursor/skills/
└── laravel-filament-project/
    └── SKILL.md    ← full content with examples and step-by-step

Required format: must be a subfolder containing SKILL.md — loose .mdc files at the root of skills/ are not recognized by Cursor.

---

#Agents — .cursor/agents/*.md

Autonomous specialists for long and complex tasks. The main agent can delegate to them and run them in parallel.

---
name: laravel-upgrader
description: Expert in Laravel version upgrades
model: inherit
---

⚠️ Agents are a Nightly channel feature. To enable: Cursor Settings → Beta → Update Access → Nightly

Available agents:

---

#Commands — .cursor/commands/*.md

Reusable workflows triggered with /command-name in chat. Plain Markdown files — no frontmatter.

Required format: plain Markdown without --- at the top. Any frontmatter will break the command.

Available commands:

---

#🚀 Getting Started

1. Extract the .cursor/ folder into the root of your project:

# Expected structure after extracting
my-laravel-project/
├── .cursor/
│   ├── rules/
│   ├── skills/
│   ├── agents/
│   └── commands/
├── app/
├── routes/
└── ...

2. Reopen the project in Cursor — rules and skills are loaded automatically.

3. For agents, enable the Nightly channel:

Cursor Settings → Beta → Update Access → Nightly

4. To use a command, type / in chat and select the desired command:

/git-commit
/pest-run
/laravel-make

---

#📦 Available Skills

Laravel

Skill	Description
laravel-filament-project	Full setup: composer scripts, ide-helper, debugbar, phpstan, pint
laravel-multi-auth	Multiple authentication guards with separate tables
laravel-upgrade	Step-by-step Laravel version upgrade guide
laravel-package	Laravel package creation from scratch
laravel-passport	Laravel Passport integration (OAuth2)
laravel-socialite	Social login with Laravel Socialite
laravel-horizon	Laravel Horizon setup for Redis queues
laravel-cashier	Stripe billing integration
laravel-dusk	Browser testing with ChromeDriver
laravel-boost	Laravel Boost for AI-assisted development
laravel-soketi	WebSockets with Soketi
ide-helper	Autocompletion generation with barryvdh/laravel-ide-helper
debugbar	Laravel Debugbar configuration

Filament

Skill	Description
filament-upgrade	Upgrade v3→v4→v5 with breaking changes
filament-plugin	Filament plugin creation with branch strategy
filament-multi-auth	Multiple Filament panels with separate guards

Livewire

Skill	Description
livewire-upgrade	Livewire upgrade v2→v3→v4

Testing & Quality

Skill	Description
pest-test	Pest PHP testing — Laravel, Filament, Livewire
pest-multi-auth	Testing with multiple authentication guards
phpstan	Static analysis with Larastan
pint	Code formatting with Laravel Pint
code-review	Structured code review with checklist
code-health	Code health analysis — SOLID, technical debt

Git & Environment

Skill	Description
git-setup	Git repository initialization
github-repo-setup	GitHub repository configuration via gh CLI
herd-php	PHP commands with Laravel Herd on Windows
pnpm-build	Asset building with pnpm

Other

Skill	Description
bugsnag	Bugsnag integration for any platform
banner-generate	Banner generation for GitHub repositories
tailwind-upgrade	Tailwind v3→v4 upgrade

---

#🔧 References

• Cursor Docs — Rules
• Cursor Docs — Skills
• Cursor Docs — Subagents
• Conventional Commits
• Laravel Docs
• Filament Docs

---