Was ist das Cypress AI Toolkit?

Das Cypress AI Toolkit ist eine offizielle Open Source Sammlung des Cypress Teams, die KI Coding Agenten Cypress Wissen mitgibt. Herzstück sind drei Skills: cypress-author zum Schreiben und Reparieren von Tests, cypress-explain zum Verstehen und Kritisieren bestehender Tests und cypress-docs für verlässliche Antworten aus der Cypress Doku.

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. Sie funktionieren mit jedem Agenten, der Skills oder eigene Anweisungen unterstützt, also auch mit OpenCode. Zum Toolkit gehört außerdem die Konfiguration für Cypress Cloud MCP.

Das Problem dahinter kennt jeder, der Agenten Tests schreiben lässt: Der Code läuft, folgt aber generischen Mustern. Falsche Selektoren, feste Wartezeiten, keine Nutzung der vorhandenen Custom Commands. Das Toolkit gibt dem Agenten das Wissen, das erfahrene Cypress Entwickler im Kopf haben.

Ein KI Agent schreibt in Sekunden einen Cypress Test. Ob der Test etwas taugt, hängt am Wissen, das er mitbekommt. Die offiziellen Skills liefern das Cypress Wissen, wir liefern den Rest: Regeln in der AGENTS.md, saubere Custom Commands und Quality Gates, die jeden generierten Test prüfen. Wir nutzen die Skills täglich in OpenCode. Roland Golla ist Cypress Ambassador und hat Tests von Hand geschrieben, reviewt und repariert, lange bevor Agenten dazukamen. Dieses Wissen steckt bei uns in den Regeln, mit denen der Agent arbeitet.

In den NCA KI Workshops für Entwicklerteams arbeitet das Team im Terminal mit OpenCode, und die Cypress Skills richten wir dort gleich mit ein. Für Teams, die Agenten schon im Alltag nutzen, gibt es die Vibe Coding Beratung mit den NCA Agentic AI Coding Guardrails. Wer tiefer in Cypress selbst einsteigen will, ist im Cypress Workshop mit Roland Golla richtig. Wie OpenCode Skills lädt und verwaltet, zeigt unsere Seite zu OpenCode Features und Plugins.

Jeder Skill hat eine klare Aufgabe. Zusammen decken sie den Alltag mit Cypress und KI Agenten ab.

• cypress-author erstellt, ändert und repariert E2E und Komponenten Tests. Er liest vorher dein Projekt: Konfiguration, bestehende Specs, Custom Commands und Fixtures. So passen neue Tests zu deinen Konventionen statt zu generischen Beispielen. Er springt auch an, wenn du nur schreibst: Schreib einen Test für diese Datei.
• cypress-explain erklärt, beschreibt und kritisiert bestehende Tests. Er findet schwache Selektoren, flaky Assertions und zu eng gekoppelte Tests und zeigt fehlende Abdeckung. Ideal für Audits, Onboarding und vor jedem größeren Umbau.
• cypress-docs lässt den Agenten gezielt in der offiziellen Cypress Doku nachschlagen, über LLM optimierte Quellen. Antworten stützen sich dann auf die aktuelle Doku statt auf altes Trainingswissen.

Gerade der letzte Punkt ist mehr wert, als er klingt. Cypress ändert sich, und ein Agent ohne Doku Zugriff schreibt oft noch Syntax aus seinem Training. Ein aktuelles Beispiel ist die Umstellung auf --expose bei Cypress Grep.

Der schnellste Weg ist das skills Paket. Ein Befehl im Projektordner installiert alle drei Skills.

Du willst nur einzelne Skills? Dann gibst du den Namen mit an. Alternativ geht es auch über die GitHub CLI.

Manuell kopierst du die Skill Ordner aus dem Repository in das Skills Verzeichnis deines Agenten. OpenCode findet Skills im Projekt an drei Stellen:

• .opencode/skills/ als eigenes OpenCode Verzeichnis
• .agents/skills/ als agentenübergreifendes Verzeichnis
• .claude/skills/ für Projekte, die schon Claude Code Skills haben

Global geht es über ~/.config/opencode/skills/. Wir installieren die Cypress Skills immer projektbezogen und committen sie mit. So arbeitet das ganze Team mit derselben Version, und das Update läuft über einen Merge Request.

Wichtig für Updates: Das skills Paket prüft nur projektbezogene Installationen auf neue Versionen, globale nicht. Ein weiterer Grund für die Installation im Projekt.

Die Skills starten automatisch, wenn dein Prompt passt. Sicherer ist der direkte Aufruf per Slash Command. Dann weißt du, welcher Skill arbeitet. Das Wort Cypress im Prompt erhöht außerdem die Chance, dass der richtige Skill anspringt.

Neue Tests schreiben mit cypress-author. Je genauer du das erwartete Verhalten beschreibst, desto besser der Test:

Kaputte Tests reparieren ebenfalls mit cypress-author. Gib dem Agenten die Fehlermeldung und die Spec, nicht das ganze Projekt.

Bestehende Tests prüfen mit cypress-explain. Das ist unser Standard vor jedem Umbau einer Suite:

Fragen zur API beantwortet cypress-docs, zum Beispiel: Wie funktioniert cy.intercept, und wann nutze ich cy.wait mit Alias? Der Agent schlägt in der Doku nach und nennt die Quelle.

Bei uns läuft jeder KI generierte Test durch dieselbe Kette, egal wie gut der Prompt war. Der Agent arbeitet dabei gegen eine lokale Umgebung mit Fake Daten aus dem Seed, nie gegen echte Kundendaten.

Die Skills setzen allgemeine Cypress Regeln. Deine Projektregeln kennen sie nicht. Die gehören in die AGENTS.md. Der Agent mischt beides: das Cypress Wissen aus dem Skill und die Konventionen deines Teams.

Ein Tipp aus der Troubleshooting Doku des Toolkits: Skills lassen den Agenten gern package.json und Cypress Konfiguration lesen. Das kostet Token. Sag im Prompt ausdrücklich minimal exploration oder nenn direkt die Datei, die als Vorlage dienen soll. Und prüf, ob deine AGENTS.md auf sehr große Dateien verweist.

Skills helfen beim Schreiben. Das zweite Standbein des Toolkits ist die Konfiguration für Cypress Cloud MCP. Damit liest der Agent Testergebnisse, flaky Tests und Fehler direkt aus Cypress Cloud und sieht, wie sich seine Tests in der Pipeline verhalten.

Der Loop sieht dann so aus:

• Cloud MCP zeigt, welcher Test seit gestern 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 prüfen lokal, die Pipeline prüft den Rest, ein Mensch gibt frei.

Die MCP Verbindung nutzt standardmäßig OAuth. Wer lieber mit einem Personal Access Token arbeitet, passt die MCP Konfiguration seines Agenten an. Mehr zum Zusammenspiel mit Agenten steht auf unserer Seite zu Cypress mit KI Agenten und bei Self Healing Tests.

Mit den Skills schreiben Agenten Tests, die näher an der Suite des Teams sind. Was getestet werden soll, entscheiden sie trotzdem nicht. Das klären wir vorher mit dem Team, zum Beispiel per Example Mapping, und geben dem Agenten die fertigen Beispiele als Auftrag.

Eine Regel setzen wir in jedem Projekt zuerst durch: Testdateien und Custom Commands sind geschützt. Ein Agent darf neue Specs anlegen. Eine bestehende Assertion abschwächen, damit ein Test grün wird, darf er nicht. Wie wir das technisch absichern, beschreiben die Quality Gates für KI Code und unser Artikel zu Code Qualität mit KI Agenten.

Weiterlesen: das ESLint Plugin für Cypress als erste Prüfung jedes generierten Tests, Cypress Grep für Burn Tests und Smoke Runs, Agent Skills und das skills Ökosystem, cy.prompt als weiterer KI Weg in Cypress und das NCA Cypress Glossar mit allen Einträgen.

Die wichtigsten Antworten zu Skills, Installation, OpenCode, Prompts und Guardrails.