hig-components-content

Visão geral do skill hig-components-content

O skill hig-components-content ajuda você a escolher e descrever componentes de exibição de conteúdo do Apple HIG com bem menos tentativa e erro. Ele é ideal para designers de UI, engenheiros de app e agentes de IA que precisam responder a perguntas práticas como se usar um chart, collection, image view, image well, color well, web view, activity view ou lockup em um app Apple. O objetivo real não é “resumir o HIG”, e sim transformar uma intenção inicial de conteúdo em uma escolha de componente que faça sentido nas plataformas Apple, nas expectativas de acessibilidade e no modelo de interação.

Para que este skill é bom

Use o skill hig-components-content quando a tarefa for apresentar conteúdo, não estruturar o layout. Ele é especialmente útil para decidir entre opções parecidas, como image view vs image well, ou collection vs table, e para verificar se um componente nativo do sistema já resolve melhor o problema do que uma UI customizada.

O que o torna diferente

Este skill se apoia nas Apple Human Interface Guidelines para componentes de conteúdo e faz links cruzados para orientações adjacentes quando necessário. Isso importa porque a escolha do componente muitas vezes depende de fundamentos como acessibilidade e tipografia, além de skills relacionados a padrões, contêineres de layout ou comportamento específico de plataforma.

Para quem ele é mais indicado

O guia hig-components-content é mais valioso quando você precisa de uma decisão que consiga sustentar: qual componente usar, quais restrições se aplicam e o que validar antes de implementar. Se você está criando uma interface para mídia, charts, compartilhamento, conteúdo web incorporado ou coleções selecionáveis, este skill encurta o caminho até uma direção alinhada ao ecossistema Apple.

Como usar o skill hig-components-content

Instale e carregue no contexto

Instale o skill hig-components-content com npx skills add raintree-technology/apple-hig-skills --skill hig-components-content. Depois, leia primeiro skills/hig-components-content/SKILL.md e em seguida os arquivos de referência vinculados que correspondem à sua dúvida sobre o componente. O repositório não depende de scripts, então as referências são a principal fonte de profundidade.

Comece com o formato certo de prompt

Para obter o melhor uso do hig-components-content, peça uma decisão de componente junto com as restrições, e não apenas um rótulo. Um bom prompt informa o tipo de conteúdo, a plataforma, a ação do usuário e se há edição, seleção, compartilhamento ou navegação incorporada envolvida.

Exemplo de prompt:
“Usando o skill hig-components-content, recomende o melhor componente do Apple HIG para um card de dashboard somente leitura mostrando a tendência semanal de vendas no iPad e no macOS. Inclua por que um chart faz sentido, quais necessidades de acessibilidade devem ser adicionadas e quando uma collection seria a escolha errada.”

Leia primeiro os arquivos de referência mais relevantes

Use as referências como atalho de decisão:

• references/charts.md para visualização de dados e escolhas de eixo/marca
• references/collections.md para grades, seleção de itens e conteúdo dinâmico
• references/image-views.md e references/image-wells.md para exibição vs edição de imagens
• references/color-wells.md para seleção de cor e adequação ao seletor de cores do sistema
• references/activity-views.md para fluxos de compartilhamento e ações
• references/lockups.md para cards, posters, monograms e apresentação agrupada
• references/web-views.md para conteúdo web incorporado

Dê ao skill as entradas que estão faltando

O skill funciona melhor quando você especifica:

• plataforma: iOS, iPadOS, macOS ou multiplataforma
• tipo de conteúdo: muito texto, visual, selecionável, editável ou conteúdo web externo
• interação: visualizar, escolher, editar, compartilhar, reordenar ou inspecionar
• restrições: acessibilidade, multitarefa, uso offline ou consistência com o sistema

Essas informações ajudam o skill hig-components-content a evitar conselhos genéricos e a escolher o componente que corresponde ao trabalho real a ser feito.

Perguntas frequentes sobre o skill hig-components-content

O hig-components-content é só para Apple UI Design?

Sim, ele é principalmente para decisões de UI Design alinhadas ao Apple HIG. O foco do hig-components-content para UI Design significa que ele é mais útil quando você quer que a escolha do componente siga as expectativas da plataforma Apple, e não uma resposta neutra de design system.

Quando não devo usar este skill?

Não use o hig-components-content quando o problema for principalmente navegação, estrutura de página ou layout geral. Se você estiver escolhendo contêineres, espaçamento ou a arquitetura mais ampla da tela, um skill de layout ou padrões costuma ser a melhor opção.

Um prompt basta sem o skill?

Às vezes, mas o skill hig-components-content é melhor quando você precisa de consistência e quer evitar restrições importantes passarem despercebidas. Um prompt genérico pode até nomear o componente certo, mas deixar de fora considerações essenciais da Apple, como acessibilidade, interações padrão ou quando o componente do sistema é a melhor opção por padrão.

Ele é amigável para iniciantes?

Sim, se você fizer perguntas concretas. O skill é mais fácil de usar quando você consegue descrever o conteúdo e a ação do usuário em uma única frase. Se a pergunta for vaga, a resposta tende a ser menos decisiva; por isso, o guia hig-components-content funciona melhor com um cenário de UI específico.

Como melhorar o skill hig-components-content

Peça uma decisão, não um tema

Os melhores resultados de instalação do hig-components-content vêm de prompts que pedem uma escolha de componente e o motivo dela. “Me mostre como exibir mídia” é mais fraco do que “Isso deve ser um image view, image well ou lockup para um card de produto selecionável no macOS?”

Inclua os trade-offs que importam para você

Se o seu projeto tiver restrições, diga isso logo de início: editável vs somente leitura, conteúdo nativo vs incorporado, dados densos vs esparsos, ou interação intensa vs visualização passiva. Isso permite que o skill hig-components-content foque nos casos de fronteira certos, em vez de apenas repetir boas práticas óbvias.

Evolua a partir da primeira recomendação

Se a primeira resposta estiver perto do ideal, mas ainda não for a certa, refine pedindo uma comparação mais estreita ou uma divisão por plataforma. Por exemplo, peça “somente iPadOS”, “somente macOS” ou “compare collection view vs table para linhas dominadas por texto”. Normalmente isso melhora mais a utilidade da próxima resposta do que pedir um nível maior de detalhe de forma genérica.

Fique atento aos erros mais comuns

Os erros mais comuns são escolher um componente customizado quando já existe um componente do sistema, usar collection demais para conteúdo textual ou tratar exibição de imagem e edição de imagem como se fossem o mesmo problema. O skill hig-components-content é mais forte quando você o usa para confirmar o encaixe e, depois, faz validações de acessibilidade e de plataforma antes de implementar.