package-testing - SKILL.md Agent Skill

name: package-testing description: "Use this skill when writing, editing, fixing, or reviewing package tests with Pest 4 and Orchestra Testbench, including TDD, feature tests, unit tests, type coverage, arch tests, workbench behavior, commands, routes, config, migrations, and publishable resources." license: MIT metadata: author: laravel

Prove package behavior with Pest 4, Orchestra Testbench, and the local tests/TestCase.php setup before or alongside implementation.

Start with TDD: write the smallest failing package test for the requested behavior, then implement the smallest change that makes it pass.
Cover happy-path, unhappy-path, and edge-case behavior when the feature has meaningful failure modes.
Prefer focused feature tests for package integration behavior and arch tests for broad constraints.
Use composer test:unit -- --filter ... while iterating, composer test:types when type-sensitive tests or code changed, and composer test before finishing.
Keep real package tests in the suite and remove only throwaway tests that were explicitly created for local scaffolding experiments.

Test config merge and config override by asserting default package config, then overriding the host config value in the Testbench app.
Test publishable assets, migrations, views, lang files, or config by invoking vendor publish behavior and asserting the target path exists.
Test routes with Testbench HTTP requests, commands with Artisan assertions, migrations with a SQLite test database, and workbench behavior after composer build when needed.