ProofShot: reúne evidencias de verificación en el navegador

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

• Dificultad: principiante
• Proyecto: https://github.com/AmElmo/proofshot (licencia MIT)
• Guía completa: https://lab.wisd.ai/hub/proofshot-verification

Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Preparación

Comprueba Node.js ≥24 y npm para esta ruta con la versión actual de agent-browser. ProofShot por sí solo declara Node.js ≥18, pero el paquete npm de agent-browser exige ≥24. Abre la carpeta de una aplicación con un script npm run dev que escuche en el puerto 3000; adapta el ejemplo oficial si tu proyecto usa otro comando o puerto.

El manifiesto de ProofShot marca agent-browser como dependencia opcional. Para completar la preparación en una máquina nueva, instala primero agent-browser y Chrome con su procedimiento oficial, y después ProofShot y su skill. En Linux sigue también las dependencias del sistema de ese README:

npm install -g agent-browser
agent-browser install
npm install -g proofshot
proofshot install

Desde la carpeta de tu aplicación, inicia el ejemplo oficial:

proofshot start --run "npm run dev" --port 3000 --description "Verificación de la página inicial"

Usa el paso intermedio exec del README para conservar la sesión aislada que abrió ProofShot:

proofshot exec open http://localhost:3000
proofshot exec snapshot -i
proofshot exec screenshot step-inicio.png

Comprueba que la captura muestra tu página. Para probar una interacción, obtén sus referencias actuales con snapshot -i antes de usar exec click o exec fill; no copies referencias de otro sitio. Al terminar, genera los entregables:

proofshot stop

Revisa los entregables localmente antes de subirlos.

Comprobación

Abre la carpeta fechada indicada bajo proofshot-artifacts/: contiene session.webm, viewer.html, SUMMARY.md y la captura. Comprueba que vídeo, capturas y errores corresponden al recorrido realizado y permiten revisar el cambio.

Si algo falla

Verifica que la aplicación responde y que agent-browser puede abrirla antes de iniciar otra grabación.