Communitygithub.com

coastdigitalgroup/coastai-skills

Projetar e implementar uma estrutura sistemática para cabeçalhos de nível de página que forneçam contexto, orientação e ações primárias para uma página ou visualização específica.

O que é coastai-skills?

Este skill fornece uma metodologia completa para projetar cabeçalhos de página (distintos do cabeçalho global do site), garantindo que os usuários possam se orientar, entender o status da visualização atual e acessar as principais ações sem procurar em menus. Ele é focado em sistemas de design para aplicações SaaS, dashboards, artigos extensos e páginas de configuração, onde o contexto e as ações são críticos. O skill cobre desde a definição de zonas (orientação, título, metadados e ações) até estratégias responsivas, comportamento de cabeçalho fixo e regras de acessibilidade, como uso de `<h1>` e `aria-label`. Suporta plataformas como Claude Code, Cursor e Codex, e se baseia em princípios de hierarquia visual e padrões de navegação para criar cabeçalhos funcionais e consistentes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/page-header-system

Perguntar na sua IA favorita

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

Documentação

Sistema de Cabeçalho de Página

Propósito

O Sistema de Cabeçalho de Página fornece uma metodologia para projetar a área estrutural de nível superior de uma página individual (distinta do cabeçalho global do site). Ele garante que os usuários possam identificar imediatamente onde estão (Orientação), entender o status ou metadados da visualização atual e acessar as ações primárias necessárias para concluir sua tarefa sem precisar procurar em menus.

Casos de Uso

  • Projetar cabeçalhos para visualizações de painéis complexos (ex.: "Detalhes do Projeto").
  • Estruturar a introdução de artigos longos ou páginas de documentação.
  • Organizar páginas de configurações ou perfil onde o contexto e as ações de salvamento são críticos.
  • Padronizar padrões de cabeçalho em uma aplicação SaaS ou em um grande site de conteúdo.
  • Gerenciar breadcrumbs, títulos e indicadores de status em um layout unificado.

Quando NÃO Usar

  • Navegação Global do Site: Use sistema-de-navegacao-site para o cabeçalho principal que persiste em todo o site.
  • Páginas de Destino Simples: Onde a seção "Hero" (consulte otimizacao-secao-hero) serve como cabeçalho da página.
  • Telas de Abertura / Modais: Onde o conteúdo é temporário ou mínimo; use sistema-de-overlay-e-dialogo para cabeçalhos modais.

Entradas

  1. Título e Hierarquia da Página: O nome principal da página (H1) e sua posição na estrutura do site.
  2. Requisitos de Orientação: O usuário precisa de breadcrumbs ou de um botão "Voltar"?
  3. Metadados e Status: Detalhes críticos como "Última Atualização", "Rascunho/Publicado" ou informações do proprietário.
  4. Prioridade de Ação: Qual é a tarefa principal nesta página? (ex.: Editar, Compartilhar, Criar).
  5. Tokens de Marca/Sistema: Espaçamento, tipografia e tokens de cor.

Saídas

  1. Especificação da Anatomia do Cabeçalho: Definição das zonas (Orientação, Título, Metadados, Ações).
  2. Blueprint de Layout: Regras para alinhamento (Esquerda vs. Centralizado) e espaçamento.
  3. Estratégia Responsiva: Como o cabeçalho se adapta do desktop para o mobile.
  4. Especificação de Interação: Comportamento de cabeçalhos fixos e prioridades dos botões de ação.

Fluxo de Trabalho

1. Definir o Caminho de Navegação (Orientação)

Determinar como o usuário chegou a esta página e como retornar:

  • Breadcrumbs: Use para hierarquias profundas (ex.: Início > Projetos > Design).
  • Botão Voltar: Use para tarefas lineares ou ao retornar a uma visualização de lista específica.
  • Link Pai: Um simples "<- Voltar para [Pai]" para profundidades de 2 níveis.

2. Estabelecer o Núcleo de Conteúdo (Título e Metadados)

Aplique sistema-de-hierarquia-visual ao centro do cabeçalho:

  • Título H1: O elemento de texto mais proeminente.
  • Metadados Contextuais: Informações secundárias (ex.: tags, timestamps, badges de status) colocadas próximas ao título.
  • Miniatura/Avatar: Se a página representa uma entidade específica (ex.: Perfil de Usuário ou Produto).

3. Organizar as Ações no Nível da Página

Divida as ações em níveis de prioridade:

  • Ação Primária: O único botão de "Nível 1" (geralmente um botão preenchido de alto contraste).
  • Ações Secundárias: Botões de "Nível 2" (estilos outline ou ghost) para tarefas menos frequentes.
  • Ações Terciárias: Menus overflow (...) para tarefas administrativas raras.

4. Escolher um Padrão Espacial

  • Alinhado à Esquerda Padrão (SaaS/Painel): Breadcrumbs/Título à esquerda, Ações à direita. Melhor para produtividade.
  • Centralizado (Conteúdo/Artigo): Todos os elementos centralizados. Melhor para legibilidade e narrativa.
  • Layout Dividido: Título e Ações separados por espaço em branco para enfatizar a separação.

5. Definir Comportamento de Fixação e Rolagem

  • Cabeçalho Fixo: Manter o cabeçalho da página visível se as ações (como "Salvar") forem necessárias com frequência durante a rolagem.
  • Cabeçalho Redutor: Reduzir a altura do cabeçalho ou ocultar breadcrumbs conforme o usuário rola para baixo para maximizar o espaço de conteúdo.

Regras de Decisão

  • A Regra do Breadcrumb: Se um site tiver mais de 2 níveis de profundidade, os breadcrumbs são obrigatórios no cabeçalho da página.
  • A Regra "Um H1": O cabeçalho da página DEVE conter a tag H1 única da página.
  • Alinhamento de Ações: No desktop, alinhe as ações primárias ao canto superior direito. No mobile, considere uma barra inferior fixa para ações primárias se o cabeçalho ficar muito cheio.
  • Visibilidade do Status: Status críticos (ex.: "Pagamento em Atraso") devem ser colocados imediatamente adjacentes ao título usando um badge ou ícone.

Restrições

  • Acessibilidade: Títulos de cabeçalho devem usar <h1>. Breadcrumbs devem usar <nav> com aria-label="Breadcrumb".
  • Contraste: Badges de status e ações devem atender aos requisitos de contraste WCAG AA. Botões de ação devem atender ao WCAG 2.2 SC 2.5.8 tamanho de alvo (mínimo 24x24px, 44x44px preferido em barras fixas mobile).
  • Responsividade: Cabeçalhos devem lidar graciosamente com títulos longos (truncamento vs. quebra de linha).

Padrões Comuns de Falha

  • A Sobrecarga de Ações: Colocar muitos botões no cabeçalho, confundindo a tarefa primária.
  • Orientação Ausente: Esquecer os breadcrumbs em páginas profundas, deixando os usuários se sentindo "perdidos".
  • Esmagamento do Título: Não permitir espaço suficiente para títulos longos no mobile, fazendo com que se sobreponham às ações.
  • Cabeçalho de Site Redundante: Fazer o cabeçalho da página parecer muito semelhante ao cabeçalho global do site, criando confusão visual.

Critérios de Validação

  • O cabeçalho contém um H1 claro que corresponde ao rótulo de navegação.
  • A orientação (breadcrumbs/voltar) é apropriada para a profundidade do site.
  • A ação primária é visualmente distinta das ações secundárias.
  • O layout permanece funcional e legível em viewports mobile.
  • HTML semântico é usado (<nav> para breadcrumbs, <h1> para título).
  • Indicadores de status (se houver) têm alto contraste e são fáceis de localizar.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas