Communitygithub.com

gravar-site

Enregistre une vidéo horizontale (ordinateur, 1440x900, 30 ips) d'un site web, fluide et sans accroc, avec survol et clics de souris sur les fonctionnalités, à envoyer au client ou prospect qui ouvrira le lien sur mobile et veut aussi voir le rendu sur ordinateur.

Qu'est-ce que gravar-site ?

Cette skill permet de capturer une démonstration vidéo d'un site web dans un navigateur invisible, produisant une vidéo MP4 stable même avec des animations lourdes. Contrairement à un enregistrement d'écran classique, c'est le script qui exécute les actions (survols, clics, défilements) et non l'IA, ce qui permet de déléguer la tâche au modèle le moins coûteux disponible (Haiku pour Claude Code, mini modèle pour Codex/ChatGPT, Flash pour Gemini CLI, etc.). La vidéo générée est horizontale, en 1440×900 à 30 ips, et le script respecte des règles strictes : aucun formulaire n'est envoyé, aucun réseau social n'est ouvert, la carte et les iframes sont chargés en temps réel avant enregistrement. Deux modes sont proposés : un mode automatique (par défaut, sans scénario) qui parcourt le site section par section, et un mode scénario (avec fichier JSON) pour des séquences précises ou pour corriger les erreurs du mode automatique. Le résultat final comprend un MP4 et une fiche de contact (12 images clés) à vérifier avant livraison.

Compatible avec✓Claude Code✓Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/mkttpierre/site-demonstracao/tree/HEAD/skills/gravar-site

Demander à votre IA préférée

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

Documentation

Gravar site

Le script ouvre le site dans un navigateur invisible, avance l'horloge image par image et livre un MP4 qui ne saccade jamais, même avec des animations lourdes. C'est le script qui enregistre, pas l'IA : le modèle se contente de choisir le mode, d'exécuter une commande et de regarder une image à la fin. Utilisez donc cette skill avec le modèle le moins cher dont vous disposez :

  • Claude Code : Haiku (/model haiku) ou Sonnet en effort faible. Opus ici est un gaspillage.
  • Codex / ChatGPT : le modèle mini ou celui à effort faible.
  • Autres agents (Gemini CLI, Antigravity, Cursor) : le modèle rapide (Flash ou équivalent).

N'ouvrez pas de sous-agent et ne déléguez pas à un autre agent : le coût d'explication de la tâche est supérieur à celui d'exécution de la commande.

Exécution

node "${CLAUDE_SKILL_DIR}/scripts/gravar.mjs" --url https://site.com --saida "C:/chemin/livrables/site-pc.mp4"

Première fois sur la machine : cd "${CLAUDE_SKILL_DIR}/scripts" && npm install. Le script trouve tout seul le Chromium de Playwright et ffmpeg ; si l'un manque, le message d'erreur indique quoi installer. Cela prend 1 à 3 minutes.

Sortie : le MP4 et une ligne RESULTADO {...} avec ok, durée, taille, vérifications et folha_de_contato.

Deux modes

  • Automatique (par défaut, sans scénario) : montre le haut de la page et survole le bouton du menu ; descend section par section ; dans chacune, ouvre les onglets, les questions-réponses, clique sur les options du formulaire, saisit le nom ("Maria") et un message court, survole les boutons et les liens ; remonte en haut. Plafond de 75 s (--max 60 raccourcit). Convient à la plupart des sites ; a été testé sur deux structures différentes.
  • Scénario (--roteiro roteiro.json) : lorsque l'opérateur souhaite une séquence exacte ou que le mode automatique a échoué. Format et actions dans referencia/roteiro-exemplo.json. Les sélecteurs sont ceux de Playwright (#id, .classe, text=Reserver, role=button[name="X"]).

Options : --viewport 1440x900, --fps 30, --bloquear domaine.com (ajoute des blocages), --sem-folha.

Règles que le script respecte déjà

  • N'envoie jamais de formulaire et n'ouvre jamais WhatsApp, Instagram ou un autre site : les liens reçoivent seulement un survol de souris.
  • Laisse tout le réseau libre. La carte, les polices et les vidéos intégrées ne se chargent que comme cela ; tout bloquer sauf le domaine du site rend la carte cassée et change la police de la marque.
  • Attend que la carte et les iframes se chargent en temps réel avant d'enregistrer la section.
  • Rejette (ok: false) si le défilement à des à-coups, si un formulaire est envoyé, si une fenêtre s'ouvre ou si l'on quitte le site.

Vérifier avant de livrer (obligatoire)

  1. Lire l'image dans folha_de_contato (12 images clés de la vidéo entière). Chercher : écran blanc, image manquante, police modifiée, carte avec erreur, texte de test visible (XXXXXX, "lorem", CRP ou téléphone provisoire), curseur perdu.
  2. Si quelque chose ne va pas, corriger le site ou utiliser un scénario ; ne pas livrer avec des réserves.
  3. Supprimer la fiche (rm sur le chemin de folha_de_contato) et indiquer à l'opérateur le chemin du MP4, la durée et la taille.

La vidéo va dans le dossier entregas/ du client. L'envoyer est la décision de l'opérateur.

Limites

  • Seulement horizontal. Pour une vidéo verticale, --viewport 390x844 change la taille mais ne simule pas le toucher : à considérer comme une extension future, ne pas promettre.
  • Site nécessitant une connexion ou accessible uniquement avec des données réelles : utiliser un scénario et une URL de prévisualisation.
  • Pour réenregistrer après avoir modifié le site, publier d'abord la modification (le script enregistre l'adresse publique ou http://localhost:porta avec le serveur en marche).

Individual skills in this repo

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

Skills associés