webapp-testing

This skill provides a comprehensive toolkit for interacting with and testing local web applications using native Python Playwright scripts. It's designed to facilitate frontend functionality verification, UI behavior debugging, capturing browser screenshots, and viewing browser logs. The skill emphasizes a "black-box" approach to helper scripts, encouraging direct invocation rather than context ingestion to optimize agent performance.

It includes a decision tree to guide users in choosing the right approach for static HTML or dynamic web applications, offering solutions for managing server lifecycles and executing reconnaissance-then-action patterns. The skill promotes best practices like waiting for `networkidle` and using descriptive selectors to ensure robust and reliable test automation.

What It Does

This skill enables AI agents to programmatically interact with and test local web applications. It leverages Playwright to automate browser actions, allowing for verification of UI elements, simulation of user interactions, capturing visual states (screenshots), and inspecting browser console logs. It also provides helper scripts to manage the lifecycle of local development servers, simplifying the setup for testing dynamic applications.

When To Use

When needing to test the frontend functionality of a local web application.
To debug UI behavior or identify issues in dynamic web pages.
For capturing screenshots of web pages at specific states.
When automating interactions with web forms, buttons, or links.
To manage the startup and shutdown of local development servers as part of a testing workflow.
When needing to inspect the DOM or network activity of a running web application.

Installation

Copy SKILL.md to your skills directory