Communitygithub.com

logo-popups

Haz que logos de aplicaciones (Claude, Codex, ChatGPT, Grok, Gemini, Cursor y cualquier otro) salgan de la punta del dedo del hablante cuando señala, sincronizados con la palabra que dice. El seguimiento de manos sigue el dedo, los logos se mantienen fuera del rostro y se conserva el audio original.

¿Qué es logo-popups?

Logo Popups es una habilidad para agentes de IA que permite insertar automáticamente logos de marcas (como Claude, Codex, ChatGPT, Grok, Gemini, Cursor, etc.) en videos, emergiendo desde la punta del dedo del hablante justo cuando menciona la marca. Es ideal para creadores de contenido técnico o reseñas de herramientas que quieran añadir un efecto visual profesional sin esfuerzo manual. Soporta plataformas como Claude Code, Cursor, Codex y cualquier otro agente que pueda ejecutar scripts de Python. La habilidad funciona en dos fases: primero, analiza el video con `track.py` para detectar cuándo el dedo está señalando, y con `words.py` para identificar las palabras dichas. Luego, genera un plan JSON que empareja cada señalización con un logo específico, y lo renderiza en el video final. Incluye opciones de personalización como color, tamaño, etiquetas, y evita automáticamente cubrir el rostro del hablante. Está diseñada para ser usada por usuarios no técnicos, con instrucciones claras y comandos simples.

Compatible con✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/sknitd/logo-popups/tree/HEAD

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Pop-ups de logos: logos que salen de tu dedo señalador

El usuario generalmente no es técnico. Mantén las respuestas cortas, haz el trabajo por ellos, nunca les pidas que ejecuten comandos.

Todas las rutas son relativas a la carpeta de esta habilidad (la carpeta donde está este SKILL.md). Usa su ruta absoluta en los comandos. PY a continuación significa .venv/bin/python en esta carpeta (.venv\Scripts\python.exe en Windows).

1. Primera ejecución: configuración (una vez)

Ejecuta bash scripts/setup.sh. Imprime READY cuando termine (de 1 a 3 minutos la primera vez).

  • NEED_FFMPEG: instálalo (Mac: brew install ffmpeg, Windows: winget install ffmpeg), luego vuelve a ejecutar la configuración.
  • NEED_PYTHON: instala Python 3.12 (Mac: brew install [email protected], Windows: winget install Python.Python.3.12), luego vuelve a ejecutar la configuración.

2. Encontrar la señalización y las palabras

Ejecuta ambos en su video:

  • PY scripts/track.py <video>: rastrea las manos, guarda <video>.hands.json e imprime las ventanas de señalización (momentos en que un dedo se mantiene levantado).
  • PY scripts/words.py <video>: imprime cuándo se dice cada palabra.

Empareja cada ventana con la marca que el hablante nombra en ella o cerca de ella. Whisper a menudo malinterpreta los nombres de marcas: "cloud" suele ser Claude, "codecs" Codex, "croc"/"grok" Grok, "chat GPT" ChatGPT, "Gemini", "cursor" Cursor. Si el usuario ya te dijo qué logos usar, utilízalos en el orden en que señala. Si ninguna palabra nombra una marca y el usuario no lo dijo, haz una pregunta corta: qué logos, en qué orden.

3. Escribir el plan

Guárdalo junto al video como <video-name>_logos.json:

{"pops": [
  {"logo": "claude", "start": 1.12, "end": 1.85},
  {"logo": "codex",  "start": 2.10, "end": 3.05},
  {"logo": "grok",   "start": 3.45, "end": 4.50}
]}
  • start: un instante después de que la mano se estabilice (el inicio de la ventana), o en la palabra, lo que ocurra más tarde. end: cuando el dedo baja o comienza el siguiente punto. De 0.7 a 1.2 s cada uno se ve mejor; nunca superpongas dos pop-ups.
  • logo: un nombre predefinido (abajo), cualquier nombre de icono de lobehub.com/icons (ej. notion, figma, vercel; primero intenta <nombre>-color), o una ruta a un PNG/SVG que haya dado el usuario.

Opciones por pop-up (todas opcionales):

clavequépor defecto
labeltexto en la píldora debajo del icono; "" lo ocultanombre de la marca
bgcolor del mosaico (hex)predefinido, si no blanco
fgcolor para logos SVG de un solo colorblanco en mosaicos oscuros, negro en claros
accentcolor del anillo del pop-uppredefinido, si no color del logo
sizeancho del mosaico como proporción del ancho del video0.24
logo_scaletamaño del logo dentro del mosaico0.66
gapdistancia más allá de la punta del dedo donde se coloca el icono (en tamaños de mosaico)0.85
nudgedesplazamiento extra [x, y] como proporción del ancho[0, 0]
avoid_facedeslizar hacia arriba si cubriría el rostrotrue
burstanillo y chispas al aparecertrue

Predefinidos: claude, anthropic, codex, openai, chatgpt, grok, gemini, cursor, perplexity, deepseek, copilot, mistral, meta.

4. Verificar, luego renderizar

  1. Primero fotogramas fijos (rápido): PY scripts/render.py <plan.json> <video> <carpeta>/check.png --still 1.5,2.6,4.0, un momento en medio de cada pop-up. Revisa el PNG tú mismo. Arregla cualquier cosa que cubra el rostro, se corte en el borde, o quede lejos del dedo (gap, nudge, size, tiempos).
  2. Renderizar: PY scripts/render.py <plan.json> <video> <video-name>_logos.mp4. Salida: H.264 MP4, 1080 de ancho, mismos fps, audio original.
  3. Diles dónde está el archivo y que lo vean antes de publicarlo.

Reglas

  • Nunca cubras el rostro. La evasión del rostro está activada por defecto; aun así revisa los fotogramas fijos.
  • Un logo por señalización. Si señalan dos veces a una misma marca, usa dos pop-ups.
  • Los logos son marcas registradas de sus propietarios; esto es para comentarios y reseñas. No añadas logos que el hablante no mencione a menos que el usuario lo pida.

Skills relacionados