run

Lance un site ou une application locale et l'affiche dans un vrai navigateur. Détecte la pile technique à partir de package.json, des fichiers de configuration ou d'un simple index.html, choisit un port libre, démarre le serveur de développement ou un serveur statique, attend qu'il réponde, effectue une capture d'écran ou l'ouvre, puis l'arrête avec un seul indicateur. À utiliser lorsque l'utilisateur demande à exécuter, servir, lancer, prévisualiser, démarrer ou ouvrir un projet localement, vérifier une page dans le navigateur, prendre une capture d'écran d'un site, ou lorsqu'une compilation doit être vue avant d'être jugée.

Qu'est-ce que run ?

Ce skill d'agent IA fournit une méthode universelle pour exécuter et inspecter visuellement des projets web locaux. Il détecte automatiquement la pile technique (frameworks, serveurs statiques) à partir de la structure du projet, démarre le serveur approprié sur un port libre, et peut ouvrir le navigateur ou prendre une capture d'écran via Playwright. Il est conçu pour les agents comme Claude Code, Cursor ou Codex, et garantit un cycle rapide de vérification : démarrage, capture d'écran, arrêt. Le skill gère aussi les échecs en lisant les logs, en signalant les dépendances manquantes ou les ports déjà utilisés, et en insistant sur la nécessité de toujours arrêter le serveur après usage.

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

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait run ?

Un site n'est pas terminé tant qu'il n'a pas été vu en fonctionnement. Le code source dit ce que quelqu'un avait l'intention ; le navigateur dit ce qu'une personne reçoit. Ce skill est le chemin le plus court entre un dossier et une page rendue.

Exécution

node <chemin/vers/skill>/scripts/serve.mjs <dossier> [--port 4173] [--open] [--shot sortie.png] [--stop] [--detect]
  • --detect affiche ce qu'il a trouvé et ne démarre rien. Faites-le d'abord lorsque le dossier est inconnu.
  • --port commence à chercher sur ce port et prend le port libre suivant, de sorte que deux projets peuvent fonctionner en même temps.
  • --open ouvre le navigateur par défaut.
  • --shot sortie.png rend la page à 1440 de large, en pleine hauteur, via Playwright.
  • --stop tue l'arborescence des processus à partir de .run/state.json.

Il écrit .run/state.json (pid, port, url, commande) et .run/server.log à côté du projet. Ces deux fichiers sont l'ensemble de l'interface entre le démarrage et l'arrêt.

Ce qu'il détecte

TrouveExécute
package.json avec dev, start, serve ou previewnpm run <ce script> sur un port libre, avec PORT défini
index.html à la racinepython -m http.server sur ce dossier
public/index.html, dist/index.html, build/index.htmlun serveur statique enraciné dans la sortie compilée
Un fichier de configuration mais aucun scriptle signale et s'arrête : le projet a besoin de sa propre commande
go.mod, Cargo.toml, pubspec.yamlle signale et s'arrête : utilisez la propre commande d'exécution du projet

Détails spécifiques au framework, ports par défaut et modes d'échec à connaître : references/stacks.md.

Lecture du résultat

Le script prouve trois choses et rien de plus : un processus a démarré, un port a répondu, une page a été rendue. Ce qu'il ne peut pas vous dire :

  • si la mise en page est correcte à 375, 768 et 1440 (utilisez sitecraft/scripts/verify.mjs pour cela)
  • si la console est propre (elle n'est pas capturée ici ; verify.mjs la capture)
  • si la page dont vous avez pris une capture d'écran est celle que l'utilisateur voulait (vérifiez l'URL par rapport à la route que vous avez demandée)

Ainsi, la boucle est : serve.mjs --shot, regardez l'image de vos propres yeux, corrigez, prenez une nouvelle capture. Trois rendus est la limite pour un passage ; au-delà, le problème est le plan, pas le CSS.

Règles

  • Ne laissez jamais un serveur en cours d'exécution. Arrêtez-le une fois la vérification terminée, ou dites clairement qu'il est toujours actif et sur quel port. Un serveur de développement errant sur la machine de l'utilisateur est un désordre qu'il doit nettoyer.
  • Ne démarrez pas ce que vous ne pouvez pas arrêter. Si le projet a besoin de Docker, d'une base de données ou d'une clé API payante, dites-le avant de lancer quoi que ce soit.
  • Signalez l'URL réelle. localhost:4173, pas "l'application". Si le port a changé parce que 4173 était pris, dites le nouveau.
  • Lisez le journal avant de deviner. Un échec de démarrage est presque toujours une dépendance manquante, une variable d'environnement manquante ou un port déjà utilisé. .run/server.log contient la réponse, et citer l'erreur réelle est mieux qu'une théorie.
  • Pas d'installations sans le dire. Si node_modules est manquant, npm install est généralement la bonne chose à faire, et c'est aussi une modification de leur projet. Faites-le, puis dites que cela a été exécuté, ou demandez une fois si l'installation est volumineuse.
  • Statique plutôt que framework. Lorsqu'une sortie compilée existe et est à jour, servir dist/ est plus rapide et plus fidèle que le serveur de développement.

Quand cela ne démarrera pas

  1. Lisez .run/server.log et citez la première erreur réelle, pas la dernière ligne.
  2. Dépendances manquantes : npm install dans le projet, puis réessayez.
  3. Variables d'environnement manquantes : cherchez .env.example, nommez ce qui est requis, et arrêtez si une valeur est secrète et absente.
  4. Port déjà utilisé : le script passe déjà au port libre suivant ; un port codé en dur dans la configuration du framework est la cause habituelle quand il échoue encore.
  5. Étape de compilation requise : exécutez npm run build d'abord, puis servez dist/.
  6. Natif ou conteneurisé : redonnez la commande documentée par le projet. Toutes les piles ne sont pas un script.

Liste de vérification

  • La pile technique a été détectée plutôt que supposée
  • Le serveur a été démarré et une réponse HTTP réelle a été vue, pas seulement un processus lancé
  • L'URL et le port exacts ont été signalés
  • Une capture d'écran a été examinée, pas seulement le journal
  • La route correspond à la page qui était visée
  • Le serveur a été arrêté, ou il est dit qu'il est toujours en cours d'exécution et où
  • L'erreur réelle a été citée en cas d'échec

Individual skills in this repo

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

Skills associés