CommunityImagengithub.com

Diseño de Tarjetas Sociales

Sistema completo para diseñar tarjetas de vista previa de enlaces e imágenes para compartir en redes sociales: tarjetas Open Graph y Twitter/X, vistas previas de enlaces para LinkedIn, Slack, Telegram, Discord y WeChat, cuadrados de Instagram, miniaturas de YouTube e imágenes destacadas para blogs y documentación.

¿Qué es Diseño de Tarjetas Sociales?

Este skill para agentes de IA proporciona un sistema integral y no negociable para diseñar tarjetas de vista previa de enlaces (social cards). Está pensado para usarse al crear, revisar o realizar briefing sobre cualquier imagen `og:image`, `twitter:image`, vista previa social o miniatura de video. El skill se estructura en tres partes: la **Parte A** define la superficie (tamaño y formato) y el mensaje principal de la tarjeta, guiando la selección entre cinco plantillas de diseño. La **Parte B** establece un sistema visual estricto con valores de token predefinidos para la paleta de colores (tema oscuro y claro), tipografía (escala de tipos con tamaños de punto de interrupción, pesos y kerning) y un layout basado en cuadrícula y zonas seguras. La **Parte C** cubre el comportamiento de recorte específico de cada plataforma, las metaetiquetas necesarias y la exportación a PNG determinista. El skill garantiza que una tarjeta y su página de aterrizaje se vean como una sola marca, reutilizando los tokens de paleta del skill `landing-page-design`. La regla fundamental es que una tarjeta solo debe comunicar un mensaje y superar la prueba de legibilidad a 400px de ancho.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/effiy/ai-design-skills/tree/HEAD/skills/social-card-design

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

¿Qué hace Diseño de Tarjetas Sociales?

Una tarjeta social no es un póster. Un póster se mira. Una tarjeta se hojea, a 400px de ancho, junto a otras nueve tarjetas compitiendo por el mismo pulgar:

una tarjeta → un mensaje → un clic.

Este skill tiene tres partes. La Parte A decide qué afirma la tarjeta y a qué superficie sirve. La Parte B es el sistema visual no negociable. La Parte C cubre el comportamiento de recorte de la plataforma, las metaetiquetas y la exportación. Trabaja con la Parte A antes de tocar la B o la C.

Alcance

Dentro del alcance. Cualquier imagen estática para compartir vinculada a una URL o canal: og:image, twitter:image, vistas previas de enlaces (X, LinkedIn, Slack, Telegram, Discord, WhatsApp, WeChat), publicaciones cuadradas de Instagram, miniaturas de YouTube, fondos de videollamadas, imágenes destacadas de blogs y documentación.

Fuera del alcance — posponer en lugar de improvisar.

  • Diseño de página, interfaz web, componentes, estructura de conversión → landing-page-design en este repositorio.
  • PNG de avatar de equipo → avatar-design en este repositorio.
  • Maquetación del cuerpo de artículos de WeChat y portadas de artículos producidas por el pipeline de 公众号 → gzh-design-skill. Este skill solo cubre la tarjeta de vista previa de enlace para una URL compartida en WeChat.
  • Presentaciones de diapositivas, diseño de logotipos y marcas gráficas, ilustración. Una tarjeta usa una marca existente; nunca diseña una.

Orden de resolución de conflictos. La solicitud explícita del usuario > este archivo > valor predeterminado de la herramienta. Cuando este archivo y landing-page-design no estén de acuerdo en un token compartido (escala tipográfica, paleta oscura), landing-page-design tiene prioridad para la interfaz web y este archivo tiene prioridad para el lienzo de la tarjeta. La paleta de la tarjeta a continuación reutiliza deliberadamente sus tokens para que una tarjeta y su página de aterrizaje parezcan una sola marca.


PARTE A — Superficie, mensaje, estructura

A1. Recopilación de información

Reúna estos datos antes de dibujar. Pregunte solo por lo que falte, y pregunte en un solo lote en lugar de una pregunta a la vez.

El mensaje

  • ¿Qué debería creer el lector después de medio segundo?
  • ¿Qué hay detrás del clic? (artículo, página de documentación, repositorio, producto, registro de cambios)

Ubicación

  • ¿Qué superficies? (X, LinkedIn, Slack, Telegram, Discord, WhatsApp, WeChat, Instagram, YouTube)
  • ¿La URL se compartirá principalmente en aplicaciones de chat o principalmente en feeds? Los despliegues de vista previa en chat recortan más.
  • ¿El sitio ya tiene un tema oscuro, un tema claro o ambos?

Marca y contenido

  • La marca: archivo SVG/PNG, o ninguna. ¿Marca denominativa? ¿Qué dominio imprimir?
  • Cadena del titular, subtítulo, estadística opcional, autor o cargo opcional.
  • Idioma(s): solo latino, CJK, RTL.

Restricciones

  • Cualquier número impreso en la tarjeta debe tener una fuente. Si no la tiene, no va en la tarjeta.
  • Límites de tamaño de archivo o formato impuestos por el destino (algunos clientes de chat rechazan imágenes grandes).

Si falta una respuesta, haga una suposición razonable, exprésela en una línea y continúe. No detenga la construcción.

A2. Selección de superficie

Elija una superficie por tarjeta. Nunca escale una tarjeta ancha a un cuadrado, y nunca reutilice una exportación en distintas superficies: las decisiones de recorte difieren.

SuperficieTamañoRelaciónSirve para
og1200 × 6301.91:1og:image, twitter:image (summary_large_image), vistas previas de enlaces de LinkedIn, Slack, Telegram, Discord, WhatsApp
square1080 × 10801:1Feed de Instagram, momentos de WeChat, ranuras de feed cuadrado, miniatura de vista previa de enlace de WeChat
cover1280 × 7201.78:1Miniatura de YouTube, fondo de videollamada, imagen destacada de documentación, diapositiva de título de presentación

El valor predeterminado es og. Es el único tamaño que acepta todo sistema de despliegue de vista previa. Envíe un compañero square siempre que la tarjeta se vaya a compartir en WeChat o Instagram.

Indique la superficie en su resultado. "Hice una tarjeta social" sin superficie no es entregable.

A3. El mensaje

La tarjeta lleva un solo mensaje. Todo lo demás en el lienzo existe para apoyarlo o para decir de dónde viene.

Titular

  • Una oración. Expresa la promesa, el resultado o la tensión, no el nombre de la sección.
  • ❌ "Introducción a nuestro sistema de diseño"
  • ✅ "Un sistema de diseño del que el agente no puede desviarse"
  • Minúsculas o mayúsculas estilo oración para latino. Sin punto final. Sin guiones dentro de la oración (reescriba la frase, misma regla que landing-page-design B1).
  • Límite de líneas: 2 líneas en og y cover, 3 líneas en square. Si no cabe al tamaño mínimo en B3, corte palabras. Nunca reduzca por debajo del mínimo.

Subtítulo (opcional, recomendado)

  • Máximo 4 palabras. Una categoría, no un eslogan: HABILIDADES DE IA, REGISTRO DE CAMBIOS, NOTAS DE CAMPO.
  • Latino: mayúsculas, con espaciado entre letras según B3. CJK: sin espaciado entre letras, sin concepto de mayúsculas.

Estadística (opcional, máximo una)

  • Un número más una etiqueta de máximo 4 palabras.
  • El número debe ser real, tener fuente y ser reproducible. Nunca una aproximación redondeada. Si necesita una advertencia, la advertencia va en og:image:alt, no en la tarjeta.

Pie de página

  • Solo el dominio, sin esquema ni ruta: effiy.cn, github.com/effiy.
  • Nunca una URL completa, nunca un parámetro de seguimiento, nunca un código QR a menos que el usuario lo solicite.

Texto alternativo

  • Obligatorio. El texto alternativo es lo que anuncian los lectores de pantalla y lo que varios sistemas de despliegue de vista previa imprimen como título.
  • Redáctelo como: subtítulo + titular, una oración. Incluya la estadística solo si está en la tarjeta.

Prueba de legibilidad a tamaño real Antes de exportar, vea la tarjeta a 400px de ancho. Si el subtítulo y el titular no son legibles a ese ancho, la tarjeta falla, independientemente de lo bien que se vea a tamaño completo. Esta es la única comprobación que detecta la mayoría de las tarjetas malas.

A4. Plantillas de diseño

Elija exactamente una plantilla y nómbrela en su resultado. Nunca combine dos plantillas en un lienzo.

PlantillaÚsela cuandoComposición
T1. DeclaraciónEl mensaje es fuerte y el producto es abstracto. Predeterminada.Solo texto: subtítulo, titular, pie de página, marca. Sin imágenes.
T2. DivididaHay una foto real del producto, captura de pantalla, diagrama o muestra de código que demuestre el mensaje.Texto en el 55–60% izquierdo, imagen en el 40–45% derecho (B6).
T3. EstadísticaUn número es el mensaje y el número está verificado.Número 2–3 veces el tamaño del titular como elemento visual, titular como su título.
T4. CitaUna línea de un usuario, mantenedor o documento es más persuasiva que su propia copia.La oración como titular, línea de atribución con nombre y cargo, sin decoración de comillas.
T5. AnuncioUn lanzamiento, publicación o incremento de versión, donde la fecha o la versión son el beneficio.Titular corto más un chip con fecha o cadena de versión en el espacio del subtítulo.

Si el mensaje necesita tres oraciones para aterrizar, la tarjeta es el formato incorrecto. Ponga el argumento en la página y deje que la tarjeta lleve el gancho.

A5. Orden de construcción

  1. Superficie (A2)
  2. Plantilla (A4)
  3. Titular, luego ajústelo a la zona de ajuste (B1, B3)
  4. Subtítulo, estadística, pie de página
  5. Marca (B5)
  6. Exportación (B7), luego realice la prueba de 400px
  7. Envíe las metaetiquetas (C2) y el texto alternativo

A6. Errores comunes

  • Texto que llena el lienzo de borde a borde. Las tarjetas respiran; el feed es ruidoso.
  • Un titular que en realidad es un título de página, por lo que no dice nada.
  • Dos mensajes compitiendo, por lo que ninguno se recuerda.
  • Un logotipo más grande que el mensaje, que convierte la tarjeta en una insignia.
  • Una tarjeta 1.91:1 metida en un espacio cuadrado, que recorta el titular.
  • Texto de tema claro en un gris apagado que mide menos de 4.5:1 (B2).
  • Una estadística inventada y redondeada. Los lectores verifican los números; un número falso desacredita toda la marca.
  • Un PNG con un canal alfa que se renderiza sobre un fondo negro mate en algunos sistemas de despliegue de vista previa (B7).

PARTE B — Sistema visual

Cada valor se resuelve a través de estas reglas. Nada se inventa ad hoc sobre el lienzo.

B1. Lienzo y cuadrícula

SuperficieLienzoMargen exteriorCaja de contenidoZona de marcaBanda de pie de página
og1200 × 63064px1072 × 502arriba a la izquierda, 48px de alto, dentro del margenabajo, 40px de alto
square1080 × 108080px920 × 920arriba a la izquierda, 56px de alto, dentro del margenabajo, 48px de alto
cover1280 × 72064px1152 × 592arriba a la izquierda, 48px de alto, dentro del margenabajo a la izquierda, 40px de alto

Cuadrícula. 12 columnas dentro de la caja de contenido, canalón de 24px. El texto se alinea a la columna 1. Las imágenes en T2 comienzan en la columna 8.

Alineación. Un borde de alineación por lienzo. Alineación a la izquierda predeterminada; centrado permitido solo para T4 (cita) y T3 (estadística), y entonces cada elemento está centrado, incluido el pie de página.

Ritmo vertical. El bloque del cuerpo (subtítulo + titular + estadística opcional) está ópticamente centrado dentro de la caja de contenido, no en el centro del lienzo — la banda del pie de página eleva el verdadero centro. Se permiten desplazamientos de 0 a 16px para corregir el centro óptico; nada más grande.

Regla del pie de página. Una línea fina de 1px line se sitúa en el borde superior de la banda del pie de página (B4 permite exactamente una regla por lienzo), abarcando todo el ancho de la caja de contenido. La línea base del texto del pie de página se sitúa 6px por encima de la parte inferior de la caja de contenido, alineada a la izquierda con la columna 1, y su altura de mayúsculas despeja la regla en al menos 8px.

Zonas seguras.

  • Mantenga cada elemento crítico (marca, subtítulo, titular, pie de página) dentro de la caja de contenido. La interfaz de usuario de la plataforma superpone los bordes de una tarjeta.
  • Las tarjetas og compartidas en WeChat y algunos clientes de chat pueden recortarse al centro a 1:1. Si la tarjeta se va a compartir allí, mantenga el mensaje dentro de la caja 630 × 630 centrada, o envíe el compañero square en lugar de arriesgarse con el recorte.
  • cover utilizado como miniatura de YouTube: mantenga el mensaje fuera de la esquina inferior derecha de 120 × 60, donde se encuentra la insignia de duración.

Nunca

  • ❌ Deje que el texto o la marca toquen el borde del lienzo.
  • ❌ Use un tamaño de lienzo no listado anteriormente. No envíe 1200 × 628 o 1200 × 600.
  • ❌ Centre el bloque del cuerpo en el lienzo mientras existe un pie de página (parece pesado en la parte inferior).

B2. Paleta

Los tokens son el conjunto de superficie oscura de landing-page-design, para que una tarjeta y su página se lean como una sola marca. Cada valor a continuación se midió con la fórmula de luminancia relativa de WCAG; las relaciones son reproducibles.

Tema oscuro (predeterminado)

TokenHexUso
bg#181818Fondo del lienzo
bg-raised#1F1F1FChips, panel de estadísticas, placa de captura de pantalla
bg-inset#272727Panel anidado dentro de bg-raised
line#313131Reglas finas, bordes de captura de pantalla
ink#FFFFFFTitular
ink-muted#9B9B9BSubtítulo, pie de página, atribución
accentun color de marca≤ 10% del área del lienzo

Tema claro

TokenHexUso
bg#FFFFFFFondo del lienzo
bg-raised#F5F5F5Chips, panel
line#E5E5E5Reglas finas, bordes
ink#000000Titular
ink-muted#666666Subtítulo, pie de página, atribución

Contraste medido (luminancia relativa WCAG, sRGB)

Primer planoFondoRelaciónVeredicto
#FFFFFF#18181817.76:1Titular ✅
#FFFFFF#1F1F1F16.48:1Titular sobre panel ✅
#FFFFFF#27272714.94:1Titular sobre inserción ✅
#FFFFFF#31313113.01:1Titular sobre color de línea ✅
#FFFFFF#13120918.78:1Titular sobre negro cálido ✅
#9B9B9B#1818186.39:1Texto atenuado ✅ (≥ 4.5:1)
#9B9B9B#1312096.76:1Texto atenuado ✅
#000000#FFFFFF21.00:1Titular claro ✅
#666666#FFFFFF5.74:1Texto atenuado claro ✅
#9B9B9B#FFFFFF2.78:1Texto atenuado claro ❌ no usar

Reglas

  • Contraste del titular ≥ 7:1. Texto secundario ≥ 4.5:1. Si un token no lo alcanza, cambie el fondo, no el color del texto (la medición B2 anterior es la prueba de qué pares funcionan).
  • Exactamente un acento. Puede colorear el subtítulo, una regla, un chip o una palabra del titular, no los cuatro.
  • Acento ≤ 10% del área del lienzo. Una tarjeta que es mitad color de acento no tiene punto focal.

Nunca

  • ❌ Use un degradado como fondo. La única excepción es un degradado de velo sobre una fotografía a sangre completa (B6).
  • ❌ Use texto atenuado #9B9B9B sobre blanco. Mide 2.78:1 y falla.
  • ❌ Introduzca un valor hexadecimal que no esté en esta tabla o en la paleta propia de la marca, que debe registrarse en el archivo de especificaciones (C5).
  • ❌ Use #000000 puro como fondo oscuro: el borde de una interfaz de usuario oscura y el borde de la tarjeta desaparecen en fondos de listas de chat que también son negros.

B3. Tipografía

Tipo de letra. Un tipo de letra por tarjeta. Permitidos: Geist, Manrope, Poppins. Alternativa cuando no esté disponible: DejaVu Sans (se incluye con la mayoría de los sistemas Linux). Nunca Inter, Roboto, Arial, Open Sans o Helvetica. Nunca cursivas. Peso máximo en negrita (700); no 800/900/black.

CJK. Use la misma familia para latino y CJK donde la familia tenga un corte CJK. De lo contrario, configure CJK con Noto Sans CJK SC o WenQuanYi Zen Hei y mantenga las líneas latinas en la familia principal. Nunca deje que una fuente solo latina renderice CJK: el resultado son cuadrados de tofu, y el renderizador debe confirmar la cobertura antes de la exportación (C5).

Escala de tipos de tarjeta (px en el lienzo 1×, ajustado a pasos de Tailwind para que coincida con landing-page-design B1)

Rologsquarecover
Subtítulo20 (text-xl)24 (text-2xl)24 (text-2xl)
Titular72 (text-7xl), reducir a 60, mínimo 48 (text-5xl)96 (text-9xl), reducir a 72, mínimo 60 (text-6xl)72, reducir a 60, mínimo 48
Cuerpo / etiqueta de estadística24 (text-2xl)30 (text-3xl)24
Pie de página202424
Número de estadística (T3)144–192180–216144–192

Altura de línea. Titular 1.05 para una línea, 1.10 para dos, 1.15 para tres. Cuerpo y pie de página 1.40. Nunca ajuste la altura de línea más ajustada que la regla del titular para meter palabras — cambie el titular.

Espaciado entre letras. Subtítulo latino +0.08em, mayúsculas. Titular latino −0.02em a 60px y más, 0 por debajo de 60px. CJK siempre es 0; el tracking falso en CJK rompe la caja em. Escrituras no latinas y no CJK: 0.

Ajuste. El ancho del titular debe medir ≤ el ancho de la caja de contenido, medido por el renderizador en la fuente resuelta — no estimado a partir del recuento de caracteres. Ajuste automático, luego confirme por línea y por bloque. Si el bloque excede el límite de líneas en el tamaño mínimo, corte palabras (A3).

Saltos de línea. El latino se rompe vorazmente entre palabras. CJK se rompe equilibradamente: los caracteres se distribuyen uniformemente en el número de líneas que el texto necesita, porque un relleno CJK voraz deja huérfanos cortos como "计规则" en la línea dos. La puntuación de cierre (,。、)) se eleva para que ninguna línea comience con ella; las marcas de apertura ((【「) se arrastran hacia arriba para que ninguna línea termine con ellas. No se permiten guiones.

B4. Elementos decorativos

Reglas. Una regla por lienzo. La regla del pie de página (B1). Una regla de acento opcional, 2px × 48px, colocada a la izquierda del subtítulo en la plantilla T1, alineada con el borde izquierdo de la caja de contenido.

Chips. Caja de 24px de alto, relleno horizontal de 12px, radio de 4px, texto de subtítulo (B3) en bg-raised. Un chip por lienzo.

Marcos de captura de pantalla. 2px line, radio de 8px, sin sombra. La captura de pantalla se coloca dentro de este marco; el marco nunca es más grande que la imagen.

Iconos. Iconos simples de 20px (un trazo, 1.5px de grosor) en el color accent. No use bibliotecas de fuentes de iconos (FontAwesome, Material Icons). Si no puede dibujar el icono como SVG, no lo use.

Sombras Paralelas. No permitidas. Una tarjeta es plana.

B5. Marca

Ubicación. Esquina superior izquierda de la caja de contenido. Altura de la caja de la marca: 48px en og y cover, 56px en square. Relación de aspecto natural del logotipo mantenida; nunca estirada.

Marca denominativa. Cuando se use, conjunto completo de palabras: acme inc. — no una abreviatura o acrónimo a menos que el usuario lo especifique.

Sin marca si no hay archivo. Si no se proporciona un archivo de logotipo y no se puede encontrar, la tarjeta se envía sin él. No dibuje un marcador de posición de la marca.

B6. Imágenes

Fotografía a sangre completa. Solo en T2, ocupando las columnas 8 a 12. La imagen nunca se superpone al texto. Un degradado de velo (#181818 al 40% de opacidad) debe cubrir la imagen donde el texto queda sobre ella; el velo se desvanece hacia el lado derecho para que la imagen permanezca identificable. Las fotografías nunca se colocan en mosaico o patrón. Las fotografías a sangre completa nunca son el fondo de una tarjeta T1, T3, T4 o T5.

Diagramas y código. Se permiten diagramas monocromáticos y bloques de código. El bloque de código usa un color de fondo de #1F1F1F (bg-raised), una línea de #313131 y texto de #FFFFFF con fuente monoespaciada (tamaño 20px en og, 24px en square). Las imágenes rasterizadas de código son solo para demostraciones de producto existentes.

B7. Exportación

  • Formato: PNG. Sin capa alfa (canal alfa aplanado a blanco o bg, según el tema).
  • Tamaño: Tamaño exacto de la superficie de la tabla B1 — nunca redimensionado, nunca escalado. El renderizador debe generar píxeles para exactamente esas dimensiones.
  • Nombre de archivo: {slug}-{surface}.png — ejemplo: design-system-og.png.
  • Modo de color: sRGB. Sin perfil ICC incrustado. Sin metadatos EXIF.
  • Bit depth: 8 bits por canal.

Nunca

  • ❌ Exporte JPEG, WebP, SVG o PDF.
  • ❌ Incluya un canal alfa. El PNG debe ser opaco después de la exportación.
  • ❌ Genere una imagen más grande que 2 MB. Si el archivo supera los 2 MB, reduzca la complejidad de la imagen (elimine el degradado, reduzca la resolución de las fotos a 150 DPI en el lienzo de salida) — nunca reduzca la calidad de JPEG porque la salida es PNG, que no tiene un parámetro de calidad.

PARTE C — Metaetiquetas, comportamiento de la plataforma y especificaciones

C1. Comportamiento de recorte de la plataforma

Despliegues de vista previa de chat (Slack, Telegram, Discord, WhatsApp, WeChat)

  • La mayoría recorta la tarjeta og al centro a aproximadamente 1:1. Slack recorta a 512 × 512. Telegram recorta a 400 × 400. Discord recorta a 400 × 400.
  • Los bordes izquierdo y derecho de la tarjeta og se pierden en el recorte. El titular debe caber centrado dentro de un cuadrado de 630 × 630 desde el centro del lienzo og. Si el titular está a la izquierda (como en T2), envíe el compañero square.

YouTube

  • La insignia de duración (esquina inferior derecha, 120 × 60px) se superpone a la miniatura. No coloque nada crítico allí.

WeChat

  • Vista previa enlace: se recorta de la tarjeta og a un cuadrado de 300 × 300. El titular y el subtítulo deben estar dentro de la zona segura (B1), o envíe la tarjeta square.
  • Momentos de WeChat (朋友圈): usa la tarjeta square.

Instagram

  • Feed cuadrado: usa la tarjeta square. Sin recorte.

LinkedIn

  • Usa la tarjeta og. LinkedIn puede superponer el logotipo de la empresa en la parte inferior derecha; mantenga el texto del pie de página claro de los bordes (B1 ya aplica esto).

C2. Metaetiquetas

Incluya estas etiquetas en la <head> de la página de destino:

<meta property="og:title" content="Titular de página, no titular de tarjeta" />
<meta property="og:description" content="Descripción de página" />
<meta property="og:image" content="https://ejemplo.com/design-system-og.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:alt" content="Subtítulo: Un sistema de diseño del que el agente no puede desviarse" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:image" content="https://ejemplo.com/design-system-og.png" />
<meta name="twitter:image:alt" content="Subtítulo: Un sistema de diseño del que el agente no puede desviarse" />

Reglas

  • og:image:width y og:image:height son obligatorios. Sin ellos, algunos rastreadores (Facebook, LinkedIn) no renderizan la imagen.
  • og:image:alt y twitter:image:alt deben coincidir. Use el texto alternativo redactado en A3.
  • twitter:card debe ser summary_large_image para usar la imagen og. No use summary (imagen pequeña) a menos que la tarjeta og falle la prueba de 400px.
  • La URL de la imagen debe ser una URL absoluta, terminada en .png. Sin tokens de consulta, sin firmas de CDN.

C3. Pruebas

Antes de considerar completa una tarjeta:

  1. Prueba de 400px: vea el PNG exportado a 400px de ancho en un visor de imágenes. ¿Se lee el titular? ¿Se ve el subtítulo? Si no, reduzca la copia o aumente el tamaño del texto (B3).
  2. Prueba de recorte: cargue la tarjeta og en el Probador de Depuración para Compartir de Twitter (cards-dev.twitter.com/validator) y el Depurador para Compartir de Facebook (developers.facebook.com/tools/debug). Verifique que el titular no esté recortado.
  3. Prueba de chat: envíe la URL a un canal de Slack, un chat de Telegram y un chat de WhatsApp. Mire la vista previa. Si se pierde el titular, envíe una tarjeta square o rediseñe.

C4. Archivo de especificaciones

Cree un archivo de especificaciones de tarjeta llamado {slug}-card-spec.json en la raíz del proyecto:

{
  "card": {
    "slug": "design-system",
    "surface": "og",
    "template": "T1",
    "theme": "dark",
    "locale": "es",
    "headline": "Un sistema de diseño del que el agente no puede desviarse",
    "kicker": "HABILIDADES DE IA",
    "stat": null,
    "footer": "effiy.cn",
    "alt": "HABILIDADES DE IA: Un sistema de diseño del que el agente no puede desviarse"
  },
  "brand": {
    "mark": "effiy-logo.svg",
    "domain": "effiy.cn"
  },
  "palette": {
    "bg": "#181818",
    "accent": "#6C63FF",
    "source": "landing-page-design tokens"
  },
  "export": {
    "filename": "design-system-og.png",
    "format": "PNG",
    "width": 1200,
    "height": 630,
    "size_bytes": null
  }
}

El archivo de especificaciones es la fuente de verdad para el diseño. Si un revisor pregunta por qué se tomó una decisión, la respuesta está en este archivo y las reglas de SKILL.md.

C5. Renderizado

Requisitos del renderizador

  • Debe soportar renderizado de texto CJK con las fuentes enumeradas en B3. Si el texto contiene CJK y la fuente no tiene cobertura CJK, el renderizador debe retroceder a Noto Sans CJK SC o WenQuanYi Zen Hei para los glifos CJK y mantener la fuente primaria para el latino.
  • Debe soportar la escala de tipos de B3 y el espaciado de letras.
  • Debe generar PNG sin canal alfa.
  • Debe afirmar el tamaño de archivo antes de escribir: si el PNG supera los 2 MB, el renderizador debe notificar al agente, que luego debe reducir la complejidad (B7).

Banderas de compilación El renderizador acepta estas banderas (a través de CLI o configuración):

  • --surface og|square|cover
  • --theme dark|light
  • --template T1|T2|T3|T4|T5
  • --headline "..."
  • --kicker "..."
  • --stat "..."
  • --footer "..."
  • --mark path/to/logo.svg
  • --output path/to/output.png

Sin modo interactivo. El renderizador nunca solicita entrada. Toma todas las decisiones a través de banderas o del archivo de especificaciones (C4).


Apéndice: Mapas de atajos

Es importante llegar rápido de la pregunta a la tarjeta.

Solicitud del usuario → Elección de superficie

Si el usuario diceSuperficieRazón
"imagen para compartir", "vista previa", "og:image"ogEstándar universal
"miniatura de YouTube", "fondo de video"coverRelación de aspecto fija 16:9
"publicación de Instagram", "momento de WeChat"squareRelación 1:1
"Slack", "Telegram", "Discord", "WhatsApp", "LinkedIn"ogUsan 1.91:1 pero recortan
"WeChat"squareRecorte agresivo a cuadrado

Superficie → Plantilla

Si el usuario compartePlantilla
Un enlace a un artículo, página de documentación, página de productoT1 o T2
Un enlace a un changelog, versión, lanzamientoT5
Un enlace con una estadística clave en el título o descripciónT3
Un enlace a un testimonio, reseña, cita de documentaciónT4

Plantilla → Evaluación de imagen

SiEntonces
Existe una captura de pantalla, foto o diagrama que demuestre el mensajeT2
No hay imagen disponible, o la imagen es decorativaT1

Este es el skill SKILL.md completo y con todas las reglas para el diseño de tarjetas sociales. Todo el comportamiento del agente se deriva de este documento.

Skills relacionados