webapp-test-docker-demo

This skill acts as a comprehensive testing assistant for software engineers working with Playwright and Docker-based web applications. By integrating directly into your development workflow, it allows you to manage the entire lifecycle of End-to-End (E2E) testing without manually switching between your terminal and code editors. The agent handles configuration, environment validation, and test execution, ensuring that your test suite is always reliable and easy to interpret.

• Perform full test discovery by listing all .spec.ts files, features, and test cases categorized by tags such as @smoke and @regression.

• Execute test suites in varied environments, including standard headless modes or visual UI-based testing, with built-in remote execution support via Docker-Compose.

• Automatically verify the availability of the Docker service URL before running tests to prevent runtime failures and provide clear troubleshooting prompts.

• Generate comprehensive test reports, including status breakdowns (passed/failed), execution timelines, and links to generated test artifacts such as screenshots and trace files in the test-results/ directory.

• Assist in authoring new test cases by analyzing project requirements and existing patterns to maintain consistency across the codebase.

• To use this agent effectively, ensure your project path is correctly configured and the Docker service is running via docker-compose up -d.

• Environment variables such as DOCKER_SERVICE_URL must be defined to facilitate remote test execution. Use host IP addresses for local networks or port forwarding tools like localtunnel for external access.

• The agent is optimized for projects utilizing Playwright and supports both command-line execution and Python-based automation scripts for complex test orchestration.

• Input expectations include descriptive prompts for test generation or clear commands for execution, while outputs include structured lists of tests, pass/fail status updates, and HTML-based test reports generated at playwright-report/index.html.