Game-Dev Agent Skills in Claude Code, Codex und Cursor einrichten

Installiere gamedev-skills/awesome-gamedev-agent-skills im Stammverzeichnis deines Spieleprojekts mit npx skills add gamedev-skills/awesome-gamedev-agent-skills, nimm router in die Auswahl auf und wähle deinen Coding-Agenten. Rufe anschließend den Router ausdrücklich auf und überprüfe eine kleine Änderung in Godot oder Unity, bevor du eine größere Funktion anforderst. Die Installation des gesamten Katalogs lädt nicht sämtliche Skill-Anweisungen in den Kontext: Agenten erfassen zunächst die Metadaten und lesen ausgewählte Anweisungen bei Bedarf.

Mit Stand 2026-10-26 enthält das aktuelle Repository 76 spezialisierte Skills und einen separaten Router, also insgesamt 77 Skill-Definitionen. In der About-Beschreibung des Repositorys steht weiterhin 74; prüfe anhand der aktuellen Dateien und der Installationsvorschau, was du tatsächlich erhältst. Das Paket steht unter der Apache-2.0-Lizenz.

Diese Einrichtung lohnt sich, wenn du bereits mit einem Coding-Agenten arbeitest und wiederverwendbare Anweisungen für deine Engine suchst. Das Paket liefert Hinweise zu Code und Arbeitsabläufen; den Spieleeditor, das Projekt und ein funktionierendes Agentenkonto oder eine API-Konfiguration brauchst du weiterhin.

Installiere das Paket im Projekt

Beginne mit einer Installation innerhalb des Projekts, damit du die hinzugefügten Dateien zusammen mit deinem Spiel prüfen kannst. Laut den npm-Metadaten ist die veröffentlichte Version der skills-CLI am 2026-10-26 1.7.4 und benötigt Node.js 22.20.0 oder neuer. Git muss ebenfalls verfügbar sein, damit das Repository abgerufen werden kann.

Öffne Bash im Stammverzeichnis des Spieleprojekts und sieh dir den Katalog an:

node --version
git --version
npx skills add gamedev-skills/awesome-gamedev-agent-skills --list

Suche nach router, godot-2d-movement, platformer und unity-scriptableobjects. Die Option --list zeigt verfügbare Skills an, ohne sie zu installieren. Lies den Router und die Skills, die du verwenden möchtest, bevor du die Installation bestätigst.

Führe den dokumentierten Installationsbefehl des Pakets aus:

npx skills add gamedev-skills/awesome-gamedev-agent-skills

Wähle für diese Anleitung in den interaktiven Optionen den Router und den gesamten Katalog aus. Wähle außerdem deinen Agenten und den Geltungsbereich Project. Ergänze -g nur, wenn du die Skills bewusst für dein Benutzerkonto und damit projektübergreifend installieren möchtest.

Um ausdrücklich den vollständigen Katalog für Codex auszuwählen, kannst du alternativ diesen Befehl verwenden:

npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill '*' -a codex

Ersetze codex für die anderen Clients durch claude-code oder cursor. Behalte die Anführungszeichen um '*' bei, damit Bash den Platzhalter nicht expandiert. Die CLI-Referenz unterscheidet zwischen --skill '*', das alle Skills auswählt, und --all, das zusätzlich alle Agenten auswählt.

Prüfe das Ergebnis:

npx skills list

Vergewissere dich, dass router und die Skills für die gewählte Engine-Prüfung aufgeführt sind. Der Installer lädt öffentliche Skill-Dateien herunter; die Authentifizierung für das Modell bleibt in deinem Coding-Client. Beim Ausführen des Agenten gelten weiterhin dessen normales Modellkontingent beziehungsweise die API-Abrechnung.

Wo laden Claude Code, Codex und Cursor die Dateien?

Prüfe den tatsächlichen Installationspfad, denn die vom Agenten unterstützten Verzeichnisse sind nicht immer identisch mit dem Zielverzeichnis der CLI. Für Projektinstallationen mit skills 1.7.4 gilt folgende Zuordnung:

Agent	Wert nach -a	Installationsziel im Projekt	Router ausdrücklich im Chat aufrufen
Claude Code	claude-code	.claude/skills/	/router
Codex CLI oder IDE-Erweiterung	codex	.agents/skills/	router über /skills auswählen oder $router erwähnen
Cursor Agent	cursor	.agents/skills/	/ eingeben und router auswählen

Diese Aufrufe gehören in den Chat des Agenten, nicht in Bash. Cursor unterstützt für die manuelle Installation auch .cursor/skills/. Die kurze Installationsseite des Pakets bleibt daher als Übersicht unterstützter Pfade nützlich; ein leeres Verzeichnis .cursor/skills/ bedeutet nicht, dass die CLI-Installation fehlgeschlagen ist.

Die aktuelle Agentenzuordnung des Installers verwendet sowohl für Codex als auch für Cursor .agents/skills/. Bei nur einem Zielverzeichnis werden die Dateien dorthin kopiert. Wenn du Clients mit unterschiedlichen Zielverzeichnissen auswählst, kann der Installer eine zentrale Kopie in .agents/skills/ über symbolische Links gemeinsam nutzen oder getrennte Kopien erstellen. Lies die Installationszusammenfassung, statt bei jeder Installation von Links auszugehen.

Jeder installierte Skill sollte die Struktur <skills-directory>/<skill-name>/SKILL.md haben. Der Bewegungs-Skill liegt bei Codex beispielsweise unter .agents/skills/godot-2d-movement/SKILL.md; der entsprechende Eintrag für Claude Code befindet sich unter .claude/skills/godot-2d-movement/SKILL.md. Behalte die mitgelieferten Verzeichnisse references/, scripts/ und assets/ bei, sofern sie vorhanden sind, wie es die Anleitung zur manuellen Installation vorgibt.

Wie vermeidet der Router, alle Skills zu laden?

Der Router wählt Anweisungen anhand der Engine und der Aufgabe aus; den Mechanismus zum bedarfsgerechten Laden stellt der Agent bereit. Die Übersicht zur Agent-Skills-Spezifikation beschreibt die Erkennung über Namen und Beschreibungen, die Aktivierung durch das Lesen eines Skills und die Verwendung zusätzlicher Ressourcen bei Bedarf.

Die Router-Anweisungen übertragen diesen Mechanismus auf die Spieleentwicklung:

1. Eine Engine anhand des Projekts identifizieren und ihre Version auslesen.
2. Die kleinste relevante Auswahl von Skills für Engine, Fachgebiet, Genre und Arbeitsablauf bestimmen.
3. Diese Anweisungen lesen und mitgelieferte Referenzen nur öffnen, wenn die Aufgabe sie benötigt.

Bei Godot ist project.godot das wichtigste Erkennungsmerkmal. Bei Unity ist es die Kombination aus Assets/ und ProjectSettings/ProjectVersion.txt. Eine Aufgabe zur Bewegung kann godot-2d-movement und platformer auswählen; eine spätere Aufgabe zum Speichern sollte die passenden Persistenzanweisungen auswählen, statt Kataloge unbeteiligter Engines zu laden.

Der Router selbst ist eine SKILL.md-Anleitung, der das Modell folgt. Er ist kein separates Programm, das eine maximale Anzahl von Lesezugriffen erzwingt. Auch die Installation des Routers allein liefert nicht die spezialisierten Anweisungen, auf die er verweist: Diese Skills müssen installiert und für den Agenten auffindbar sein.

Metadaten belegen weiterhin Kontext. Geladene Anweisungen, Werkzeugergebnisse und erneute Versuche zählen ebenfalls zum Modellverbrauch. Wenn deine vorhandene Skill-Sammlung Warnungen zum Kontextbudget für die Skill-Erkennung auslöst, installiere mit --skill eine kleinere Auswahl aus Router und den benötigten spezialisierten Skills. Aus der Anzahl der Skills allein lässt sich keine gemessene prozentuale Tokenersparnis ableiten.

Prüfe eine kleine Aufgabe in der Engine

Prüfe sowohl das Laden der Anweisungen als auch das daraus entstehende Verhalten in der Engine. Starte eine neue Agentensitzung im Spieleprojekt, wähle den Router anhand der Tabelle ausdrücklich aus und verwende einen der folgenden Prompts.

Wenn dein Client Werkzeugaktivitäten anzeigt, kontrolliere die tatsächliche Skill-Aktivierung oder die Dateizugriffe. Die bloße Aussage, ein Skill sei geladen worden, ist weniger aussagekräftig als das erfolgreiche Lesen seiner installierten SKILL.md.

Godot: einen zusätzlichen Sprung in der Luft ergänzen

Verwende eine bereits lauffähige Szene in Godot 4 mit einer Spielfigur auf Basis von CharacterBody2D, einer Kollisionsform und einem Boden. Der Router nennt für diese Aufgabe godot-2d-movement zusammen mit platformer; der Bewegungs-Skill liefert die enginespezifischen Hinweise für die Steuerung.

Use the installed router skill for this Godot project. Inspect project.godot
and the actual editor version before editing, and preserve that version.

Report the resolved paths of the router and selected SKILL.md files you
actually read. Resolve skill names through the installed skill locations.

Add one extra mid-air jump to the existing CharacterBody2D player.
Keep the change in the player controller and preserve the current controls.
A fresh jump press on the ground starts the first jump. One more fresh
press in the air starts the second. A third press before landing does
nothing. Holding the button must not repeatedly jump. Landing restores
both jumps.

List the changed files and give the exact scene and controls for checking
the result. Separate checks you ran from checks I must perform in Godot.

Starte die angegebene Szene. Zwei getrennte Tastendrücke sollten zwei Sprünge auslösen; ein dritter Tastendruck in der Luft sollte keinen weiteren Sprung starten. Nach der Landung sollten beide Sprünge wieder verfügbar sein. Halte die Taste während eines Sprungs auch gedrückt, um wiederholtes Auslösen auszuschließen, und prüfe auf neue Skript- oder Laufzeitfehler.

Die Bewegungsanweisungen des Pakets orientieren sich an Godot 4.7. Die Anleitung zur Engine-Erkennung verlangt jedoch, die Version eines vorhandenen Projekts beizubehalten. Die Installation des Pakets ist kein Grund, das Projekt zu migrieren oder APIs einer anderen Version einzusetzen.

Unity: gemeinsame Daten von veränderlichen Stückzahlen trennen

Verwende in einem vorhandenen Unity-Projekt eine Testszene, die du anschließend verwerfen kannst. Diese Prüfung nutzt unity-scriptableobjects; für die kleine Komponente, die die Daten verwendet, eignet sich außerdem unity-csharp-scripting. So überprüfst du die Skill-Anweisungen zu gemeinsam genutzten Daten, ohne ein vollständiges Inventarsystem anzufordern.

Use the installed router skill for this Unity project. Read
ProjectSettings/ProjectVersion.txt and preserve the editor and package
versions. Report the resolved SKILL.md paths you actually read.

Create an ItemDefinition ScriptableObject with itemId, displayName,
and maxStack, using CreateAssetMenu. Use one example asset with
itemId "potion", displayName "Potion", and maxStack 10. Treat the asset
as read-only configuration during play.

Create two distinct runtime slot instances referencing that same asset.
Start their quantities at 2 and 5. Add one small probe component that
decrements only the first slot, then reports quantities 1 and 5,
confirms both slots reference the same asset, and checks that the
definition fields are unchanged. Start each probe run with fresh slots.

Keep the output to the data model and probe component. Give exact
asset-creation, component-attachment, Inspector-assignment, and Play-mode
steps. Distinguish checks you executed from checks I must perform.

Erstelle das Beispiel-Asset über den erzeugten Eintrag im Menü Assets, füge die Prüfkomponente einem leeren GameObject hinzu, weise das Asset im Inspector zu und starte den Play-Modus. Das sichtbare Ergebnis sollte zeigen, dass sich die getrennten Stückzahlen von 2 und 5 auf 1 und 5 ändern, während beide Slots dieselbe Definition referenzieren. Nach dem Beenden des Play-Modus sollte das Asset weiterhin potion, Potion und 10 enthalten.

Die ScriptableObject-Dokumentation von Unity erklärt, dass mehrere Objekte dasselbe Asset über Referenzen gemeinsam nutzen können. Das Asset ist nicht von sich aus unveränderlich; dieses Beispiel hält veränderliche Stückzahlen bewusst in getrennten Laufzeitobjekten. Ändern sich beide Stückzahlen gleichzeitig, prüfe, ob die Implementierung versehentlich neben der Definition auch das Slot-Objekt gemeinsam verwendet.

Was tun, wenn der Router oder ein ausgewählter Skill nicht gefunden wird?

Prüfe Installation, Skill-Erkennung und Pfadauflösung getrennt voneinander. Wähle den nächsten Schritt anhand des Symptoms:

Symptom	Prüfung und nächster Schritt
Die Vorschau schlägt fehl, bevor Skills aufgelistet werden	Lies die tatsächliche Fehlermeldung. Prüfe die aktive Node.js-Version, die Verfügbarkeit von Git und den Zugriff auf npm/GitHub. Behebe das entsprechende Problem und führe --list erneut aus.
Die Liste enthält installierte Engine-Skills, aber keinen router	Wiederhole die Installation und nimm router in die Auswahl auf. Wer manuell nur den Inhalt von skills/ aus dem Repository kopiert, lässt das separate Verzeichnis router/ aus.
Die Dateien sind vorhanden, aber der Agent bietet die Skills nicht an	Prüfe, ob die Sitzung im richtigen Projekt läuft und jeder Ordner eine SKILL.md enthält. Kontrolliere die dokumentierten Pfade des Clients und starte die Sitzung neu, falls die Erkennung nicht aktualisiert wurde.
Der Agent kann einen Pfad mit skills/godot/ oder skills/unity/ am Anfang nicht öffnen	Suche den genannten Skill an seinem Installationsort und bestätige vor Änderungen, dass die Datei erfolgreich gelesen wurde.
Der Agent wählt die falsche Engine	Öffne das richtige Unterverzeichnis des Spiels oder benenne die gewünschte Engine und das Projekt ausdrücklich. Prüfe die gemeldeten Erkennungsmerkmale und die Version.

Bei der Pfadauflösung gibt es einen wichtigen Unterschied: Der Router beschreibt Quelldateien als skills/<category>/<name>/SKILL.md, während der CLI-Installer einzelne Skill-Verzeichnisse direkt unter ihren Namen installiert. Ein Agent, der dem relativen Quellpfad wörtlich folgt, kann einen installierten Skill übersehen. Dieser Unterschied in der Verzeichnisstruktur ist ein möglicher Prüfpunkt und kein Beleg dafür, dass alle Clients scheitern.

Bei einer Installation für Codex oder Cursor kann der ausgewählte Godot-Skill daher unter .agents/skills/godot-2d-movement/SKILL.md liegen, mit seinen eigenen Referenzen daneben. Verwende diesen gefundenen Pfad, statt im Spiel eine zweite Verzeichnisstruktur nach dem Vorbild des Repositorys anzulegen.

Prüfe Skills von Dritten vor der Wiederverwendung

Behandle diese Dateien als Anweisungen, die Änderungen und Befehlsausführung des Agenten beeinflussen können. Lies vor der ersten Verwendung den Router, die ausgewählten Skill-Anweisungen, benötigte Referenzen und alle Skripte oder externen Befehle, die sie den Agenten ausführen lassen. Prüfe, ob die Installation von Abhängigkeiten, Downloadziele, Uploads und destruktive Operationen zu deiner tatsächlich angeforderten Aufgabe passen.

Die Vorschau mit --list installiert das Skill-Paket nicht, doch npx führt weiterhin den Installer aus. Behalte deine üblichen Freigaben für Befehle bei und kontrolliere in der Installationszusammenfassung, welche vorhandenen Skills überschrieben würden.

Prüfe bei Updates auch den Frontmatter-Block mit Metadaten am Dateianfang. Die Dokumentation zu allowed-tools in Claude Code erklärt beispielsweise, dass dieses Feld die Werkzeugnutzung vorab genehmigen kann; es ist kein Mechanismus zur Sandbox-Isolation. Lies geänderte Anweisungen und mitgelieferte Befehle auch dann, wenn der Frontmatter-Block nur wenige Angaben enthält.

Halte die erste Änderung klein genug, um sie anhand eines Diffs prüfen zu können. Wiederhole nach einem Skill-Update die passende Engine-Prüfung, bevor du dich bei einer größeren Funktion darauf verlässt.