laravel-dusk-skill — Claude Code skill for Laravel browser tests
Generates E2E tests with Laravel Dusk. The agent writes PHP code with $browser->visit, form checks, and Page Objects.
MIT 231 installs ★ 393 updated 2026-10-13
npx skills add LambdaTest/agent-skills --skill laravel-dusk-skill -a claude-codeWhat laravel-dusk-skill does
The skill teaches the agent to write browser tests for Laravel apps using Dusk. It produces classes with visit(), type(), press(), assertSee() — the standard Dusk API for Chrome. Includes Page Object patterns, form handling, and element waiting (waitFor, waitUntilMissing).
TestMu AI Cloud integration is built in: the agent configures RemoteWebDriver with LambdaTest credentials when LT_USERNAME and LT_ACCESS_KEY are set in .env. Local runs need Dusk installed via composer require --dev laravel/dusk && php artisan dusk:install.
The reference/playbook.md has 10 sections: from setup to CI/CD with GitHub Actions, a table of 12 common issues, and a 14-point checklist. The agent relies on these when building login tests, multi-step flows, and database work with DatabaseMigrations.
What it helps with
- write a Dusk test for login with redirect verification
- build a Page Object for a registration form
- set up Laravel Dusk runs through LambdaTest
- add a multi-step form test with element waits
- integrate Dusk into GitHub Actions with MySQL
Example prompts for the agent
- Write a Dusk test for the login form: enter
[email protected]andpassword123, press Login, verify redirect to/dashboard - Create a
LoginPagePage Object with alogin()method andassertPathIs('/login')check - Configure
DuskTestCase::driver()to run via TestMu AI Cloud using.envcredentials
How to install laravel-dusk-skill
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill laravel-dusk-skill -a claude-code2Manually: put the files in place
~/.claude/skills/laravel-dusk-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/laravel-dusk-skill/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill laravel-dusk-skill -a codex2Manually: put the files in place
.agents/skills/laravel-dusk-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill laravel-dusk-skill -a cursor2Manually: put the files in place
.cursor/skills/laravel-dusk-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install LambdaTest/agent-skills laravel-dusk-skill2Manually: put the files in place
.github/skills/laravel-dusk-skill/SKILL.md1Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill laravel-dusk-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/LambdaTest/agent-skills --path laravel-dusk-skillManually: put the files in place
.devin/skills/laravel-dusk-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill laravel-dusk-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about laravel-dusk-skill
How to install laravel-dusk-skill in Claude Code?
Run npx skills add LambdaTest/agent-skills --skill laravel-dusk-skill -a claude-code. The skill appears in ~/.claude/skills/laravel-dusk-skill/SKILL.md.
What does laravel-dusk-skill do?
It generates browser E2E tests with Laravel Dusk: classes using $browser->visit(), form assertions, Page Objects, and TestMu AI Cloud integration via RemoteWebDriver.
What does laravel-dusk-skill require?
Locally — Laravel Dusk installed via composer require --dev laravel/dusk. For TestMu AI Cloud runs — LT_USERNAME and LT_ACCESS_KEY in .env.
Source text
SKILL.md · MIT
---
name: laravel-dusk-skill
description: >
Generates Laravel Dusk browser tests in PHP. Chrome-based E2E testing for
Laravel apps. Use when user mentions "Dusk", "Laravel Dusk", "$browser->visit",
"DuskTestCase". Triggers on: "Laravel Dusk", "Dusk test", "$browser->visit",
"DuskTestCase".
languages:
- PHP
category: e2e-testing
license: MIT
metadata:
author: TestMu AI
version: "1.0"
---
# Laravel Dusk Skill
For TestMu AI cloud execution, see [reference/cloud-integration.md](reference/cloud-integration.md) and [shared/testmu-cloud-reference.md](../shared/testmu-cloud-reference.md).
## Core Patterns
### Basic Test
```php
<?php
namespace Tests\Browser;
use Laravel\Dusk\Browser;
use Tests\DuskTestCase;
class LoginTest extends DuskTestCase
{
public function testLoginWithValidCredentials(): void
{
$this->browse(function (Browser $browser) {
$browser->visit('/login')
->type('email', '[email protected]')
->type('password', 'password123')
->press('Login')
->assertPathIs('/dashboard')
->assertSee('Welcome');
});
}
public function testLoginWithInvalidCredentials(): void
{
$this->browse(function (Browser $browser) {
$browser->visit('/login')
->type('email', '[email protected]')
->type('password', 'wrong')
->press('Login')
->assertPathIs('/login')
->assertSee('Invalid credentials');
});
}
}
```
### Browser Methods
```php
// Navigation
$browser->visit('/path');
$browser->back();
$browser->forward();
$browser->refresh();
// Forms
$browser->type('name', 'value');
$browser->clear('name');
$browser->select('select', 'option');
$browser->check('checkbox');
$browser->uncheck('checkbox');
$browser->radio('radio', 'value');
$browser->attach('file', '/path/to/file');
$browser->press('Button Text');
$browser->click('.selector');
// Assertions
$browser->assertSee('text');
$browser->assertDontSee('text');
$browser->assertPathIs('/expected');
$browser->assertUrlIs('http://full-url');
$browser->assertInputValue('name', 'value');
$browser->assertChecked('checkbox');
$browser->assertVisible('.element');
$browser->assertMissing('.element');
$browser->assertTitle('Page Title');
$browser->assertPresent('.selector');
// Waiting
$browser->waitFor('.element');
$browser->waitFor('.element', 10); // 10 seconds
$browser->waitUntilMissing('.loading');
$browser->waitForText('Loaded');
$browser->waitForLink('Click Me');
$browser->pause(1000); // milliseconds
```
### Page Objects
```php
<?php
namespace Tests\Browser\Pages;
use Laravel\Dusk\Page;
class LoginPage extends Page
{
public function url(): string { return '/login'; }
public function assert(Browser $browser): void
{
$browser->assertPathIs($this->url());
}
public function login(Browser $browser, string $email, string $password): void
{
$browser->type('email', $email)
->type('password', $password)
->press('Login');
}
}
// Usage
$browser->visit(new LoginPage)
->login($browser, '[email protected]', 'password123');
```
### Cloud: Override `DuskTestCase::driver()` to return `RemoteWebDriver` with LT caps
## Setup: `composer require --dev laravel/dusk && php artisan dusk:install`
### Cloud Execution on TestMu AI
Set `.env` variables: `LT_USERNAME`, `LT_ACCESS_KEY`
```php
// tests/DuskTestCase.php
protected function driver()
{
$options = (new ChromeOptions)->addArguments(['--disable-gpu', '--no-sandbox']);
$ltOptions = [
'user' => env('LT_USERNAME'),
'accessKey' => env('LT_ACCESS_KEY'),
'build' => 'Laravel Dusk Build',
'name' => $this->getName(),
'platformName' => 'Windows 11',
'video' => true,
'console' => true,
];
$options->setExperimentalOption('LT:Options', $ltOptions);
return RemoteWebDriver::create(
'https://hub.lambdatest.com/wd/hub', $options
);
}
```
## Run: `php artisan dusk` or `php artisan dusk tests/Browser/LoginTest.php`
## Deep Patterns
See `reference/playbook.md` for production-grade patterns:
| Section | What You Get |
|---------|-------------|
| §1 Project Setup | Installation, DuskTestCase, .env.dusk configuration |
| §2 Browser Tests | Login flows, forms, multi-step wizards, multiple browsers |
| §3 Page Objects | Page class with elements, custom methods, assertions |
| §4 Components | DatePicker, Modal, reusable component pattern |
| §5 Advanced Interactions | JavaScript, scrolling, drag-and-drop, waiting strategies |
| §6 Database & Data | DatabaseMigrations, factories, screenshots, console logs |
| §7 LambdaTest Integration | Remote WebDriver with LT:Options capabilities |
| §8 CI/CD Integration | GitHub Actions with MySQL, ChromeDriver, artifact upload |
| §9 Debugging Table | 12 common problems with causes and fixes |
| §10 Best Practices | 14-item Laravel Dusk testing checklist |
© TestMu AI · MIT · LambdaTest/agent-skills