Communitygithub.com

Tantless/mine-mail

Habilidad de diseño anti-AI-slop para páginas desde cero, auditorías, rediseños y extracción de diseño desde URLs o capturas de pantalla.

¿Qué es mine-mail?

Hallmark es una habilidad de diseño para asistentes de codificación de IA que garantiza que las interfaces generadas se vean hechas, no generadas. Es una habilidad opinada y concisa que codifica un conjunto estricto de reglas basadas en el consenso del campo anti-AI-slop, incluyendo el skill de diseño frontend de Anthropic, el cookbook de Claude sobre estética frontend y el movimiento 'tactile rebellion' de 2026. La habilidad se diferencia al insistir en la variedad estructural, no solo visual: dos páginas para diferentes briefs no deben compartir la misma plantilla. Hallmark admite flujos predeterminados de diseño y verbos explícitos como `auditar`, `rediseñar` y `estudiar`, y cuenta con seis disciplinas transversales como la autocrítica previa a la emisión, el uso de contenido honesto sin fabricación, el uso de tokens bloqueados, la prohibición de cromo falso, la capacidad de respuesta móvil y la pureza tipográfica. También tiene un flujo específico para componentes que simplifica el proceso para elementos individuales. La habilidad está impulsada por Together AI.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Tantless/mine-mail/tree/HEAD/.agents/skills/hallmark

Preguntar en tu IA favorita

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

Documentación

Hallmark

Una habilidad de diseño para asistentes de codificación de IA. Hace que las IU que generan parezcan hechas, no generadas.

Hallmark es opinada, corta y aburrida a propósito. Codifica un conjunto estricto de reglas, extraídas del consenso del campo anti-AI-slop (el skill de diseño frontend de Anthropic, el cookbook de Claude sobre estética frontend y el movimiento "tactile rebellion" de 2026), y se niega a permitir que el modelo recurra a los valores predeterminados en los que todos los LLM fueron entrenados.

El diferenciador: Hallmark insiste en la variedad estructural, no solo en la variedad visual. Dos páginas de Hallmark para dos briefs diferentes no deberían compartir el mismo ritmo héroe → 3 características → CTA → pie de página. Deberían sentirse como sitios diferentes, no como cambios de color de la misma plantilla. Consulta references/structure.md.

Impulsado por Together AI.


Cómo usar esta habilidad

Hallmark tiene un comportamiento predeterminado y tres verbos explícitos.

InvocaciónQué hace
(predeterminado)El usuario te pidió diseñar o construir algo nuevo. Sigue el flujo de Diseño a continuación.
hallmark audit <objetivo>Lee el objetivo, evalúalo contra la lista de antipatrones y devuelve una lista priorizada de acciones. No edites.
hallmark redesign <objetivo> [--mood <nombre>]Toma el contenido y la intención del objetivo, luego rediseña la estructura visual dentro de los límites de implementación existentes a menos que el usuario confirme explícitamente una reconstrucción completa. Nuevo ritmo de sección, nueva colocación de encabezados, nueva voz de componente. Preserva las rutas existentes, la propiedad de los componentes, la intención del copia, la marca y la arquitectura de la información; reemplaza solo la capa visual/interactiva necesaria para el alcance solicitado.
`hallmark study <captura de pantallaURL>`

Si el usuario escribe algo que no se asigna claramente a audit, redesign o study, trátalo como predeterminado. Si el usuario adjunta una imagen o pega una URL sin un prefijo de verbo, pregunta: "¿Debo study (extraer el ADN), o debo tratarlo como referencia para una construcción nueva?"

Barra de seguridad de implementación. Hallmark es una habilidad de diseño, no una licencia para arrasar una base de código. En cualquier proyecto existente:

  • Nunca elimines archivos de producción, árboles de rutas, directorios de componentes o un sitio web antiguo a menos que el usuario solicite explícitamente la eliminación o apruebe un plan a nivel de archivo que enumere las eliminaciones.
  • Por defecto, realiza ediciones en el lugar de los archivos nombrados, o nuevos componentes/tokens aditivos que se conectan a través de la ruta existente. Si el rediseño requiere eliminar varios componentes, detente y pide confirmación primero.
  • Trata archivos PDF, archivos README, briefs .md, documentos, transcripciones y pitch decks como material de referencia. No los copies palabra por palabra en la página a menos que el usuario te diga explícitamente que uses ese texto textualmente.
  • Antes de editar, indica los archivos exactos que esperas modificar/crear/eliminar. Las eliminaciones requieren confirmación explícita.

El flujo de Diseño predeterminado siempre elige un tema. Por defecto, elige uno de los 20 temas nombrados — el catálogo — y rota entre ellos según la regla de diversificación. También hay una rama personalizada silenciosa que construye una paleta OKLCH única + emparejamiento de fuentes gratuitas para el brief; la ruta personalizada se activa solo cuando el brief lleva una señal de intención creativa (el usuario nombra un color de marca, nombra una vibra de múltiples atributos que el catálogo no puede manejar, o solicita explícitamente un tema personalizado). Para briefs simples, el usuario nunca ve las palabras "catálogo" o "personalizado" — el catálogo se ejecuta silenciosamente. Consulta el Paso 1 (detección de señal) y el Paso 2.6 (despacho); el protocolo vive en references/custom-theme.md.


Disciplinas que se aplican en cada verbo

Estas seis disciplinas no son específicas de un verbo. Se aplican al Diseño predeterminado, audit, redesign, study y al ámbito de componentes por igual. Se sitúan junto con la prueba de slop, no dentro de una rama de ella.

  1. Autocrítica previa a la emisión. Antes de devolver cualquier salida, evalúala del 1 al 5 en seis ejes — Filosofía, Jerarquía, Ejecución, Especificidad, Moderación, Variedad. Cualquier valor < 3 desencadena una pasada de revisión. Estampa las seis puntuaciones en la parte superior del artefacto (/* Hallmark · pre-emit critique: P5 H4 E5 S4 R5 V5 */). Consulta references/slop-test.md § Autocrítica previa a la emisión.

  2. Copia honesta — sin contenido fabricado. Si el usuario no proporcionó una métrica, no inventes una. Los diseños basados en estadísticas, filas de comparación y barras de prueba deben usar números reales, un marcador de posición (— más un bloque gris etiquetado, "métrica a confirmar"), o una macroestructura diferente. "+47 % de conversión", "confiado por 50,000+ equipos" y "10× más rápido" son slop en el momento en que se inventan. Misma regla para testimonios, logotipos y recuentos de casos de estudio. Consulta references/anti-patterns.md § Métricas inventadas y la puerta de prueba de slop 46.

  3. Tokens bloqueados — sin improvisación durante el renderizado. Una vez que se selecciona un tema en el Paso 2.6, cada declaración de color y font-family en el artefacto debe hacer referencia a un token nombrado (var(--color-accent), font-family: var(--font-display)). No se permiten valores OKLCH / hex / rgb() en línea, ni una declaración font-family: "Alguna Fuente" que omita el bloque de tokens. Si se necesita un valor que no existe como token, súbelo al bloque de tokens como una nueva variable nombrada y luego haz referencia a él. Consulta references/anti-patterns.md § Improvisación de tokens durante el renderizado y la puerta de prueba de slop 48.

  4. Cromo redibujado prohibido. Hallmark no debe construir barras de navegador falsas (píldora de URL + puntos de semáforo), marcos de teléfono falsos, ventanas de bloque de código falsas (barra de título simulada + puntos que envuelven un <pre>), o cromo IDE falso — el entorno del usuario ya proporciona cromo real. Usa capturas de pantalla reales envueltas en un <figure> (con como máximo un borde fino), u omite el cromo y deja que el contenido se sostenga por sí mismo. Consulta references/anti-patterns.md § Cromo de UI redibujado y la puerta de prueba de slop 47.

  5. Capacidad de respuesta móvil — cada emisión verificada a 320 / 375 / 414 / 768 px. La salida de Hallmark debe renderizarse perfectamente en los cuatro anchos. Los no negociables: sin desplazamiento horizontal + overflow-x: clip raíz tanto en html como en body, nunca hidden (puerta 34); sin texto de dos líneas en elementos cliqueables — botones, enlaces de navegación principales, enlaces de pie de página, migas de pan, CTAs (puerta 49); las pistas de cuadrícula que contienen imágenes usan minmax(0, 1fr), nunca 1fr simple (puerta 50); los encabezados de pantalla envuelven palabras largas mediante overflow-wrap: anywhere; min-width: 0 (puerta 51); los encabezados de sección colapsan a una columna en móvil en cada variante de tema (puerta 52); los patrones de pestañas de radio no saltan al desplazarse (puerta 53). Consulta references/responsive.md § Móvil — no negociable. Este es un piso duro, no una lista de deseos.

  6. Pureza tipográfica — sin encabezados en cursiva. Los encabezados y el texto de pantalla siempre son romanos (font-style: normal). Una palabra de énfasis en cursiva dentro de un encabezado por lo demás recto (Construido para <em>pensar</em>) es una de las señales de IA más confiables; también lo es una cara de pantalla completamente en cursiva en los encabezados. Transmite énfasis con peso, color de acento o un subrayado dibujado. La cursiva sobrevive solo como énfasis de cuerpo de texto dentro de párrafos en ejecución. Consulta references/anti-patterns.md § Encabezados en cursiva y la puerta de prueba de slop 38a.


Cuando el brief es un componente, no una página

Antes de ingresar al flujo de Diseño completo, verifica el alcance. Si se dispara alguna de estas señales, ejecuta el flujo de Alcance de Componente en su lugar — la mayoría de las solicitudes de desarrollo diarias tienen forma de componente, no de página, y el aparato a nivel de página (macroestructura, enriquecimiento de héroe, arquetipo de pie de página, memoria de proyecto) es incorrecto para ellas.

Señales de Alcance de Componente:

  • El brief nombra un solo elemento de UI: un botón · un input · una tarjeta · un modal · un menú desplegable · un tooltip · un select · un checkbox · un interruptor · una tira de pestañas · un chip · una insignia · un banner · un snackbar · un popover · un slider · un selector de fecha · un avatar.
  • El brief es corto (≤ 30 palabras) y se refiere a un elemento.
  • El archivo objetivo es un solo componente (ej., ./Button.tsx, ./components/Input.css, app/components/Card.vue).
  • El usuario dice explícitamente "solo la X", "solo la Y", "este único elemento", "un solo ___".

Si se disparan dos señales, dirige a componente. Si solo se dispara el flujo de página (brief de múltiples secciones, "construye una página de inicio"), permanece en el flujo de Diseño.

Qué mantiene el Alcance de Componente del flujo de página

  • Paso 0 · Escaneo prevuelo — igual. Lee los tokens existentes, fuentes, framework, postura de microinteracción. Un botón en un proyecto de Tailwind con cuerpo Geist debe adoptar esos tokens, no inventar otros nuevos.
  • Paso 1 · Detección de género — igual. Editorial / minimalista moderno / atmosférico / lúdico. El componente hereda el género de su entorno (por defecto editorial cuando se desconoce).
  • Paso 2.6 · Ruta de tema — igual. Si existe un tokens.css o design.md, el componente usa esos tokens. De lo contrario, pregunta "¿hay un sistema a seguir, o debo elegir uno?" — por defecto catálogo si el usuario está en silencio.
  • Disciplina de 2+1 fuentes — igual.
  • Disciplina de estados — MÁS ESTRICTA. Cada componente interactivo DEBE incluir código para los 8 estados: predeterminado · hover · :focus-visible · :active · deshabilitado · carga · error · éxito. La lista de verificación de 8 estados en interaction-and-states.md es obligatoria, no opcional.
  • Prueba de slop — subconjunto solo universal. Ejecuta las puertas visual / microinteracción / contraste (puertas 40–41) / a11y / tipografía. Omite las puertas de diversificación (sin entrada de .hallmark/log.json — los componentes no rotan) y omite las puertas de seguridad de diseño que asumen una página completa.

Qué omite el Alcance de Componente

  • Paso 2 · Selección de macroestructura. Los componentes no tienen macroestructuras. Declara esto explícitamente: "Alcance de componente: omitiendo macroestructura."
  • Selección de arquetipos de navegación y pie de página. N1–N9 y Ft1–Ft8 son solo para alcance de página. Un componente es un elemento; no tiene navegación, ni pie de página. Omite ambos.
  • Patrones de pulido de héroe (HP1–HP4). Solo para alcance de página. Un botón o tarjeta no tiene héroe.
  • Paso 4 · Enriquecimiento. Sin ilustración de héroe, sin video de demostración, sin fondo abstracto. El componente ES el artefacto.
  • Paso 5 · Vista previa de múltiples secciones. Reemplazada por el envoltorio de demostración de 8 estados (a continuación).
  • Anexo de memoria de proyecto. Sin entrada de .hallmark/log.json para ejecuciones de componentes. La regla de diversificación no se aplica.

Qué emite el Alcance de Componente

Dos archivos, lado a lado:

  1. El artefacto del componente — un solo archivo autocontenido que coincida con las convenciones del proyecto:

    • React / Vue / Svelte: Button.tsx / Button.vue / Button.svelte
    • Web simple: button.css + button.html
    • Tailwind: un .tsx con cadenas className Y un tokens.css si falta
    • El componente consume los tokens de Hallmark por nombre (var(--color-accent)), nunca incluye valores OKLCH en línea.
  2. Un envoltorio de demostración de 8 estados — <NombreComponente>.preview.html (o .preview.tsx). Una pequeña página independiente que renderiza el componente en los 8 estados apilados verticalmente, cada uno etiquetado. El usuario lo abre una vez, ve el componente funcionando, luego lo elimina. El envoltorio no es parte del código de producción. Formato:

    ┌──── Botón — 8 estados ────────────────────────┐
    │                                                │
    │ predeterminado [ Haga clic en mí          ]    │
    │ hover         [ Haga clic en mí          ]    │  ← .is-hover fuerza el estilo :hover
    │ foco          [ Haga clic en mí          ]    │  ← .is-focus fuerza :focus-visible
    │ activo        [ Haga clic en mí          ]    │  ← .is-active fuerza :active
    │ deshabilitado  [ Haga clic en mí          ]    │  ← atributo disabled
    │ carga         [ ⌛ Trabajando…            ]    │  ← data-state="loading"
    │ error         [ ⚠ Intente de nuevo       ]    │  ← data-state="error"
    │ éxito         [ ✓ Guardado               ]    │  ← data-state="success"
    │                                                │
    └────────────────────────────────────────────────┘
    

    Cada fila etiquetada usa una clase (ej. .is-hover) a la que el CSS del componente apunta además de la pseudoclase real, para que los 8 estados se rendericen a la vez en la página de demostración. Ejemplo:

    .btn:hover, .btn.is-hover { background: var(--color-paper-3); }
    .btn:focus-visible, .btn.is-focus { outline: 2px solid var(--color-focus); }
    .btn:active, .btn.is-active { transform: translateY(1px); }
    

Formato de estampa para salida de componente

Los componentes se estampan de manera diferente a las páginas:

/* Hallmark · componente: <tipo> · género: <género> · tema: <tema>
 * estados: predeterminado · hover · foco · activo · deshabilitado · carga · error · éxito
 * contraste: pasa (46–50)
 */

El prefijo componente: les dice a futuras ejecuciones de Hallmark que este artefacto tiene alcance de componente y no debería desencadenar la diversificación a nivel de página.

Skills relacionados