Laravel-focused skills for Claude Code and AI coding assistants. Brings proven workflows (TDD, debugging, planning) plus Laravel‑specific guidance that works with or without Sail.

• Laravel Skills – Runner selection (Sail/non‑Sail), TDD with Pest/PHPUnit, migrations + factories, queues + Horizon, quality gates (Pint/Insights/PHPStan), pragmatic architecture (Ports & Adapters, Template Method), and complexity guardrails.
• Can be used on its own; also compatible with the base Superpowers plugin. Overlapping generic skills are removed here to avoid conflicts.

Plus:

• Slash Commands - /superpowers-laravel:brainstorm, /superpowers-laravel:write-plan, /superpowers-laravel:execute-plan
• Automatic Integration - Skills activate automatically when relevant
• Consistent Workflows - Systematic approaches to common engineering tasks

Read the introduction to the original Superpowers: Superpowers for Claude Code

# In Claude Code
/plugin marketplace add jpcaparas/superpowers-laravel
/plugin install superpowers-laravel@superpowers-laravel-marketplace

# Check that commands appear
/help

# Should see Laravel commands, e.g.:
# /superpowers-laravel:brainstorm
# /superpowers-laravel:write-plan
# /superpowers-laravel:execute-plan
# /superpowers-laravel:laravel-check
# /superpowers-laravel:laravel-tdd

Codex support is experimental. Use the skills from this repo directly or copy the skills/ subfolders you want into your project’s .claude/skills.

Brainstorm a design (Laravel-specific):

/superpowers-laravel:brainstorm

Create an implementation plan (Laravel-specific):

/superpowers-laravel:write-plan

Execute the plan (Laravel-specific):

/superpowers-laravel:execute-plan

Skills activate automatically when relevant. For example:

• test-driven-development activates when implementing features
• systematic-debugging activates when debugging issues
• verification-before-completion activates before claiming work is done

Skills live in skills/ and are designed for everyday Laravel work. Core examples include runner-selection, tdd-with-pest, migrations-and-factories, quality-checks, queues-and-horizon, and ports-and-adapters — with many more patterns ready for larger teams.

This fork focuses on Laravel skills and removes overlapping generic skills so it can be used independently without conflicts. It is also compatible with the base Superpowers plugin if you choose to install both. Use the Laravel‑specific commands here, or continue using the base plugin’s generic workflows.

Commands are thin wrappers that activate skills. Key examples:

• brainstorm.md → laravel:brainstorming
• write-plan.md → laravel:writing-plans
• execute-plan.md → laravel:executing-plans
• laravel-check.md → laravel:quality-checks
• laravel-tdd.md → laravel:tdd-with-pest

• Onboarding & Runner
• Planning & Execution
• Data & Schema
• Quality & Ops
• Architecture
• Performance
• Testing
• Utilities

1. SessionStart Hook – Adds Laravel onboarding (laravel:using-laravel-superpowers) when a Laravel repo is detected
2. Skills System - Uses Claude Code's first-party skills system
3. Automatic Discovery - Claude finds and uses relevant skills for your task
4. Mandatory Workflows - When a skill exists for your task, using it becomes required

• Test-Driven Development - Write tests first, always
• Systematic over ad-hoc - Process over guessing
• Complexity reduction - Simplicity as primary goal
• Evidence over claims - Verify before declaring success
• Domain over implementation - Work at problem level, not solution level

Skills live directly in this repository. To contribute:

1. Fork the repository
2. Create a branch for your skill
3. Follow existing skill patterns (frontmatter name/description and focused, testable guidance)
4. Submit a PR with a short release-notes entry

Validate structure and conventions before pushing:

# Requires Node.js 18+ (20 recommended)
npx tsx scripts/validate_skills.ts

This verifies that:

• skills/ contains only one-level directories, each with SKILL.md
• SKILL.md files have frontmatter with name (starting with laravel:) and description
• .claude-plugin/plugin.json has required fields
• commands/*.md have frontmatter description

Update via the plugin menu or pull the latest changes if you cloned this repo.

• Laravel Boost: a Laravel‑focused MCP server that augments AI‑powered local development (Cursor, Claude Code, etc.). See https://github.com/laravel/boost and https://boost.laravel.com/. This skill catalogue is designed to complement Boost if you install both.

MIT License - see LICENSE file for details

• Issues: https://github.com/jpcaparas/superpowers-laravel/issues
• Marketplace: https://github.com/jpcaparas/superpowers-laravel