run (Ausführen)

Startet eine lokale Website oder App und zeigt sie in einem echten Browser an. Erkennt den Technologie-Stack aus package.json, Konfigurationsdateien oder einer einfachen index.html, wählt einen freien Port, startet den Dev-Server oder einen statischen Server, wartet, bis dieser antwortet, macht einen Screenshot oder öffnet den Browser und stoppt ihn auf Befehl. Verwende dies, wenn der Benutzer darum bittet, ein Projekt lokal auszuführen, zu starten, in der Vorschau anzuzeigen, zu öffnen, eine Seite im Browser zu prüfen, einen Screenshot einer Website zu machen oder wenn ein Build vor der Bewertung betrachtet werden muss.

Was ist run (Ausführen)?

Diese Fähigkeit bietet den kürzesten Pfad zwischen einem Ordner und einer gerenderten Webseite. Sie ist für Entwickler und KI-Agenten konzipiert, die ein lokales Projekt schnell in einem echten Browser anzeigen möchten. Die Fähigkeit erkennt den Projekt-Stack automatisch aus package.json-Skripten, statischen HTML-Dateien oder Build-Ordnern und startet den entsprechenden Dev- oder statischen Server. Sie unterstützt die optionale Erstellung von Screenshots mittels Playwright bei 1440px Breite und verwendet einen intelligenten Mechanismus zur Portauswahl, um Konflikte zu vermeiden. Nach Abschluss können Benutzer den Server mit einem einzigen Flag stoppen, und der vollständige Handover zwischen Start und Stopp erfolgt über die Dateien `.run/state.json` und `.run/server.log`. Die Fähigkeit enthält klare Regeln zur Fehlerbehandlung, Portpriorisierung und zur Vermeidung von versehentlich laufengelassenen Servern.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsdanylol/claude-sitecraft/tree/HEAD/skills/run

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht run (Ausführen)?

Eine Seite ist erst fertig, wenn sie in Aktion gesehen wurde. Der Quellcode verrät, was jemand beabsichtigt hat; der Browser zeigt, was der Benutzer erhält. Diese Fähigkeit ist der kürzeste Weg zwischen einem Ordner und einer gerenderten Seite.

Ausführen

node <skill folder>/scripts/serve.mjs <verzeichnis> [--port 4173] [--open] [--shot ausgabe.png] [--stop] [--detect]
  • --detect gibt aus, was gefunden wurde, und startet nichts. Verwende dies zuerst, wenn der Ordner unbekannt ist.
  • --port beginnt die Suche an diesem Port und nimmt den nächsten freien Port, sodass zwei Projekte gleichzeitig laufen können.
  • --open öffnet den Standardbrowser.
  • --shot ausgabe.png rendert die Seite mit 1440 Pixeln Breite, voller Höhe, über Playwright.
  • --stop beendet den Prozessbaum über .run/state.json.

Es schreibt .run/state.json (PID, Port, URL, Befehl) und .run/server.log neben das Projekt. Diese beiden Dateien sind der gesamte Handover zwischen Start und Stopp.

Was erkannt wird

GefundenAusführung
package.json mit dev, start, serve oder previewnpm run <dieses Skript> auf einem freien Port, mit gesetztem PORT
index.html im Stammverzeichnispython -m http.server in diesem Ordner
public/index.html, dist/index.html, build/index.htmlein statischer Server, der auf das erstellte Ausgabeverzeichnis zeigt
Eine Konfigurationsdatei, aber keine Skriptemeldet es und stoppt: das Projekt benötigt seinen eigenen Befehl
go.mod, Cargo.toml, pubspec.yamlmeldet es und stoppt: Verwende den eigenen Ausführungsbefehl des Projekts

Framework-Spezifika, Port-Standardwerte und die Wissenswerten Fehlermodi: references/stacks.md.

Das Ergebnis lesen

Das Skript belegt drei Dinge und nicht mehr: Ein Prozess wurde gestartet, ein Port hat geantwortet, eine Seite wurde gerendert. Was es nicht sagen kann:

  • ob das Layout bei 375, 768 und 1440 Pixeln korrekt ist (verwende dafür sitecraft/scripts/verify.mjs)
  • ob die Konsole sauber ist (wird hier nicht erfasst; verify.mjs erfasst sie)
  • ob die auf dem Screenshot gezeigte Seite die vom Benutzer gemeinte ist (überprüfe die URL gegen die Route, nach der du gefragt hast)

Die Schleife lautet also: serve.mjs --shot, betrachte das Bild mit eigenen Augen, korrigiere, erstelle erneut einen Screenshot. Drei Renderings sind das Maximum für einen Durchlauf; danach liegt das Problem am Plan, nicht am CSS.

Regeln

  • Lasse niemals einen Server laufen. Stoppe ihn, wenn die Überprüfung abgeschlossen ist, oder sage klar, dass er noch läuft und auf welchem Port. Ein versehentlich laufender Dev-Server auf dem Rechner des Benutzers ist ein Problem, das er bereinigen muss.
  • Starte nichts, was du nicht stoppen kannst. Wenn das Projekt Docker, eine Datenbank oder einen kostenpflichtigen API-Schlüssel benötigt, sage dies, bevor du etwas startest.
  • Melde die echte URL. localhost:4173, nicht "die App". Wenn der Port verschoben wurde, weil 4173 belegt war, nenne den neuen.
  • Lies das Protokoll, bevor du rätst. Ein fehlgeschlagener Start ist fast immer eine fehlende Abhängigkeit, eine fehlende Umgebungsvariable oder ein bereits belegter Port. .run/server.log enthält die Antwort, und das Zitieren des tatsächlichen Fehlers ist besser als jede Theorie.
  • Keine Installation ohne Ansage. Wenn node_modules fehlt, ist npm install normalerweise richtig, und es ist auch eine Änderung ihres Projekts. Führe es aus, sage dann, dass es gelaufen ist, oder frage einmal nach, wenn die Installation umfangreich ist.
  • Statisch vor Framework. Wenn ein Build-Output existiert und aktuell ist, ist das Ausliefern von dist/ schneller und genauer als der Dev-Server.

Wann es nicht startet

  1. Lese .run/server.log und zitiere den ersten tatsächlichen Fehler, nicht die letzte Zeile.
  2. Fehlende Abhängigkeiten: npm install im Projekt, dann erneut versuchen.
  3. Fehlende Umgebungsvariablen: Suche nach .env.example, benenne, was erforderlich ist, und stoppe, wenn ein Wert geheim ist und fehlt.
  4. Port bereits belegt: Das Skript weicht bereits auf den nächsten freien Port aus; ein hartcodierter Port in der Framework-Konfiguration ist die übliche Ursache, wenn es trotzdem fehlschlägt.
  5. Build-Schritt erforderlich: Führe zuerst npm run build aus, dann liefere dist/ aus.
  6. Nativ oder containerisiert: Gib den Befehl zurück, den das Projekt dokumentiert. Nicht jeder Stack ist ein Skript.

Checkliste

  • Der Stack wurde erkannt, nicht angenommen
  • Gestartet und eine echte HTTP-Antwort gesehen, nicht nur einen gestarteten Prozess
  • Die genaue URL und den Port gemeldet
  • Einen Screenshot betrachtet, nicht nur das Protokoll
  • Überprüft, ob die Route mit der gemeinten Seite übereinstimmt
  • Gestoppt, oder gesagt, dass es noch läuft und wo
  • Den tatsächlichen Fehler bei einem Fehler zitiert

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills