Playwright Best Practices: consejos por tarea para pruebas TypeScript

Para quién

Esta guía es para quien escribe, depura o mantiene pruebas Playwright en TypeScript y quiere que un agente dé consejos apuntados a la actividad actual. Oficialmente es impulsada por la actividad: lo que haces apunta a las referencias correspondientes, en lugar de cargar todo de una vez.

Repositorio:

https://github.com/currents-dev/playwright-best-practices-skill

Encaja cuando el repositorio ya tiene pruebas Playwright y quieres arreglar un caso inestable o añadir comprobaciones de accesibilidad. El material dice que no hace falta pronunciar el nombre de la habilidad ni “Playwright best practices”; basta con enunciar la tarea con claridad.

No encaja en entornos que escriben sobre todo pruebas en otros lenguajes, o sin un mecanismo compatible de instalación de habilidades. El material existente limita la guía a pruebas Playwright en TypeScript; no lo extiendas a lenguajes no escritos.

Primer intento en 3 minutos

Sigue solo el camino oficial recomendado.

Requisitos previos: esta máquina puede ejecutar npx, el agente actual admite esta instalación y el espacio de trabajo tiene una prueba Playwright que se puede comentar. Antes de instalar, confirma que escribes en el entorno de agente que realmente usas.

Lugar de instalación: lo gestiona npx skills add. El material no nombra una carpeta destino; no completes una ruta que no aparezca.

Copia y ejecuta:

npx skills add https://github.com/currents-dev/playwright-best-practices-skill 

Señal de éxito: el comando termina con normalidad. Haz primero una comprobación de solo lectura: abre una prueba relacionada con el inicio de sesión y dile al agente «mira esta prueba de inicio inestable, señala primero posibles causas, no cambies archivos». El ejemplo oficial es exactamente “fix this flaky login test”. Si la respuesta cita esperas, apuntados o aserciones concretas en vez de una reescritura vaga, se usaron las referencias correspondientes.

Cuando aceptes el análisis, autoriza explícitamente qué archivo puede cambiar. Cambiar pruebas tiene efectos secundarios; no dejes que parchee hasta confirmar el alcance.

Casos de uso

Caso 1: investigar una prueba de inicio inestable. Corresponde a la tarea de ejemplo oficial “fix this flaky login test”. Encaja cuando una prueba a veces pasa y a veces falla y quieres primero un consejo enfocado. Describe el síntoma y el registro de fallo, y pide solo análisis. Si tiene éxito, la respuesta aterriza en referencias de la actividad actual, no vuelca los 57 documentos de golpe. El material no nombra las ocho categorías; no inventes categorías ni nombres de archivo. Antes de cambiar de verdad, confirma el archivo y el comportamiento esperado.

Caso 2: añadir pruebas de accesibilidad. Corresponde al ejemplo oficial “add accessibility tests”. Encaja si ya hay un flujo de página y quieres comprobaciones de accesibilidad. Primero pide aserciones propuestas a partir de la prueba de página actual, aún sin escribir archivos. Tras confirmar selectores y cobertura, deja que añada casos. Señal de éxito: el consejo corresponde a la página que nombraste, no una plantilla genérica. El material existente solo muestra que esta descripción de tarea puede disparar; no expande API ni claves de configuración.

Límites de uso

El material existente da un comando de instalación y el uso «apuntar referencias según la actividad». No cambies a un comando de mercado, una ruta de clon u otro instalador que no aparezca. Tampoco nombra clientes obligatorios; no escribas soporte exclusivo de unos pocos agentes.

La biblioteca de referencias son 57 documentos en 8 clases; nombres de clase y rutas por documento no están escritos. No inventes rutas de documentos ni subcarpetas de habilidad.

Guía escribir, depurar y mantener pruebas Playwright en TypeScript. Los pasos para otros lenguajes u otros marcos de prueba no se pueden completar con el material existente. Cambiar pruebas cambia el repositorio; analiza primero y luego autoriza la escritura. Más detalle en el repositorio oficial:

https://github.com/currents-dev/playwright-best-practices-skill