Skip to content
Back to search

superpowers-laravel-marketplace

MarketplaceWorks with Claude CodeGitHub

Development marketplace for Laravel Superpowers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jpcaparas--superpowers-laravel/badge.svg)](/listings/jpcaparas--superpowers-laravel)

HTML

<a href="/listings/jpcaparas--superpowers-laravel"><img src="/api/listings/jpcaparas--superpowers-laravel/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code (via Plugin Marketplace)

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

Verify Installation

# 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 (Experimental)

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "superpowers-laravel-marketplace",
  3. "description": "Development marketplace for Laravel Superpowers.",
  4. "owner": {
  5. "name": "JP Caparas",
  6. "email": "jp@jpcaparas.com"
  7. },
  8. "plugins": [
  9. {
  10. "name": "superpowers-laravel",
  11. "description": "Laravel-focused skills for Claude Code: TDD (Pest/PHPUnit), migrations, queues, quality checks (Pint/Insights), and pragmatic architecture patterns — Sail and non-Sail compatible.",
  12. "version": "0.1.6",
  13. "source": "./",
  14. "author": {
  15. "name": "JP Caparas",
  16. "email": "jp@jpcaparas.com"
  17. }
  18. }
  19. ]
  20. }
README.md · README · 254 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Laravel Superpowers
  2. <p align="center">
  3. <img src="branding/logo.png" alt="Laravel Superpowers Logo" height="262" />
  4. </p>
  5. 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.
  6. ## What You Get
  7. <p align="center">
  8. <img height="350" alt="image" src="https://github.com/user-attachments/assets/4cc47e9d-80f6-40ab-b05a-28e39d21f2ce" />
  9. </p>
  10. - **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.
  11. - Can be used on its own; also compatible with the base Superpowers plugin. Overlapping generic skills are removed here to avoid conflicts.
  12. Plus:
  13. - **Slash Commands** - `/superpowers-laravel:brainstorm`, `/superpowers-laravel:write-plan`, `/superpowers-laravel:execute-plan`
  14. - **Automatic Integration** - Skills activate automatically when relevant
  15. - **Consistent Workflows** - Systematic approaches to common engineering tasks
  16. ## SessionStart Preview
  17. Below shows the startup message rendered when this plugin detects Laravel apps. The assistant now supports monorepos and adapts guidance based on which app is active and whether Sail is available.
  18. ### When Sail is detected - use Sail wrappers
  19. <p align="center">
  20. <img src="branding/with-sail.png" alt="SessionStart with Sail detected" height="250" />
  21. </p>
  22. ### When Sail is NOT detected - use host machine commands
  23. <p align="center">
  24. <img src="branding/without-sail.png" alt="SessionStart without Sail" height="300" />
  25. </p>
  26. ## Learn More
  27. Read the introduction to the original Superpowers: [Superpowers for Claude Code](https://blog.fsck.com/2025/10/09/superpowers/)
  28. ## Installation
  29. ### Claude Code (via Plugin Marketplace)
  30. ```bash
  31. # In Claude Code
  32. /plugin marketplace add jpcaparas/superpowers-laravel
  33. /plugin install superpowers-laravel@superpowers-laravel-marketplace
  34. ```
  35. ### Verify Installation
  36. ```bash
  37. # Check that commands appear
  38. /help
  39. # Should see Laravel commands, e.g.:
  40. # /superpowers-laravel:brainstorm
  41. # /superpowers-laravel:write-plan
  42. # /superpowers-laravel:execute-plan
  43. # /superpowers-laravel:laravel-check
  44. # /superpowers-laravel:laravel-tdd
  45. ```
  46. ### Codex (Experimental)
  47. Codex support is experimental. Use the skills from this repo directly or copy the `skills/` subfolders you want into your project’s `.claude/skills`.
  48. ## Quick Start
  49. ### Using Slash Commands
  50. **Brainstorm a design (Laravel-specific):**
  51. ```
  52. /superpowers-laravel:brainstorm
  53. ```
  54. **Create an implementation plan (Laravel-specific):**
  55. ```
  56. /superpowers-laravel:write-plan
  57. ```
  58. **Execute the plan (Laravel-specific):**
  59. ```
  60. /superpowers-laravel:execute-plan
  61. ```
  62. ### Automatic Skill Activation
  63. Skills activate automatically when relevant. For example:
  64. - `test-driven-development` activates when implementing features
  65. - `systematic-debugging` activates when debugging issues
  66. - `verification-before-completion` activates before claiming work is done
  67. ### Runner Guidance (Sail vs host)
  68. - Prefer running commands with Sail when it is available (`vendor/bin/sail` or a top‑level `./sail` helper); fall back to host tools otherwise.
  69. - When Sail is declared but containers are not running, the assistant will ask whether to start Sail (`sail up -d`) or proceed with host tools. It will not run host `php`/`composer`/DB/Node commands until you choose.
  70. - When Sail containers are running, use `sail` for all PHP/Composer/Node/DB commands to avoid environment drift; do not mix host and container installs in the same session.
  71. - Portable alias:
  72. ```
  73. alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'
  74. ```
  75. ### Monorepos and Multiple Apps
  76. When multiple Laravel apps exist (for example `apps/api`, `apps/admin`), the SessionStart hook:
  77. - Scans the repository recursively (ignores `vendor/`, `node_modules/`, `storage/`, and VCS/IDE folders) to find every `artisan` entrypoint.
  78. - Detects Laravel version per app (prefers `composer.lock` via `jq`, falls back to `composer.json` constraint or a portable parser).
  79. - Shows a summary list of all detected apps with version and Sail availability; marks the app in your current working directory as the “active” app.
  80. - Emits Sail guidance and interactive safety ONLY for the active app.
  81. Tip: `cd` into the app you intend to work on before starting your session to make it the active app.
  82. ## What's Inside
  83. ### Skills Library
  84. 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.
  85. 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.
  86. #### Laravel 13 Support
  87. Laravel 13 (released March 2026, PHP 8.3+) is fully covered. Stable skills carry clearly-marked "Laravel 13+" sections, and dedicated skills cover the headline features:
  88. - Laravel AI SDK — agents, embeddings, images, audio (`laravel:ai-sdk`)
  89. - Semantic / Vector Search with pgvector (`laravel:vector-search`)
  90. - First-Party PHP Attributes — `#[Middleware]`, `#[Authorize]`, `#[Tries]`, and friends (`laravel:php-attributes`)
  91. - Request Forgery Protection — origin-aware CSRF via `PreventRequestForgery` (`laravel:request-forgery-protection`)
  92. - Upgrade Guide 12.x → 13.x — breaking-change checklist (`laravel:upgrade-13`)
  93. Existing skills also gained 13.x guidance: JSON:API resources, `Queue::route()`, job attributes, `Interruptible` jobs, `Cache::touch()`, the `storage` cache driver, `Schedule::group()`, `FailOnUnknownFields` strict validation, JSON Schema rules, the `@fonts` directive, `php artisan dev`, and more.
  94. #### Docs Intersection (Laravel 11.x–13.x)
  95. We added a focused set of skills that reflect patterns stable across 11.x, 12.x, and 13.x:
  96. - Form Requests & Validation (`laravel:form-requests`)
  97. - Policies & Authorization (`laravel:policies-and-authorization`)
  98. - Eloquent Relationships & Loading (`laravel:eloquent-relationships`)
  99. - Transactions & Consistency (`laravel:transactions-and-consistency`)
  100. - HTTP Client Resilience (`laravel:http-client-resilience`)
  101. - Task Scheduling (`laravel:task-scheduling`)
  102. - API Resources & Pagination (`laravel:api-resources-and-pagination`)
  103. - Blade Components & Layouts (`laravel:blade-components-and-layouts`)
  104. - Filesystem Uploads & URLs (`laravel:filesystem-uploads`)
  105. - Rate Limiting & Throttle (`laravel:rate-limiting`)
  106. - Exception Handling & Logging (`laravel:exception-handling-and-logging`)
  107. ### Commands
  108. Commands are thin wrappers that activate skills. Key examples:
  109. - `brainstorm.md` → `laravel:brainstorming`
  110. - `write-plan.md` → `laravel:writing-plans`
  111. - `execute-plan.md` → `laravel:executing-plans`
  112. - `laravel-check.md` → `laravel:quality-checks`
  113. - `laravel-tdd.md` → `laravel:tdd-with-pest`
  114. Additional wrappers for the new docs‑intersection skills:
  115. - `laravel-form-requests.md` → `laravel:form-requests`
  116. - `laravel-policies.md` → `laravel:policies-and-authorization`
  117. - `laravel-eloquent-relationships.md` → `laravel:eloquent-relationships`
  118. - `laravel-transactions.md` → `laravel:transactions-and-consistency`
  119. - `laravel-http-client.md` → `laravel:http-client-resilience`
  120. - `laravel-scheduling.md` → `laravel:task-scheduling`
  121. - `laravel-api-resources.md` → `laravel:api-resources-and-pagination`
  122. - `laravel-blade-components.md` → `laravel:blade-components-and-layouts`
  123. - `laravel-filesystem-uploads.md` → `laravel:filesystem-uploads`
  124. - `laravel-rate-limiting.md` → `laravel:rate-limiting`
  125. - `laravel-exceptions-logging.md` → `laravel:exception-handling-and-logging`
  126. Laravel 13 wrappers:
  127. - `laravel-ai-sdk.md` → `laravel:ai-sdk`
  128. - `laravel-vector-search.md` → `laravel:vector-search`
  129. - `laravel-attributes.md` → `laravel:php-attributes`
  130. - `laravel-csrf.md` → `laravel:request-forgery-protection`
  131. - `laravel-upgrade-13.md` → `laravel:upgrade-13`
  132. ### Skills Overview
  133. - Onboarding & Runner
  134. - Planning & Execution
  135. - Data & Schema
  136. - Quality & Ops
  137. - Architecture
  138. - Performance
  139. - Testing
  140. - Utilities
  141. - Best Practices
  142. ## How It Works
  143. 1. **SessionStart Hook** – Adds Laravel onboarding (`laravel:using-laravel-superpowers`) when a Laravel repo is detected
  144. 2. **Skills System** - Uses Claude Code's first-party skills system
  145. 3. **Automatic Discovery** - Claude finds and uses relevant skills for your task
  146. 4. **Mandatory Workflows** - When a skill exists for your task, using it becomes required
  147. ## Philosophy
  148. - **Test-Driven Development** - Write tests first, always
  149. - **Systematic over ad-hoc** - Process over guessing
  150. - **Complexity reduction** - Simplicity as primary goal
  151. - **Evidence over claims** - Verify before declaring success
  152. - **Domain over implementation** - Work at problem level, not solution level
  153. ## Contributing
  154. Skills live directly in this repository. To contribute:
  155. 1. Fork the repository
  156. 2. Create a branch for your skill
  157. 3. Follow existing skill patterns (frontmatter name/description and focused, testable guidance)
  158. 4. Submit a PR with a short release-notes entry
  159. ### Run checks locally
  160. Validate structure and conventions before pushing:
  161. ```
  162. # Requires Node.js 18+ (20 recommended)
  163. npx tsx scripts/validate_skills.ts
  164. ```
  165. This verifies that:
  166. - `skills/` contains only one-level directories, each with `SKILL.md`
  167. - `SKILL.md` files have frontmatter with `name` (starting with `laravel:`) and `description`
  168. - `.claude-plugin/plugin.json` has required fields
  169. - `commands/*.md` have frontmatter `description`
  170. ## Updating
  171. Update via the plugin menu or pull the latest changes if you cloned this repo.
  172. ## Related Tools
  173. - 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.
  174. ## License
  175. MIT License - see LICENSE file for details
  176. ## Support
  177. - **Issues**: https://github.com/jpcaparas/superpowers-laravel/issues
  178. - **Marketplace**: https://github.com/jpcaparas/superpowers-laravel

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.