Ein Coding Agent schreibt in wenigen Sekunden einen Cypress Test. Der Test läuft grün. Im Review fällt dann auf, was fehlt: Da steht ein fester cy.wait, der Selektor hängt an einer CSS Klasse, und der Login wird per Hand durchgeklickt, obwohl das Projekt längst ein cy.login hat. Genau hier setzt das Cypress AI Toolkit an. Das Cypress Team gibt Agenten damit das Wissen mit, das erfahrene Tester im Kopf haben.
NCA Cypress Workshop mit Roland Golla: Roland ist Cypress Ambassador, zeigt in über 70 Live Coding Tutorials auf dem NCA YouTube Kanal, wie Cypress in echten Projekten läuft, und pflegt mit NCA TESTIFY ein eigenes Plugin für Basistests mit einer Zeile im CI/CD Setup. Zum Cypress Workshop
Der Agent kann programmieren und kennt Cypress trotzdem schlecht
Das Cypress Team beschreibt das Problem im README des Toolkits sehr ehrlich. Dein KI Tool sei fähig, heißt es dort, aber: „It just does not know Cypress the way you do.“ Ohne Anleitung greifen Agenten auf allgemeine Muster zurück. Sie nutzen die Cypress API zu wenig, wählen falsche Selektoren und lassen Best Practices weg. Das Ergebnis läuft, aber man kann sich nicht darauf verlassen.
Wir kennen das aus jedem Projekt, in dem Agenten Tests schreiben. Deshalb haben wir schon früh eigene Regeln für KI generierte Tests aufgestellt. Wie die aussehen, steht in Testing Meta für Cypress. Das Toolkit nimmt uns jetzt einen Teil dieser Arbeit ab, weil das Cypress Wissen direkt vom Hersteller kommt.
Drei Skills mit klaren Aufgaben
Skills sind Ordner mit einer SKILL.md Datei. Der Agent lädt sie, wenn eine Aufgabe passt, oder du rufst sie per Slash Command auf. Das Toolkit bringt drei davon mit:
| Skill | Aufgabe | Wann wir ihn nutzen |
|---|---|---|
| cypress-author | Schreibt, ändert und repariert Tests im Stil des Projekts | Neue Specs und kaputte Tests aus der Pipeline |
| cypress-explain | Erklärt und kritisiert bestehende Tests | Vor jedem Umbau einer Suite und beim Onboarding |
| cypress-docs | Schlägt gezielt in der offiziellen Cypress Doku nach | Fragen zur API und zu neuen Features |
Am meisten bringt uns cypress-explain. Bevor ein Agent eine Spec anfasst, soll er sie erst verstehen. Der Skill zeigt schwache Selektoren, Assertions, die flaky werden können, und Fälle, die fehlen. Danach schreibt cypress-author mit genau diesem Wissen. cypress-docs ist der stille Helfer: Cypress ändert sich, und ein Agent ohne Doku Zugriff schreibt sonst gern Syntax aus seinem alten Training.
So kommen die Skills in euer Projekt
Ein Befehl im Projektordner reicht. Das skills Paket installiert alle drei Skills auf einmal:
npx skills add cypress-io/ai-toolkitWir nutzen die Skills täglich in OpenCode. OpenCode findet sie unter anderem in .opencode/skills im Projekt. Wir installieren sie immer projektbezogen und committen sie mit. So arbeitet das ganze Team mit derselben Version, und jedes Update läuft über einen eigenen Merge Request. Alle Wege, auch die GitHub CLI und die manuelle Installation, beschreibt unsere Glossarseite zum Cypress AI Toolkit. Die offizielle Anleitung findet ihr in der Cypress Doku zu AI Skills.
Im Alltag rufen wir die Skills direkt auf. Dann ist klar, welcher Skill arbeitet. Ein typischer Auftrag sieht so aus:
/cypress-author Der Test in cypress/e2e/search.cy.ts schlägt in CI fehl.
Finde die Ursache und repariere den Test.
Keine festen Wartezeiten, kein force: true.
Nutze cypress/e2e/cart.cy.ts als Vorlage.Die Vorlage im Prompt hat einen zweiten Vorteil. Der Agent muss nicht das halbe Projekt lesen, um den Stil zu verstehen. Das spart Token und Zeit.
Gute Skills machen Guardrails nicht überflüssig
Die Skills heben die Qualität der generierten Tests deutlich. Fehlerfrei werden die Tests dadurch nicht. Deshalb läuft bei uns jeder KI generierte Test durch dieselbe Kette:
- Regeln in der AGENTS.md: Projektwissen wie cy.dataCy und cy.login steht in der AGENTS.md. Der Agent mischt es mit dem Cypress Wissen aus dem Skill.
- Linting als erster Filter: Das ESLint Plugin für Cypress stoppt feste Wartezeiten und unsichere Muster sofort.
- Burn Tests gegen Flakes: Mit Cypress Grep läuft jeder neue Test mehrfach hintereinander.
- Geschützte Testdateien: Der Agent darf neue Specs anlegen. Bestehende Assertions abschwächen, damit ein Test grün wird, darf er nicht.
- Fake Daten statt Kundendaten: Agenten arbeiten gegen eine lokale Umgebung mit Daten aus dem Seed.
- Review vor dem Merge: Ein Mensch gibt frei, erst dann geht der Test in die Pipeline.
Warum E2E Tests gerade mit Agenten zum wichtigsten Gate werden, erklärt der Beitrag zur Testpyramide für KI Agents. Was bei jedem Push in der Pipeline passiert, zeigt Quality Gates in der Pipeline. Das komplette Regelwerk für Teams fassen wir in den NCA Agentic AI Coding Guardrails zusammen.
Mit Cloud MCP schließt sich der Kreis
Zum Toolkit gehört auch die Konfiguration für Cypress Cloud MCP. Damit liest der Agent Ergebnisse, Fehler und flaky Tests direkt aus Cypress Cloud. Zusammen mit den Skills entsteht ein Ablauf, der sich gut anfühlt:
- Cloud MCP zeigt, welcher Test seit dem letzten Run rot oder flaky ist.
- cypress-explain analysiert die Spec und nennt die wahrscheinliche Ursache.
- cypress-author repariert den Test nach den Regeln aus der AGENTS.md.
- Linting und Burn Tests prüfen lokal, danach folgen Pipeline und Review.
Mehr Agent Läufe bedeuten auch mehr Pipeline Läufe. Wie ihr die Kosten dabei im Griff behaltet, ohne Tests zu streichen, steht in CI Rechnung explodiert. Das Toolkit selbst ist Open Source unter MIT Lizenz und liegt auf GitHub bei cypress-io.
Was das Toolkit für Teams bedeutet
Das Cypress AI Toolkit bringt Agenten näher an die Tests, die ein erfahrenes Team selbst schreiben würde. Die Installation dauert eine Minute, der Nutzen zeigt sich beim ersten Review. Was getestet werden soll, entscheidet aber weiter das Team. Und ob ein Test etwas taugt, entscheiden Linting, Burn Läufe und ein Mensch. Wer beides kombiniert, bekommt schnelle Tests, auf die er sich verlassen kann.
Häufige Fragen zum Cypress AI Toolkit
Was ist das Cypress AI Toolkit 2026?
Eine offizielle Open Source Sammlung des Cypress Teams für KI Coding Agenten. Sie enthält die Skills cypress-author, cypress-explain und cypress-docs sowie die Konfiguration für Cypress Cloud MCP. Damit folgen generierte Tests den Cypress Best Practices und dem Stil eures Projekts.
Funktioniert das Toolkit 2026 auch mit OpenCode?
Ja. Die Skills laufen mit jedem Agenten, der Skills oder eigene Anweisungen unterstützt. Wir nutzen sie täglich in OpenCode und legen sie projektbezogen unter .opencode/skills ab, damit das ganze Team dieselbe Version hat.
Brauche ich 2026 KI Erfahrung für die Cypress Skills?
Nein. Laut Cypress reichen Cypress und ein KI Coding Tool. Für den Einsatz im Team empfehlen wir trotzdem klare Regeln: AGENTS.md, Linting, Burn Tests, geschützte Testdateien und ein Review vor jedem Merge.
Ersetzen die Skills das Review?
Nein. Die Skills verbessern die Qualität deutlich, machen Tests aber nicht fehlerfrei. Bei uns geht jeder KI generierte Test erst nach Linting, mehreren Burn Läufen und einem menschlichen Review in die Pipeline.
Wie rufe ich einen Skill gezielt auf?
Per Slash Command, also /cypress-author oder /cypress-explain mit eurer Aufgabe dahinter. Ohne Slash Command lädt der Agent den Skill automatisch, wenn der Prompt passt. Der direkte Aufruf ist verlässlicher.
Cypress Tests von Agenten, auf die ihr euch verlassen könnt
Wir richten mit euch die Cypress Skills, die AGENTS.md Regeln und die Quality Gates ein, die jeden generierten Test prüfen. Wer Cypress im Team selbst lernen will, ist im Workshop mit Roland Golla richtig. Das Vorgespräch ist kostenlos.
