Laravel Dev Skill

AI-powered Laravel development toolkit designed to enhance AI assistants across multiple CLI tools. Provides intelligent Preset system, comprehensive documentation, and automation scripts for rapid Laravel development.

🎯 Core Philosophy

This skill is NOT a replacement for Laravel's official tools.

Laravel Dev Skill enhances AI assistants (Claude Code, Cursor, Windsurf, Continue, etc.) by providing:

Intelligent Context: Understands development scenarios and recommends optimal solutions
Smart Presets: Out-of-the-box project configurations for common use cases
Comprehensive Knowledge: Multi-version Laravel documentation (10.x, 11.x, 12.x)
Developer-First: Designed to help developers work faster, not replace their workflow

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│                  AI CLI Tools Layer                      │
│  Claude Code │ Cursor │ Windsurf │ Continue │ Others  │
└─────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────┐
│              Laravel Dev Skill (AI Intelligence)         │
│  ┌─────────────────────────────────────────────────┐   │
│  │  Intent Understanding - Analyze requirements     │   │
│  │  Knowledge Retrieval - Search Laravel docs       │   │
│  │  Code Generation - Generate project code         │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────┐
│                    Data Layer                            │
│  ┌─────────────────────────────────────────────────┐   │
│  │  laravel-dev-presets (Remote Repository)        │   │
│  │  - api/10.json, api/11.json, api/12.json     │   │
│  │  - filament/v4.json, filament/v5.json         │   │
│  │  - framework/10.json, framework/11.json, etc. │   │
│  └─────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────┐   │
│  │  Laravel Documentation (Local Cache)           │   │
│  │  - references/v10/ (Laravel 10.x)              │   │
│  │  - references/v11/ (Laravel 11.x)              │   │
│  │  - references/v12/ (Laravel 12.x)              │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────┐
│                Tool Layer (Official Tools)              │
│  Laravel Installer │ Composer │ Artisan │ npm/pnpm    │
└─────────────────────────────────────────────────────────┘

📦 Available Presets

Presets are fetched from the laravel-dev-presets repository.

API Projects (`api/`)

10.json - Laravel 10.x API project with Sanctum authentication
11.json - Laravel 11.x API project with Sanctum authentication
12.json - Laravel 12.x API project with Sanctum authentication

Filament (`filament/`)

v4.json - Filament v4 admin panel configuration
v5.json - Filament v5 admin panel configuration

Framework (`framework/`)

10.json - Laravel 10.x base framework setup
11.json - Laravel 11.x base framework setup
12.json - Laravel 12.x base framework setup

Laravel Packages (`laravel-package/`)

blade-component.json - Blade component development preset
filament-plugin-skeleton.json - Filament plugin skeleton
meta-package.json - Meta package template
package-skeleton-laravel.json - Laravel package skeleton
package.json - Generic package template

Starter Kits (`starter-kits/`)

livewire.json - Livewire starter kit
react.json - React starter kit
svelte.json - Svelte starter kit
vue.json - Vue starter kit

🚀 Installation

For AI CLI Tools

This skill is designed to work with various AI CLI tools. Install it according to your tool's documentation:

Claude Code:

# Add to Claude Code project
# File: .claude/skills/laravel-dev/

Cursor:

# Add to Cursor's skills directory
# File: .cursor/skills/laravel-dev/

Windsurf:

# Add to Windsurf's skills directory
# File: .windsurf/skills/laravel-dev/

Continue:

# Add to Continue's skills directory
# File: ~/.continue/skills/laravel-dev/

Manual Installation

Clone this repository:

git clone https://github.com/x-multibyte/laravel-dev-skill.git

Copy to your AI tool's skills directory:

cp -r laravel-dev-skill ~/.your-ai-tool/skills/

Verify installation:

bash laravel-dev-skill/scripts/preset_manager.sh --list

✨ Features

Intelligent Preset System

The Preset system provides out-of-the-box Laravel project configurations. AI assistants can intelligently recommend the best preset based on your development scenario.

Preset Features:

✅ Dual Version Control - File name = Laravel version, JSON version = preset version
✅ Smart Recommendation - AI analyzes requirements and suggests optimal presets
✅ Dependency Management - Auto-install required Composer and NPM packages
✅ Environment Configuration - Pre-configured .env files
✅ Lifecycle Hooks - Support for custom scripts at different stages
✅ Template Injection - Support custom code templates
✅ Git Sync - Dynamically update from remote repository

Quick Start with AI Assistant

Ask your AI assistant:

"Create a Laravel 12 API project with Sanctum authentication" → AI recommends api/12.json preset → Generates project with authentication, API resources, rate limiting

"Build a full-stack app with Filament admin panel" → AI recommends filament/v5.json + fullstack preset → Generates project with admin panel, authentication, real-time features

"Create a Laravel package for blade components" → AI recommends laravel-package/blade-component.json → Generates package skeleton with component templates

Preset Management

# List all available presets
bash scripts/preset_manager.sh --list

# View preset summary
bash scripts/preset_manager.sh --summary api 12

# Check dependency compatibility
bash scripts/preset_manager.sh --check api 12

# Validate preset format
bash scripts/preset_manager.sh --validate api 12

# Parse preset configuration
bash scripts/preset_manager.sh --parse api 12

Documentation Access

AI assistants can query Laravel documentation by topic:

# Database documentation
read_file('references/current/database.md')

# Authentication documentation
read_file('references/current/auth.md')

# Routing documentation
read_file('references/current/routing.md')

# Artisan commands
read_file('references/current/artisan.md')

Version Management

# List available Laravel versions
python scripts/version_manager.py --list

# Switch to Laravel 11.x documentation
python scripts/version_manager.py --set-current 11.x

# Compare versions
python scripts/version_manager.py --compare 11.x 12.x

Ecosystem Configuration

Quick configuration for Laravel ecosystem packages:

# Configure all packages (Sail, Reverb, Echo)
bash scripts/setup-ecosystem.sh --all

# Configure Sail only
bash scripts/setup-ecosystem.sh --sail

# Configure Reverb and Echo
bash scripts/setup-ecosystem.sh --reverb --echo

📁 Project Structure

laravel-dev-skill/
├── SKILL.md                          # Skill documentation for AI assistants
├── README.md                         # This file
├── config/
│   ├── packages.json                 # Laravel ecosystem package definitions
│   ├── preset-schema.json             # Preset JSON Schema for validation
│   └── settings.json                   # Skill configuration
├── scripts/
│   ├── preset_manager.sh              # Preset management tool
│   ├── setup-ecosystem.sh            # Ecosystem configuration scripts
│   ├── fetch_laravel_docs.py         # Documentation fetcher
│   └── version_manager.py             # Version management tool
├── templates/
│   ├── INDEX.md                        # Quick navigation index
│   ├── PRESETS.md                      # Preset usage guide
│   ├── artisan-quick-reference.md      # Artisan command reference
│   ├── ecosystem-config-guide.md       # Detailed ecosystem guide
│   ├── config/                         # Configuration templates
│   │   ├── broadcasting.reverb.php
│   │   ├── docker-compose.yml
│   │   ├── echo.bootstrap.js
│   │   └── supervisor-reverb.conf
│   └── presets/                        # Cache directory (empty)
│       └── .gitkeep                    # Presets fetched from remote repo
└── references/
    ├── current/                         # Symlink to current version
    ├── v10/                            # Laravel 10.x documentation
    ├── v11/                            # Laravel 11.x documentation
    └── v12/                            # Laravel 12.x documentation

🎯 Use Cases

1. Rapid API Development

Developer: "I need to build a REST API for a mobile app"

AI Assistant:

Analyzes requirement → Recommends api/12.json
Applies preset with Sanctum authentication
Configures API resources, rate limiting
Sets up testing infrastructure

2. Admin Panel Creation

Developer: "I need an admin panel for content management"

AI Assistant:

Analyzes requirement → Recommends filament/v5.json
Applies preset with Filament v5
Generates CRUD resources, forms, tables
Configures permissions and roles

3. Package Development

Developer: "I want to create a Laravel package"

AI Assistant:

Analyzes requirement → Recommends laravel-package/package.json
Generates package skeleton
Sets up service providers, facades
Configures testing and documentation

4. Full-stack Application

Developer: "I need a complete web application with real-time features"

AI Assistant:

Analyzes requirement → Recommends combination of presets
Applies framework/12.json + realtime-app.json
Configures Reverb for WebSocket
Sets up Laravel Echo client
Generates frontend and backend

🎓 AI Assistant Integration

How AI Assistants Use This Skill

Intent Understanding: Parse developer's natural language requirements
Preset Recommendation: Match requirements to optimal presets
Configuration Application: Apply preset configurations
Code Generation: Generate project code based on preset
Documentation Lookup: Provide relevant Laravel documentation
Best Practices: Suggest improvements and optimizations

Example Interaction

Developer: "Create a Laravel 12 project with Filament admin panel"
    
AI Assistant: "I'll create a Laravel 12 project with Filament v5 admin panel.
            
    Recommended preset: filament/v5.json
    Version: 2.0.0
    Features: Admin panel, authentication, resources, permissions
    
    Steps:
    1. Create Laravel project using official installer
    2. Apply filament/v5.json preset
    3. Install dependencies (Filament v5, Spatie Permission)
    4. Generate admin resources
    5. Configure authentication and permissions
    
    Shall I proceed?"

🔗 Related Projects

laravel-dev-presets - Preset repository with 6 preset categories
laravel-dev-cli - Composer CLI tool (coming soon)

🌟 Roadmap

Completed ✅

Preset JSON Schema with validation
Remote Presets repository
6 Preset categories (API, Filament, Framework, Laravel Package, Starter Kits)
Multi-version documentation (10.x, 11.x, 12.x)
Ecosystem configuration guides
AI assistant integration patterns

In Progress 🚧

Preset sync script (sync_presets.sh)
Enhanced preset_manager.sh with remote fetching
Environment compatibility checker

Planned 📋

More preset categories (e-commerce, CMS, microservices)
Community preset contribution system
Preset validation and testing automation
AI-powered preset recommendation engine

💡 Value Proposition

For Developers

Faster Development - Start with pre-configured projects
Fewer Errors - Validated configurations from experts
Consistency - Standardized project structures
Flexibility - Create and share custom presets
Learning - Understand best practices through examples

For AI Assistants

Intelligent Context - Understand development scenarios deeply
Smart Recommendations - Suggest optimal solutions automatically
Simplified Interaction - Natural language → working project
Programmability - Structured data for easy processing
Dynamic Updates - Always access latest presets from remote

🤝 Contributing

Contributions are welcome! Please:

For Presets: Fork laravel-dev-presets and add your preset
For Documentation: Improve this skill's documentation
For Scripts: Enhance automation scripts

Adding a New Preset

Fork laravel-dev-presets
Choose the appropriate category folder
Create a new JSON file following the schema
Validate against preset-schema.json
Submit a pull request

📄 License

MIT License - see LICENSE file for details

📞 Support

For issues, questions, or suggestions:

Open an issue on GitHub
Check laravel-dev-presets for preset-related issues
Consult the documentation in templates/ directory

Important: This skill enhances AI assistants' capabilities for Laravel development. It does NOT replace Laravel's official tools or documentation. Always refer to laravel.com for official documentation and github.com/laravel/laravel for the framework source code.

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
config		config
references		references
scripts		scripts
templates		templates
.gitignore		.gitignore
README.md		README.md
SKILL.md		SKILL.md

Folders and files

Latest commit

History

Repository files navigation

Laravel Dev Skill

🎯 Core Philosophy

🏗️ Architecture

📦 Available Presets

API Projects (api/)

Filament (filament/)

Framework (framework/)

Laravel Packages (laravel-package/)

Starter Kits (starter-kits/)

🚀 Installation

For AI CLI Tools

Manual Installation

✨ Features

Intelligent Preset System

Quick Start with AI Assistant

Preset Management

Documentation Access

Version Management

Ecosystem Configuration

📁 Project Structure

🎯 Use Cases

1. Rapid API Development

2. Admin Panel Creation

3. Package Development

4. Full-stack Application

🎓 AI Assistant Integration

How AI Assistants Use This Skill

Example Interaction

🔗 Related Projects

🌟 Roadmap

Completed ✅

In Progress 🚧

Planned 📋

💡 Value Proposition

For Developers

For AI Assistants

🤝 Contributing

Adding a New Preset

📄 License

📞 Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

API Projects (`api/`)

Filament (`filament/`)

Framework (`framework/`)

Laravel Packages (`laravel-package/`)

Starter Kits (`starter-kits/`)

Packages