LA GUÍA DE CAMPO DE CLIPY

Graba la idea una vez. Úsala de principio a fin.

El flujo completo para convertir una grabación de pantalla en un traspaso claro, contexto para agentes, una corrección publicada y la prueba de que el resultado funciona.

RESPUESTA RÁPIDA

Usa Clipy para grabar exactamente lo que quieres explicar, haz evidentes los momentos importantes con Flare y la narración, y comparte el mismo enlace con una persona o con un agente de IA. Clipy también convierte videos de YouTube en contexto para agentes y graba la verificación de un agente como prueba.

EMPIEZA AQUÍ

¿Qué grabador te conviene?

Todos terminan en el mismo tipo de enlace para compartir. Elige la herramienta de captura que encaje con lo que necesitas mostrar.

Extensión de Chrome

Ideal para capturar pestañas rápido y, si quieres, diagnósticos de bugs con los datos sensibles ocultados.

Añadir a Chrome

GUÍAS EN VIDEO

¿Cómo hago…? Mira una guía de un minuto.

Guías cortas y narradas, grabadas con el propio Clipy. Cada una abre la página que explica la tarea completa, con el video arriba.

01 · APP PARA MAC

¿Cómo señalar sin tapar la pantalla?

Activa Flare y tu cursor se convierte en un foco temporal. Sustituye el “mira aquí” por un rastro visible que queda en la grabación y en la evidencia de puntero de Clipy.

  1. 1Empieza una grabación en la app nativa de Clipy para Mac.
  2. 2Activa Flare desde los controles de grabación.
  3. 3Mantén pulsado Control y mueve el puntero alrededor del elemento al que te refieres. Suéltalo cuando termines el resaltado.
  4. 4Narra lo importante mientras señalas: el problema, el estado esperado o la diferencia exacta medida.

El mejor hábito: rodea una vez, detente sobre el objetivo y di una instrucción completa. Garabatear rápido parece enérgico, pero da a quien lo ve y al agente menos evidencia útil.

Flare de Clipy resaltando una parte de la pantalla grabada con un rastro naranja del cursor que se desvanece
How to point at what you mean: Flare, hover, clicks and the pen Watch on Clipy
Un agente de IA envuelve un comando de prueba con Clipy y devuelve una grabación de prueba y un documento AREC

02 · GRABACIÓN DEL AGENTE

¿Cómo puede tu agente demostrar que su trabajo de verdad funciona?

Pídele al agente que grabe la verificación, no que solo diga “las pruebas pasan”. Clipy envuelve la ejecución, captura la pantalla y te da un video normal más evidencia estructurada que otro agente puede leer.

clipy session run --url http://localhost:3000 --type bug -- npx playwright test
  1. 1Configura Clipy para el agente actual una vez. La instalación y la grabación siempre requieren tu autorización explícita.
  2. 2Dile qué comportamiento visible para el usuario debe probar y qué cuenta como éxito.
  3. 3Haz que añada marcas de evidencia en los momentos importantes de antes, la acción y después.
  4. 4Pide los dos resultados: la URL para que las personas lo vean y la URL de contexto canónica .arec.

Un comando envuelto que falla se descarta; uno que sale bien se sube. Clipy graba la evidencia, pero las marcas siguen describiendo lo que observó el agente, en lugar de demostrar la afirmación de forma independiente.

03 · CONTEXTO DE VIDEO

¿Cómo le pasas un video de YouTube a un agente?

No le pidas al agente que adivine por el título ni que procese el video entero. Clipy convierte la URL en un paquete AREC con secciones de transcripción con marcas de tiempo, notas sobre huecos visuales y fotogramas seleccionados cuando están disponibles.

clipy context import "https://youtu.be/..." --sync --json
  1. 1Pega la URL de YouTube y di qué quieres que el agente aprenda o implemente a partir de ella.
  2. 2Deja que la skill de Clipy haga la importación. Primero van los subtítulos; los fotogramas se eligen en los momentos en que la evidencia visual importa.
  3. 3El agente lee primero los metadatos y los huecos visuales, busca tu pregunta y luego abre solo los momentos relevantes de la transcripción y los fotogramas cercanos.
  4. 4Vuelve a ejecutar la misma importación si un resultado parcial tiene el contexto de la transcripción pero los fotogramas siguen pendientes; las importaciones son idempotentes.
Abrir la guía completa de contexto de YouTube
Clipy importando una URL de YouTube a una transcripción con marcas de tiempo y fotogramas seleccionados legibles por agentes
Una grabación de bug en Clipy que se convierte en evidencia AREC y luego en una corrección de un agente de IA de programación

04 · DEL BUG A LA CORRECCIÓN

¿Cómo grabar un bug para que un agente pueda corregirlo?

Graba una reproducción limpia y di el resultado que esperabas. El enlace normal del video basta: con la skill de Clipy instalada, el agente obtiene las solicitudes, el plan, los momentos clave, la evidencia de puntero, los huecos de captura y la transcripción.

  1. 1Empieza desde un estado conocido y di el navegador, el rol de la cuenta, los datos de prueba y la ruta que importan.
  2. 2Narra cada acción una vez. Cuando aparezca el fallo, haz una pausa y di lo que pasó frente a lo esperado.
  3. 3En la extensión de Chrome, activa Capture bug context para adjuntar errores de consola, rechazos no gestionados, solicitudes fallidas, errores de GraphQL y actividad de WebSocket. Está desactivado por defecto.
  4. 4Pega el enlace de Clipy en tu agente de programación: “Reproduce esto, corrige la causa raíz, ejecuta las comprobaciones relevantes y envía la prueba de la corrección con Clipy.”

Límite de privacidad: la evidencia se oculta en tu navegador antes de subirse, las cookies nunca se leen, y los encabezados y cuerpos solo se conservan con Full network detail activado. Los mensajes de consola son texto libre escrito por la página, así que evita grabar pantallas sensibles y revisa antes de compartir.

05 · ITERACIÓN DE DISEÑO

¿Cómo convertir el feedback de diseño en una corrección en la misma sesión?

Recorre la interfaz construida comparándola con el mock. Usa Flare para que “este elemento” no deje dudas y habla en diferencias que un agente pueda editar: valor actual, valor objetivo, token y estado.

DI ESTO

“Este CTA tiene 20 píxeles de padding horizontal. El mock usa 32 píxeles, nuestro token --space-8.”

NO ESTO

“El botón se ve un poco apretado.”

  1. 1Deja el mock abierto como referencia, pero graba el build real que el desarrollador va a cambiar.
  2. 2Captura el diseño, la tipografía, el color, el radio y los estados de interacción como notas separadas y medidas.
  3. 3Dale el enlace de la grabación al agente del desarrollador y pídele que relacione cada diferencia con el componente y el token responsables.
  4. 4Haz que el agente reconstruya, grabe los estados corregidos y devuelva el enlace de prueba para la revisión visual final del diseñador.
Un diseñador señala una diferencia en la interfaz con Flare de Clipy, y un agente aplica y verifica el cambio de CSS medido

EL CICLO COMPLETO

¿Cómo se ve usar Clipy al máximo?

  1. 01

    Graba

    Muestra la pantalla real.

  2. 02

    Aclara

    Señala y narra la intención.

  3. 03

    Entrega

    Pega un enlace normal.

  4. 04

    Demuestra

    Graba el resultado funcionando.

REFERENCIA RÁPIDA

¿Qué deberías saber antes de empezar?

¿Qué grabador de Clipy debo usar?
Usa la app nativa para Mac cuando quieras Flare, audio del sistema o la ventana de una app real. Usa la extensión de Chrome para capturar rápido una pestaña, una ventana o la pantalla, con diagnósticos de bugs opcionales y los datos sensibles ocultados. Usa el grabador web cuando quieras empezar al instante sin instalar nada.
¿Cómo lee un agente de IA una grabación de Clipy?
Instala la skill de Clipy una vez y pega el enlace normal del video en Claude Code, Codex, Cursor, Windsurf u OpenCode. La skill obtiene el documento AREC canónico de la grabación, que incluye las solicitudes, los momentos clave, la evidencia visual, los huecos de captura y la transcripción.
¿Clipy puede darle a un agente contexto de YouTube?
Sí. La Clipy CLI importa una URL de YouTube a un paquete AREC con una transcripción con marcas de tiempo y fotogramas seleccionados cuando están disponibles. Con --sync, el texto derivado y los fotogramas seleccionados entran en tu biblioteca de contexto privada de Clipy; ese flujo no sube el video original.
¿Un agente de IA puede grabar su propio trabajo con Clipy?
Sí. La Clipy CLI puede envolver un comando de verificación en un navegador headless, grabar la ejecución, añadir marcas de evidencia y devolver una URL para ver el video más una URL de contexto AREC. Para ventanas nativas, puede grabar una pantalla o ventana de Mac elegida específicamente después de que el usuario autorice la grabación.
¿Qué debo decir en una grabación de feedback de diseño?
Di el valor actual, el valor deseado y el token correspondiente mientras señalas el elemento exacto. Por ejemplo: ‘Este botón tiene 20 píxeles de padding horizontal; el mock usa 32 píxeles, nuestro token space-8.’ Así el agente de programación recibe una diferencia concreta en lugar de un adjetivo.
¿Clipy captura secretos en los diagnósticos del navegador?
La captura de bugs oculta los datos en tu navegador antes de subirlos. Los tokens, las claves, los correos y los números de tarjeta se eliminan dondequiera que aparezcan, incluido el texto de la consola, y las cookies nunca se leen. Los encabezados y cuerpos de solicitudes y respuestas y los valores de las consultas solo se conservan si además activas Full network detail, y aun así los campos con nombres de contraseñas, tokens o datos personales se reemplazan por [redacted].

Haz que tu próxima grabación sea un punto desde el que el trabajo pueda continuar.

Graba el contexto, señala lo importante y deja que el mismo enlace lleve la tarea de la explicación a la implementación y a la prueba.