Install
npx skills add https://github.com/currents-dev/playwright-best-practices-skillPour qui
Ce guide s'adresse à qui écrit, débogue ou maintient des tests Playwright en TypeScript et veut qu'un agent donne des conseils ciblés sur l'activité en cours. Officiellement, c'est piloté par l'activité : ce que vous faites pointe vers les références correspondantes, au lieu de tout charger d'un coup.
Dépôt :
https://github.com/currents-dev/playwright-best-practices-skill
Cela convient quand le dépôt a déjà des tests Playwright et que vous devez corriger un cas instable ou ajouter des contrôles d'accessibilité. Le matériau dit qu'il n'est pas nécessaire de prononcer le nom de la compétence ou “Playwright best practices” ; énoncer clairement la tâche suffit.
Cela ne convient pas aux environnements qui écrivent surtout des tests dans d'autres langages, ou sans mécanisme d'installation de compétences compatible. Le matériau existant limite le guidage aux tests Playwright TypeScript ; ne l'étendez pas à des langages non écrits.
Premier essai en 3 minutes
Suivez uniquement le chemin officiel recommandé.
Préconditions : cette machine peut exécuter npx, l'agent actuel accepte cette installation, et l'espace de travail a un test Playwright discutable. Avant d'installer, confirmez que vous écrivez dans l'environnement d'agent réellement utilisé.
Emplacement d'installation : géré par npx skills add. Le matériau ne nomme pas de dossier cible ; n'ajoutez pas un chemin absent.
Copiez et exécutez :
npx skills add https://github.com/currents-dev/playwright-best-practices-skill
Signal de succès : la commande se termine normalement. Faites d'abord une vérification en lecture seule : ouvrez un test lié à la connexion et dites à l'agent « regarde ce test de connexion instable, indique d'abord les causes possibles, ne change pas les fichiers ». L'exemple officiel est exactement “fix this flaky login test”. Si la réponse cite des attentes, des cibles ou des assertions précises plutôt qu'une réécriture vague, les références correspondantes ont été utilisées.
Après acceptation de l'analyse, autorisez explicitement quel fichier il peut changer. Modifier des tests a des effets de bord ; ne le laissez pas appliquer de rustine avant confirmation du périmètre.
Cas d'usage
Cas 1 : enquêter sur un test de connexion instable. Correspond à l'exemple officiel “fix this flaky login test”. Convient quand un test passe parfois et échoue parfois, et que vous voulez d'abord un avis ciblé. Décrivez le symptôme et le journal d'échec, demandez seulement l'analyse. En cas de succès, la réponse atterrit sur les références de l'activité en cours, sans déverser les 57 documents d'un coup. Les huit noms de catégories ne sont pas dans le matériau ; n'inventez pas de catégories ni de noms de fichiers. Avant de vraiment modifier, confirmez le fichier et le comportement attendu.
Cas 2 : ajouter des tests d'accessibilité. Correspond à l'exemple officiel “add accessibility tests”. Convient si un flux de page existe déjà et que vous voulez des contrôles d'accessibilité. Demandez d'abord des assertions proposées à partir du test de page actuel, sans encore écrire de fichiers. Après confirmation des sélecteurs et de la couverture, laissez-le ajouter des cas. Signal de succès : des conseils qui correspondent à la page nommée, pas un modèle générique. Le matériau existant montre seulement que cette description de tâche peut déclencher ; il n'étend pas les API ou clés de configuration.
Limites d'usage
Le matériau existant donne une commande d'installation et l'usage « pointer les références selon l'activité ». Ne passez pas à une commande de place de marché, un chemin de clone ou un autre installateur absent. Aucun client obligatoire n'est nommé ; n'écrivez pas un support exclusif pour quelques agents.
La bibliothèque de références compte 57 documents en 8 classes ; noms de classes et chemins par document sont non écrits. N'inventez pas de chemins de documents ni de sous-dossiers de compétence.
Il guide l'écriture, le débogage et la maintenance des tests Playwright en TypeScript. Les étapes pour d'autres langages ou d'autres cadres de test ne se complètent pas à partir du matériau existant. Changer des tests change le dépôt ; analysez d'abord, puis autorisez l'écriture. Plus de détails sur le dépôt officiel :
https://github.com/currents-dev/playwright-best-practices-skill