¿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-designen este repositorio. - PNG de avatar de equipo →
avatar-designen 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.
| Superficie | Tamaño | Relación | Sirve para |
|---|---|---|---|
og | 1200 × 630 | 1.91:1 | og:image, twitter:image (summary_large_image), vistas previas de enlaces de LinkedIn, Slack, Telegram, Discord, WhatsApp |
square | 1080 × 1080 | 1:1 | Feed de Instagram, momentos de WeChat, ranuras de feed cuadrado, miniatura de vista previa de enlace de WeChat |
cover | 1280 × 720 | 1.78:1 | Miniatura 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-designB1). - Límite de líneas: 2 líneas en
ogycover, 3 líneas ensquare. 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 cuando | Composición |
|---|---|---|
| T1. Declaración | El mensaje es fuerte y el producto es abstracto. Predeterminada. | Solo texto: subtítulo, titular, pie de página, marca. Sin imágenes. |
| T2. Dividida | Hay 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ística | Un 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. Cita | Una 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. Anuncio | Un 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
- Superficie (A2)
- Plantilla (A4)
- Titular, luego ajústelo a la zona de ajuste (B1, B3)
- Subtítulo, estadística, pie de página
- Marca (B5)
- Exportación (B7), luego realice la prueba de 400px
- 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
| Superficie | Lienzo | Margen exterior | Caja de contenido | Zona de marca | Banda de pie de página |
|---|---|---|---|---|---|
og | 1200 × 630 | 64px | 1072 × 502 | arriba a la izquierda, 48px de alto, dentro del margen | abajo, 40px de alto |
square | 1080 × 1080 | 80px | 920 × 920 | arriba a la izquierda, 56px de alto, dentro del margen | abajo, 48px de alto |
cover | 1280 × 720 | 64px | 1152 × 592 | arriba a la izquierda, 48px de alto, dentro del margen | abajo 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
ogcompartidas 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ñerosquareen lugar de arriesgarse con el recorte. coverutilizado 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)
| Token | Hex | Uso |
|---|---|---|
bg | #181818 | Fondo del lienzo |
bg-raised | #1F1F1F | Chips, panel de estadísticas, placa de captura de pantalla |
bg-inset | #272727 | Panel anidado dentro de bg-raised |
line | #313131 | Reglas finas, bordes de captura de pantalla |
ink | #FFFFFF | Titular |
ink-muted | #9B9B9B | Subtítulo, pie de página, atribución |
accent | un color de marca | ≤ 10% del área del lienzo |
Tema claro
| Token | Hex | Uso |
|---|---|---|
bg | #FFFFFF | Fondo del lienzo |
bg-raised | #F5F5F5 | Chips, panel |
line | #E5E5E5 | Reglas finas, bordes |
ink | #000000 | Titular |
ink-muted | #666666 | Subtítulo, pie de página, atribución |
Contraste medido (luminancia relativa WCAG, sRGB)
| Primer plano | Fondo | Relación | Veredicto |
|---|---|---|---|
#FFFFFF | #181818 | 17.76:1 | Titular ✅ |
#FFFFFF | #1F1F1F | 16.48:1 | Titular sobre panel ✅ |
#FFFFFF | #272727 | 14.94:1 | Titular sobre inserción ✅ |
#FFFFFF | #313131 | 13.01:1 | Titular sobre color de línea ✅ |
#FFFFFF | #131209 | 18.78:1 | Titular sobre negro cálido ✅ |
#9B9B9B | #181818 | 6.39:1 | Texto atenuado ✅ (≥ 4.5:1) |
#9B9B9B | #131209 | 6.76:1 | Texto atenuado ✅ |
#000000 | #FFFFFF | 21.00:1 | Titular claro ✅ |
#666666 | #FFFFFF | 5.74:1 | Texto atenuado claro ✅ |
#9B9B9B | #FFFFFF | 2.78:1 | Texto 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
#9B9B9Bsobre 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
#000000puro 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)
| Rol | og | square | cover |
|---|---|---|---|
| Subtítulo | 20 (text-xl) | 24 (text-2xl) | 24 (text-2xl) |
| Titular | 72 (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ística | 24 (text-2xl) | 30 (text-3xl) | 24 |
| Pie de página | 20 | 24 | 24 |
| Número de estadística (T3) | 144–192 | 180–216 | 144–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
ogal 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
ogse pierden en el recorte. El titular debe caber centrado dentro de un cuadrado de 630 × 630 desde el centro del lienzoog. Si el titular está a la izquierda (como en T2), envíe el compañerosquare.
YouTube
- La insignia de duración (esquina inferior derecha, 120 × 60px) se superpone a la miniatura. No coloque nada crítico allí.
- Vista previa enlace: se recorta de la tarjeta
oga un cuadrado de 300 × 300. El titular y el subtítulo deben estar dentro de la zona segura (B1), o envíe la tarjetasquare. - Momentos de WeChat (朋友圈): usa la tarjeta
square.
- Feed cuadrado: usa la tarjeta
square. Sin recorte.
- 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:widthyog:image:heightson obligatorios. Sin ellos, algunos rastreadores (Facebook, LinkedIn) no renderizan la imagen.og:image:altytwitter:image:altdeben coincidir. Use el texto alternativo redactado en A3.twitter:carddebe sersummary_large_imagepara usar la imagenog. No usesummary(imagen pequeña) a menos que la tarjetaogfalle 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:
- 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).
- Prueba de recorte: cargue la tarjeta
ogen 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. - 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
squareo 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 SCoWenQuanYi Zen Heipara 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 dice | Superficie | Razón |
|---|---|---|
| "imagen para compartir", "vista previa", "og:image" | og | Estándar universal |
| "miniatura de YouTube", "fondo de video" | cover | Relación de aspecto fija 16:9 |
| "publicación de Instagram", "momento de WeChat" | square | Relación 1:1 |
| "Slack", "Telegram", "Discord", "WhatsApp", "LinkedIn" | og | Usan 1.91:1 pero recortan |
| "WeChat" | square | Recorte agresivo a cuadrado |
Superficie → Plantilla
| Si el usuario comparte | Plantilla |
|---|---|
| Un enlace a un artículo, página de documentación, página de producto | T1 o T2 |
| Un enlace a un changelog, versión, lanzamiento | T5 |
| Un enlace con una estadística clave en el título o descripción | T3 |
| Un enlace a un testimonio, reseña, cita de documentación | T4 |
Plantilla → Evaluación de imagen
| Si | Entonces |
|---|---|
| Existe una captura de pantalla, foto o diagrama que demuestre el mensaje | T2 |
| No hay imagen disponible, o la imagen es decorativa | T1 |
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.