Communitygithub.com

Tantless/mine-mail

Habilidade de design anti-AI-slop para páginas do zero, auditorias, redesigns e extração de design a partir de URLs ou capturas de tela. Use quando o usuário pedir para construir um novo aplicativo ou página de destino, quiser redesenhar algo, invocar Hallmark pelo nome ou usar auditoria/redesign/estudo.

O que é mine-mail?

O Hallmark é uma habilidade de design especializada para assistentes de codificação de IA, como Claude Code, Cursor ou Codex, projetada para fazer com que as interfaces de usuário geradas pareçam feitas por humanos, e não geradas por IA. Ele aplica um conjunto rigoroso de regras com base no consenso do campo anti-AI-slop, incluindo as habilidades de design de front-end da Anthropic, o livro de receitas Claude sobre estética de front-end e o movimento 'tátil de rebelião' de 2026. O diferencial do Hallmark é sua insistência em variedade estrutural: duas páginas para briefings diferentes não devem compartilhar o mesmo ritmo de seção, garantindo que pareçam sites distintos e não variações de cor do mesmo modelo. A habilidade oferece comandos como 'audit' (auditar), 'redesign' (redesenhar) e 'study' (estudar) para analisar capturas de tela ou URLs, extrair o 'DNA' do design e reconstruir o conteúdo do usuário com uma nova identidade visual. Ele funciona como uma habilidade de design que se integra a várias plataformas de codificação de IA, fornecendo diretrizes para evitar padrões comuns de IA, como métricas inventadas, improvisação de tokens durante a renderização e cromo de navegador falso. A habilidade também inclui disciplinas como auto-crítica pré-emissão, honestidade no conteúdo, tokenização de estilos, responsividade móvel em quatro larguras e pureza tipográfica.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Hallmark

Uma habilidade de design para assistentes de codificação de IA. Faz com que as UIs que eles geram pareçam feitas, não geradas.

Hallmark é opinativo, curto e chato de propósito. Ele codifica um conjunto restrito de regras — extraídas do consenso do campo de design anti-AI-slop (habilidade de design de front-end da Anthropic, o livro de receitas Claude sobre estética de front-end e o movimento 'tátil de rebelião' de 2026) — e se recusa a deixar o modelo cair nos padrões nos quais todo LLM foi treinado.

O diferencial: o Hallmark insiste em variedade estrutural, não apenas variedade visual. Duas páginas do Hallmark para dois briefings diferentes não devem compartilhar o mesmo ritmo herói → 3 recursos → CTA → rodapé. Elas devem parecer sites diferentes, não apenas trocas de cores do mesmo modelo. Consulte references/structure.md.

Desenvolvido por Together AI.


Como usar esta habilidade

O Hallmark tem um comportamento padrão e três verbos explícitos.

InvocaçãoO que faz
(padrão)O usuário pediu para você projetar ou construir algo novo. Siga o Fluxo de Design abaixo.
hallmark audit <alvo>Leia o alvo, pontue-o contra a lista de antipadrões, retorne uma lista priorizada de itens a corrigir. Não edite.
hallmark redesign <alvo> [--mood <nome>]Pegue o conteúdo e a intenção do alvo, depois redesenhe a estrutura visual dentro dos limites de implementação existentes, a menos que o usuário confirme explicitamente uma reconstrução completa. Novo ritmo de seção, novo posicionamento de títulos, nova voz de componente. Preserve as rotas existentes, a propriedade dos componentes, a intenção da cópia, a marca e a arquitetura da informação; substitua apenas a camada visual/de interação necessária para o escopo solicitado.
`hallmark study <captura de telaURL>`

Se o usuário digitar algo que não corresponda claramente a audit, redesign ou study, trate como padrão. Se o usuário anexar uma imagem ou colar uma URL sem um prefixo de verbo, pergunte: 'Devo study (estudar) isso (extrair o DNA) ou devo tratar como referência para uma nova construção?'

Trilho de segurança de implementação. Hallmark é uma habilidade de design, não uma licença para arrasar uma base de código. Em qualquer projeto existente:

  • Nunca exclua arquivos de produção, árvores de rotas, diretórios de componentes ou um site antigo, a menos que o usuário solicite explicitamente a exclusão ou aprove um plano no nível do arquivo que liste as exclusões.
  • Padrão para edições in loco dos arquivos nomeados, ou componentes/ tokens aditivos que sejam conectados através da rota existente. Se o redesenho exigir a remoção de vários componentes, pare e peça confirmação primeiro.
  • Trate PDFs, arquivos README, briefings .md, documentos, transcrições e baralhos de pitch como material de referência. Não os copie palavra por palavra para a página, a menos que o usuário diga explicitamente para usar esse texto literalmente.
  • Antes de editar, declare os arquivos exatos que você espera modificar/criar/excluir. Exclusões exigem confirmação explícita.

O Fluxo de Design padrão sempre escolhe um tema. Por padrão, escolhe um dos 20 temas nomeados — o catálogo — e alterna entre eles de acordo com a regra de diversificação. Há também um ramo personalizado silencioso que constrói uma paleta OKLCH única + pareamento de fontes gratuitas para o briefing; a rota personalizada é acionada apenas quando o briefing carrega um sinal de intenção criativa (o usuário nomeia uma cor da marca, nomeia um clima de múltiplos atributos que o catálogo não pode carregar, ou solicita explicitamente um tema personalizado). Para briefings comuns, o usuário nunca vê as palavras 'catálogo' ou 'personalizado' — o catálogo é executado silenciosamente. Consulte a Etapa 1 (detecção de sinal) e a Etapa 2.6 (despacho); o protocolo vive em references/custom-theme.md.


Disciplinas que valem para todos os verbos

Estas seis disciplinas não são específicas de verbos. Elas se aplicam ao Design padrão, audit, redesign, study e escopo de componente igualmente. Elas ficam ao lado do teste slop, não dentro de um ramo dele.

  1. Autocrítica pré-emissão. Antes de entregar qualquer saída, pontue-a de 1 a 5 em seis eixos — Filosofia, Hierarquia, Execução, Especificidade, Restrição, Variedade. Qualquer coisa < 3 dispara uma revisão. Carimbe as seis pontuações no topo do artefato (/* Hallmark · pré-emissão crítica: P5 H4 E5 S4 R5 V5 */). Consulte references/slop-test.md § Autocrítica pré-emissão.

  2. Cópia honesta — sem conteúdo fabricado. Se o usuário não forneceu uma métrica, não invente uma. Layouts liderados por estatísticas, linhas de comparação e barras de prova devem usar números reais, um espaço reservado ('—' mais um bloco cinza rotulado 'métrica a confirmar') ou uma macroestrutura diferente. '+47% de conversão', 'confiado por mais de 50.000 equipes' e '10× mais rápido' são slop no momento em que são inventados. Mesma regra para depoimentos, logotipos e contagens de estudos de caso. Consulte references/anti-patterns.md § Métricas inventadas e o portão 46 do teste slop.

  3. Tokens bloqueados — sem improvisação durante a renderização. Uma vez que um tema é selecionado na Etapa 2.6, toda cor e toda declaração font-family no artefato deve referenciar um token nomeado (var(--color-accent), font-family: var(--font-display)). Valores OKLCH / hex / rgb() em linha, ou uma declaração font-family: 'Alguma Fonte' que ignore o bloco de token, não são permitidos. Se um valor for necessário que não exista como token, eleve-o para o bloco de token como uma nova variável nomeada e, em seguida, referencie-o. Consulte references/anti-patterns.md § Improvisação de token durante a renderização e o portão 48 do teste slop.

  4. Cromo redesenhado proibido. O Hallmark não deve construir manualmente barras de navegador falsas (pílula de URL + pontos de semáforo), molduras de telefone falsas, janelas de bloco de código falsas (barra de título fictícia + pontos envolvendo um <pre>) ou cromo IDE falso — o ambiente do usuário já fornece cromo real. Use capturas de tela reais envolvidas em um <figure> (com no máximo uma borda fina) ou omita o cromo e deixe o conteúdo se sustentar sozinho. Consulte references/anti-patterns.md § Cromo de UI redesenhado e o portão 47 do teste slop.

  5. Responsividade móvel — cada emissão verificada em 320 / 375 / 414 / 768 px. A saída do Hallmark deve renderizar perfeitamente em todas as quatro larguras. Os itens não negociáveis: sem rolagem horizontal + raiz overflow-x: clip tanto em html quanto em body, nunca hidden (portão 34); sem texto clicável de duas linhas — botões, links de navegação primários, links de rodapé, breadcrumbs, CTAs (portão 49); trilhas de grade que contêm imagens usam minmax(0, 1fr), nunca 1fr simples (portão 50); cabeçalhos de exibição quebram palavras longas via overflow-wrap: anywhere; min-width: 0 (portão 51); cabeçalhos de seção colapsam para uma coluna no celular em todas as variantes de tema (portão 52); padrões de guia de rádio não saltam de rolagem (portão 53). Consulte references/responsive.md § Móvel — não negociável. Este é um piso duro, não uma lista de desejos.

  6. Pureza tipográfica — sem cabeçalhos em itálico. Títulos e tipos de exibição são sempre romanos (font-style: normal). Uma palavra de ênfase em itálico dentro de um título que de outra forma está na vertical ('Construído para pensar') é um dos sinais de IA mais confiáveis; o mesmo acontece com uma face de exibição totalmente em itálico nos títulos. Carregue a ênfase com peso, cor de destaque ou um sublinhado desenhado. O itálico sobrevive apenas como ênfase no corpo do texto dentro de parágrafos corridos. Consulte references/anti-patterns.md § Cabeçalhos em itálico e o portão 38a do teste slop.


Quando o briefing é um componente, não uma página

Antes de entrar no Fluxo de Design completo, verifique o escopo. Se algum destes itens for acionado, execute o fluxo de Escopo de Componente — a maioria das solicitações diárias de desenvolvimento são em forma de componente, não em forma de página, e o aparato no nível da página (macroestrutura, enriquecimento de herói, arquétipo de rodapé, memória de projeto) está errado para eles.

Sinais de Escopo de Componente:

  • O briefing nomeia um único elemento de UI: um botão · uma entrada · um cartão · um modal · um dropdown · uma dica de ferramenta · um select · uma caixa de seleção · um interruptor · uma faixa de guia · um chip · um emblema · um banner · uma snackbar · um popover · um controle deslizante · um seletor de data · um avatar.
  • O briefing é curto (≤ 30 palavras) e se refere a um elemento.
  • O arquivo alvo é um único componente (por exemplo, ./Button.tsx, ./components/Input.css, app/components/Card.vue).
  • O usuário diz explicitamente 'apenas o X', 'somente o Y', 'este único elemento', 'um único ___'.

Se dois sinais forem acionados, rota de componente. Se apenas o fluxo de página for acionado (briefing de várias seções, 'construa uma landing page para mim'), permaneça no Fluxo de Design.

O que o Escopo de Componente mantém do fluxo de página

  • Etapa 0 · Varredura de pré-voo — igual. Leia tokens existentes, fontes, framework, postura de microinteração. Um botão em um projeto Tailwind baseado em Geist deve adotar esses tokens, não inventar novos.
  • Etapa 1 · Detecção de gênero — igual. Editorial / minimalista moderno / atmosférico / lúdico. O componente herda o gênero de seu ambiente (padrão silencioso para editorial quando desconhecido).
  • Etapa 2.6 · Rota de tema — igual. Se um tokens.css ou design.md existir, o componente usa esses tokens. Caso contrário, pergunta 'existe um sistema a seguir ou devo escolher um?' — padronizando para catálogo se o usuário estiver em silêncio.
  • Disciplina de 2+1 fontes — igual.
  • Disciplina de estado — MAIS RIGOROSA. Cada componente interativo DEVE conter código para todos os 8 estados: normal · hover · :focus-visible · :active · desabilitado · carregando · erro · sucesso. A lista de verificação de 8 estados em interaction-and-states.md é obrigatória, não consultiva.
  • Teste slop — subconjunto universal apenas. Execute os portões de visual / microinteração / contraste (portões 40–41) / a11y / tipografia. Pule os portões de diversificação (sem entrada .hallmark/log.json — componentes não alternam) e pule os portões de segurança de layout que assumem uma página completa.

O que o Escopo de Componente pula

  • Etapa 2 · Escolha de macroestrutura. Componentes não têm macroestruturas. Declare isso explicitamente: 'Escopo de componente: pulando macroestrutura.'
  • Escolhas de arquétipo de navegação e rodapé. N1–N9 e Ft1–Ft8 são apenas para escopo de página. Um componente é um elemento; não tem navegação, não tem rodapé. Pule ambos.
  • Padrões de polimento de herói (HP1–HP4). Apenas para escopo de página. Um botão ou cartão não tem herói.
  • Etapa 4 · Enriquecimento. Sem ilustração de herói, sem vídeo de demonstração, sem fundo abstrato. O componente É o artefato.
  • Etapa 5 · Pré-visualização de várias seções. Substituído pelo wrapper de demonstração de 8 estados (abaixo).
  • Anexo de memória de projeto. Sem entrada .hallmark/log.json para execuções de componente. A regra de diversificação não se aplica.

O que o Escopo de Componente emite

Dois arquivos, lado a lado:

  1. O artefato do componente — um único arquivo autocontido que corresponde às convenções do projeto:

    • React / Vue / Svelte: Button.tsx / Button.vue / Button.svelte
    • Web simples: button.css + button.html
    • Tailwind: um .tsx com cadeias className E um tokens.css se ausente
    • O componente consome tokens Hallmark pelo nome (var(--color-accent)), nunca valores OKLCH em linha.
  2. Um wrapper de demonstração de 8 estados — <NomeDoComponente>.preview.html (ou .preview.tsx). Uma pequena página independente que renderiza o componente em todos os 8 estados empilhados verticalmente, cada um rotulado. O usuário abre uma vez, vê o componente funcionando e, em seguida, o exclui. O wrapper não faz parte do código de produção. Formato:

    ┌──── Botão — 8 estados ────────────────────────┐
    │                                                │
    │ normal        [ Clique aqui               ]    │
    │ hover         [ Clique aqui               ]    │  ← .is-hover força estilo :hover
    │ foco          [ Clique aqui               ]    │  ← .is-focus força :focus-visible
    │ ativo         [ Clique aqui               ]    │  ← .is-active força :active
    │ desabilitado  [ Clique aqui               ]    │  ← atributo disabled
    │ carregando    [ ⌛ Trabalhando…            ]    │  ← data-state="loading"
    │ erro          [ ⚠ Tente novamente          ]    │  ← data-state="error"
    │ sucesso       [ ✓ Salvo                   ]    │  ← data-state="success"
    │                                                │
    └────────────────────────────────────────────────┘
    

    Cada linha rotulada usa uma classe (por exemplo, .is-hover) que o CSS do componente visa além da pseudo-classe real, para que todos os 8 estados sejam renderizados de uma vez na página de demonstração. Exemplo:

    .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 carimbo para saída de componente

Componentes carimbam de forma diferente das páginas:

/* Hallmark · componente: <tipo> · gênero: <gênero> · tema: <tema>
 * estados: normal · hover · foco · ativo · desabilitado · carregando · erro · sucesso
 * contraste: passa (46–50)
 */

O prefixo componente: informa às execuções futuras do Hallmark que este artefato tem escopo de componente e não deve acionar diversificação no nível da página.

Habilidades Relacionadas