CommunityImagengithub.com

interactive-greeting-card

Convierte una imagen y un mensaje en una tarjeta de felicitación 3D interactiva, una tarjeta doblada en WebGL cuyo foil o pintura gruesa atrapa la luz al moverla, que se abre al mensaje escrito a mano en su interior y se gira para mostrar su reverso, y que puede cobrar vida con luces brillantes, nieve cayendo, corazones flotantes y partes que se balancean y reaccionan al tacto. Genera un único archivo HTML autónomo que funciona sin conexión y puede enviarse o alojarse en cualquier lugar. Úsalo cada vez que alguien quiera una tarjeta de felicitación, e-card o tarjeta digital (cumpleaños, Navidad, festivo, San Valentín, Día de la Madre, agradecimiento, boda, aniversario, felicitación, mejoría), o quiera convertir su propia obra de arte, pintura, ilustración o foto en una tarjeta con un mensaje en su interior, incluso si nunca dice interactivo o 3D.

¿Qué es interactive-greeting-card?

Este skill transforma una imagen y un mensaje en una tarjeta de felicitación 3D interactiva, empaquetada en un único archivo HTML autónomo que funciona sin conexión. La tarjeta se presenta como un objeto plegable en WebGL que se balancea en la página, atrapa la luz en su foil o pintura, se abre con un toque para mostrar un mensaje escrito a mano, y se voltea para mostrar su reverso. Es ideal para desarrolladores y creadores que deseen generar rápidamente tarjetas personalizadas (cumpleaños, Navidad, San Valentín, etc.) sin depender de plataformas externas. El skill incluye scripts para construir la tarjeta (`make_card.py`), previsualizar el foil (`foil_preview.py`), superponer una cuadrícula de píxeles (`grid.py`) y capturar capturas de pantalla (`snapshot.mjs`). Admite acabados como foil (oro, plata, rosa, cobre, rosa, holográfico), pintura o impresión, y efectos opcionales como nieve, corazones, luciérnagas, estrellas fugaces y brillos. Además, permite que las tarjetas 'cobren vida' con animaciones interactivas como luces que parpadean, colas que se mueven o ramas que se balancean, todo definido mediante coordenadas en la imagen.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/annnguyentt/interactive-greeting-card-skill/tree/HEAD/interactive-greeting-card

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Tarjeta de felicitación interactiva

Haz una tarjeta con la que alguien quiera jugar: su imagen en la portada de una tarjeta doblada que se balancea en la página, atrapa una luz móvil en su foil o pintura, se abre con un toque para mostrar su mensaje en escritura a mano, y se voltea para mostrar su reverso. Una construcción corta convierte una imagen y unos pocos ajustes en un único archivo HTML con todo dentro (imagen, fuente, renderizador), por lo que se abre directamente desde un archivo, funciona sin conexión y se aloja en cualquier servidor web sin cambios.

Qué incluye este skill:

  • scripts/make_card.py construye la página a partir de los datos de la tarjeta (JSON). Verifica los datos y explica cualquier error antes de escribir nada.
  • scripts/grid.py dibuja una cuadrícula de píxeles etiquetada sobre la imagen, cortada exactamente como la tarjeta la corta, para leer posiciones en ella (solo necesaria para efectos vivos y selecciones de color).
  • scripts/foil_preview.py muestra exactamente qué se convierte en foil, en magenta, para que puedas ajustar el foil antes de construir (necesita numpy).
  • scripts/snapshot.mjs (opcional, necesita Node y Playwright) captura la portada, el interior y el reverso, y con --live muestra qué se mueve en una tarjeta viva y qué hace cada toque.
  • references/options.md enumera cada ajuste. references/living-cards.md explica cómo hacer que una tarjeta cobre vida. Léelos cuando los necesites, no antes.

Cómo hacer una tarjeta

1. Obtén la imagen y el mensaje

Las dos cosas que necesitas de la persona son la imagen para la portada y qué escribir dentro. Si falta alguna, pídela, u ofrécete a escribir el mensaje por ellos (pregunta para quién es, y de quién). Todo lo demás tiene un valor predeterminado sensato, así que no les hagas responder un cuestionario; elige bien y menciona las decisiones que tomaste para que puedan cambiarlas.

Toma el mensaje tal como lo dan. No pulas sus palabras a menos que lo pidan, pero pon saltos de línea donde una tarjeta escrita a mano los tendría (un saludo en su propia línea, la despedida al final); una línea demasiado larga para la hoja se ajusta sola, a unas 20 letras. Hasta unas 60 palabras se lee grande y cómodo; las cartas más largas se escriben más pequeñas, y más allá de lo que cabe, el final se corta, así que sugiere recortar una muy larga.

Varias imágenes hacen varias tarjetas en una página, repartidas una tras otra con un muelle para cambiar entre ellas. Eso sirve para un conjunto de tarjetas, o una tarjeta en varios diseños para elegir.

2. Observa la imagen y elige el acabado

El acabado decide cómo la portada atrapa la luz. Observa la imagen antes de elegir:

La imagenAcabadoNotas
Una pintura con textura de pincel (óleos, gouache, acrílico, acuarela espesa)paintLas propias pinceladas se levantan y brillan bajo la luz. Si tiene pintura dorada, haz que también brille: foil.on: "colour" con el dorado seleccionado.
Una ilustración, arte lineal, lettering o diseño plano, especialmente en papel lisofoilon: "details" estampa las líneas y los detalles oscuros en foil; "colour" estampa un color que elijas (letras doradas, por ejemplo); "darks" estampa las formas más oscuras (siluetas).
Una fotoprintImpresa en cartulina mate. Un border fino de foil la enmarca bien. El foil sobre los detalles de una foto tiende a verse ruidoso.

Colores de foil: gold (clásico, cálido), silver (invierno, bodas, paletas frías), rose (romance), copper (otoño, rústico), pink (juguetón), holo (holográfico, cumpleaños). Combínalo con la paleta de la imagen y la ocasión.

Verifica el foil con foil_preview.py antes de construir (una vez que los datos de la tarjeta estén escritos, paso 5). Lo que pretendías que fuera foil debe salir sólido, y nada más debe atraparse. Dos cosas suelen necesitarlo:

  • Lo que quieres en foil comparte su color u oscuridad con cosas que no quieres, por ejemplo, letras doradas sobre flores con centros dorados. Limita el foil a un recuadro a su alrededor con foil.area.
  • El dorado estándar es pálido y clásico. El arte dibujado en un dorado mucho más intenso puede tener su propia tinta, para que el foil coincida.

La sección Foil de references/options.md tiene las tintas, qué hace amount en cada modo y area.

Papel (el interior, el reverso y los bordes): white, cream, blush, sage, sky, midnight o cualquier #rrggbb. Si la imagen está dibujada en papel liso, la tarjeta toma ese papel por defecto, que suele verse mejor.

La tarjeta se corta del centro de la imagen a su forma: portrait (5:7, el predeterminado), square, landscape (7:5) o original (la forma propia de la imagen, dentro de límites). Usa landscape para imágenes anchas. Si el sujeto está cerca de un borde, ejecuta grid.py para ver qué conserva el corte.

3. Añade efectos para la ocasión (opcional)

Estos no necesitan posiciones, así que agrégalos libremente cuando se adapten a la tarjeta:

  • snow: copos caen sobre la portada (invierno, Navidad)
  • hearts: pequeños corazones pintados flotan de vez en cuando sobre la imagen (amor, San Valentín, Día de la Madre, bodas)
  • fireflies: luces suaves vagan por la parte inferior (noches de verano, escenas soñadoras)
  • shootingStars: una estrella cruza la parte superior de vez en cuando (cielos nocturnos)
  • sparkle: puntos del foil atrapan la luz y brillan (cualquier tarjeta con foil)

Uno o dos efectos es suficiente; más resulta recargado.

4. Dale vida (opcional, y la mejor parte)

Una tarjeta puede hacer mucho más: la linterna en la imagen brilla, parpadea y destella al tocarla, el sol lanza rayos, la cola de un gato se mueve y salen corazones al acariciarlo, las ramas se balancean y dejan caer su nieve, las bufandas ondean con la brisa del puntero. Eso necesita posiciones en la imagen, que lees de la cuadrícula de grid.py. Lee references/living-cards.md y síguelo.

Hazlo cuando la persona pida que la tarjeta esté viva, animada o interactiva, o cuando la imagen tenga luces evidentes (velas, linternas, el sol, la luna, ventanas iluminadas) o personajes. Lleva un tiempo, así que para una tarjeta rápida ofrécelo como un siguiente paso.

5. Escribe los datos de la tarjeta

Guárdalos como JSON junto a la imagen. Una tarjeta:

{
  "title": "Feliz cumpleaños, Ellie",
  "image": "ellie-cumpleanos.jpg",
  "alt": "Una acuarela de un zorro en un prado de amapolas.",
  "name": "Zorro y Amapolas",
  "finish": "foil",
  "foil": { "colour": "rose", "on": "details", "amount": 0.12 },
  "paper": "cream",
  "message": "Querida Ellie,
Feliz cumpleaños a mi persona favorita.
¡Por tu mejor año hasta ahora!
Con cariño, Nora",
  "signature": ["Hecho con amor por", "Nora"],
  "effects": { "hearts": true, "sparkle": true }
}

alt describe la portada para lectores de pantalla; escríbelo siempre. name va en el reverso en letra pequeña a menos que back o signature diga lo contrario. Varias tarjetas van en "cards": [ {...}, {...} ], con title y page al principio. Cada ajuste está en references/options.md.

6. Constrúyelo

python scripts/make_card.py tarjeta.json --check      # verifica los datos, imprime el tamaño en píxeles de la tarjeta
python scripts/make_card.py tarjeta.json -o tarjeta.html

Las rutas en el JSON son relativas al archivo JSON. Para una tarjeta rápida también hay una forma de una línea:

python scripts/make_card.py --image portada.jpg --message "¡Feliz cumpleaños!" --finish foil --foil gold -o tarjeta.html

Si el script informa de un error, dice qué está mal y cómo solucionarlo. Las advertencias (un mensaje faltante, un ajuste que no conoce, una posición fuera de la tarjeta) aún construyen, pero corrígelas.

7. Verifícalo

Si Node y Playwright están disponibles, mira la tarjeta antes de entregarla:

node scripts/snapshot.mjs tarjeta.html capturas/
node scripts/snapshot.mjs tarjeta.html capturas/ --live   # una tarjeta que cobra vida: también verifica qué se mueve

Esto escribe la portada, la portada con la luz sostenida sobre ella (portada-iluminada: el foil o la pintura atrapando la luz), el interior y el reverso como PNG. Míralos: ¿es fácil de leer el mensaje?, ¿el foil se ve estampado en lugar de motear?, ¿la imagen está cortada donde esperabas? Ajusta y reconstruye; cada ronda es rápida. Sin un navegador, di claramente que no pudiste previsualizarla (la previsualización del foil sigue funcionando).

8. Entrégalo

Dale a la persona el archivo HTML y dile cómo usarlo:

  • Ábrelo en cualquier navegador para ver la tarjeta. Tócala (o presiona O) para abrirla; arrástrala hacia los lados (o presiona T) para darle la vuelta.
  • Para enviarla, ponla en línea y comparte el enlace: GitHub Pages, Netlify Drop o cualquier host estático acepta el archivo tal cual. O envía el archivo mismo; funciona sin conexión.
  • Tiene un tamaño de uno a dos megabytes, casi todo la imagen.

Menciona lo que elegiste (acabado, foil, papel, efectos) en una frase, para que puedan pedir cambios.

Bueno saber

  • Las fotos de teléfono se giran en la orientación correcta y las imágenes grandes se reducen (con Pillow). Las áreas transparentes se vuelven blancas. Las fotos HEIC necesitan convertirse a JPEG primero a menos que Pillow pueda leerlas.
  • La escritura a mano es Caveat, incrustada en la página. Cubre latín, latín extendido y cirílico; otros alfabetos (vietnamita, griego, CJK) recurren a la fuente de escritura a mano del dispositivo.
  • Sin WebGL, la página sigue mostrando la imagen y el mensaje, planas.
  • La página está diseñada con un tema claro por defecto: la tarjeta descansa sobre blanco con sombras suaves.
  • Para cambiar cómo se ven o se comportan las tarjetas más allá de estos ajustes, el código fuente del renderizador está en el repositorio de GitHub del skill (renderer/), y reconstruirlo reemplaza assets/greeting-card.js.

Skills relacionados