laravel-skills-localsetup
Provides deterministic workflows for scaffolding, configuring, and verifying a Laravel 13 application, including starter kits, authentication, database setup, and health checks.
Configures Laravel starter kits with Livewire single-file components and team management.
Provisions and verifies MySQL databases for the Laravel application, including migrations and connection checks.
Provisions and verifies PostgreSQL databases for the Laravel application, including migrations and connection checks.
Provisions and verifies SQLite databases for the Laravel application, including migrations and connection checks.
Sets up Laravel front-end scaffolding with Tailwind CSS styling out of the box.
name: "laravel-skills-localsetup" title: "Laravel 13 Local Development Setup & Verification" description: "Professional, deterministic AI agent skill and Cursor rule for setting up, configuring, and verifying a local Laravel 13 development environment" version: "1.0.0" author: "Saddam Al-Slfi" repository: "https://github.com/saddamalsalfi/laravel-skills-localsetup" license: "MIT" created_at: "2026-09-12"
Laravel 13 Local Development Setup & Verification πβ‘
A battle-tested, production-grade AI agent skill and Cursor Rule engineered to guide AI coding assistants (Cursor, Google Antigravity / Gemini, Claude Code, GitHub Copilot, LangChain agents) through configuring, provisioning, and verifying modern Laravel 13 local development environments with deterministic accuracy and zero hallucinations.
Optimized for submission to cursor.directory, LangChain Hub, and Open Plugins.
Related MCP server: project-scaffold
π― What This Skill Solves
Standard AI models frequently fail when provisioning local Laravel projects: they hallucinate outdated artisan commands, ignore host vs. container environments, corrupt database configs, and miss vital 2FA or Livewire requirements.
This skill forces the AI agent to follow a strict, deterministic, step-by-step engineering protocol:
Runtime Pre-flight & Discovery: Probes the operating system (Host, WSL2, Docker, remote container) before executing commands; asks for explicit confirmation before installing tools.
Modern Laravel 13 Stack: Scaffolds starter kits with Livewire Single-File Components (SFC), Team management, and Tailwind CSS.
Complete Auth & Security: Integrates registration, email verification, two-factor authentication (2FA), passkeys, and test user seeders.
AI Coding Integration: Out-of-the-box setup for Laravel Boost, coding agent guidelines, and MCP server configuration.
Deterministic Health Checks: Verifies dev servers (
artisan serve,npm run dev), database connections, and resolves port collisions safely.
π Repository Structure (Open Plugins Standard)
This repository follows the Open Plugins Standard for plug-and-play installation across agent platforms:
βββ skills/
β βββ laravel-skills-localsetup/
β βββ SKILL.md # Agent workflow for Antigravity, Claude Code, etc.
βββ rules/
β βββ laravel-skills-localsetup.mdc # Optimized rule for Cursor IDE
βββ server.py # Universal FastMCP executable server
βββ requirements.txt # Pinned dependencies for MCP runtime
βββ Dockerfile # Multi-platform OCI rootless container
βββ mcp.json # Model Context Protocol configuration
βββ plugin.json # Open Plugins manifest
βββ LICENSE # MIT License with explicit AI Agent Grant
βββ README.md # Documentation and usage guidesπ Quick Start & Installation
1. Cursor IDE (via cursor.directory or local)
Copy the .mdc rule into your project's .cursor/rules/ directory:
mkdir -p .cursor/rules
curl -o .cursor/rules/laravel-skills-localsetup.mdc https://raw.githubusercontent.com/saddamalsalfi/laravel-skills-localsetup/main/rules/laravel-skills-localsetup.mdc2. Google Antigravity / Gemini IDE
Add the skill into your project's .agents/skills/ directory:
mkdir -p .agents/skills/laravel-skills-localsetup
curl -o .agents/skills/laravel-skills-localsetup/SKILL.md https://raw.githubusercontent.com/saddamalsalfi/laravel-skills-localsetup/main/skills/laravel-skills-localsetup/SKILL.md3. Open Plugins CLI / Package Manager
Install directly using the repository URL:
open-plugins install https://github.com/saddamalsalfi/laravel-skills-localsetup4. Claude Code / LangChain Hub / Custom Agents
Load skills/laravel-skills-localsetup/SKILL.md directly into your agent's system prompt or project knowledge base.
5. Universal Executable MCP Server (Claude Desktop, Cursor, Smithery)
This skill runs natively as an executable Model Context Protocol (MCP) server exposing resources (skill://content) and tools (get_guidelines):
Claude Desktop Configuration (claude_desktop_config.json):
{
"mcpServers": {
"laravel-skills-localsetup": {
"command": "python",
"args": ["/path/to/laravel-skills-localsetup/server.py"]
}
}
}Docker Container Run:
docker build -t laravel-skills-localsetup .
docker run -i --rm laravel-skills-localsetupπ Execution Phases Overview
When activated, the agent executes the following stages in order:
Phase | Description | Key Deliverables |
1. Runtime Discovery | Inspects host OS, WSL distribution, PHP 8.2+, Composer, Node.js, and DB engines | Pre-flight compatibility matrix |
2. Scaffolding | Creates starter-kit Laravel 13 app with single-file components | Clean app skeleton & git init |
3. Database & Cache | Provisions MySQL / PostgreSQL / SQLite, configures | Verified database connection |
4. Auth & Security | Configures Fortify / starter auth with 2FA, passkeys, and seeded accounts | Working authentication suite |
5. AI Tooling | Sets up guidelines, MCP configuration, and agent instructions | Optimized developer workflow |
6. Verification | Boots dev servers, tests endpoints, performs end-to-end smoke check | Verified working URLs & ports |
π‘οΈ Guiding Principles
Safety First: Never overwrite existing files, databases, or environment variables without explicit user authorization.
Deterministic Outputs: Every command flag is verified against official Laravel 13 release specifications.
Reproducibility: Generates reproducible scripts and idempotent configurations suitable for solo devs and teams.
π License & Attribution
Authored by Saddam Al-Slfi (@saddamalsalfi).
This repository is licensed under the MIT License with a Special Grant for Artificial Intelligence (AI) Agents & Automated Systems, permitting free ingestion, adaptation, and execution by all AI agents and developers.
Available Tools
1 toolget_guidelinesA
Returns procedural guidelines and domain rules for Laravel 13 local development setup. Args: section: Optional keyword to filter content sections.
Inputs: section. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusing it with others. The tool's purpose is clearly distinct by default.
With a single tool, there is no mixed convention to evaluate. The name 'get_guidelines' follows a clean verb_noun pattern.
The server has only one tool, which feels thin for a domain that could warrant separate operations (e.g., listing sections, validating setup steps). However, for a simple guidelines retrieval server, one tool is borderline acceptable.
The single tool covers the primary need of retrieving procedural guidelines, but there are minor gaps such as an explicit way to enumerate available sections or get more granular support. Agents can likely work around these gaps.
Maintenance
Related MCP Connectors
A MCP server built for developers enabling Git based project management with project and personalβ¦
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
An MCP server that provides Javelin Standalone Guardrails
MCP Server for JFrog, providing tools for development and artifact management.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server scaffold that features built-in authentication, Docker support, and a comprehensive CI/CD release pipeline. It provides a standardized template for deploying servers with multi-transport support and configurable read-only modes.MIT
- AlicenseAqualityDmaintenanceAn MCP server that scaffolds full-stack projects with consistent structure, Docker setup, CI/CD pipelines, and database configuration.6MIT
- AlicenseBqualityDmaintenanceMCP server for Laravel Cloud to manage projects, environments, deployments, and other resources.98ISC
- AlicenseAqualityDmaintenanceMCP server for structured Laravel project planning. Scans projects, creates tickets, and exports as JSON.3MIT