Communitygithub.com

baban9999ytr/agent-skills

Projete ou revise interfaces polidas e acessíveis inspiradas nas Diretrizes de Interface Humana da Apple. Use para UI web, nativa e responsiva de produtos; não copie interfaces ou ativos proprietários da Apple.

O que é agent-skills?

Esta skill capacita agentes de IA a projetar ou revisar interfaces digitais inspiradas nas Diretrizes de Interface Humana da Apple, mas adaptadas ao produto e plataforma específicos, sem copiar telas ou ativos proprietários da Apple. Ela é útil para desenvolvedores e designers que buscam criar UIs polidas, acessíveis e consistentes, seguindo princípios estéticos e de usabilidade reconhecidos. A skill suporta múltiplas plataformas de implementação, incluindo HTML/CSS, Vue com Tailwind, React com TypeScript, e oferece referências detalhadas para espaçamento, tipografia, cores, interação, motion e acessibilidade. O fluxo de trabalho inclui identificação da tarefa do usuário, estabelecimento de tokens semânticos, implementação de padrões apropriados e uma rigorosa revisão visual baseada em evidências, usando verificações repetíveis de qualidade visual e testes de acessibilidade, sem converter estética subjetiva em pontuações numéricas ou reivindicar certificações.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/baban9999ytr/agent-skills/tree/HEAD/skills/apple-design-expert

Perguntar na sua IA favorita

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

Documentação

Especialista em Design Apple

Use os princípios de design da Apple como um framework de decisão: propósito, agência, responsabilidade, familiaridade, flexibilidade, simplicidade, ofício e encanto. Adapte ao produto e plataforma em vez de reproduzir telas da Apple.

Fluxo de trabalho

  1. Identifique a tarefa principal do usuário, a plataforma, o sistema de componentes existente e as restrições responsivas.
  2. Estabeleça tokens semânticos antes de estilizar elementos avulsos. Leia espaçamento e layout, tipografia e cor ao criar um sistema.
  3. Implemente padrões adequados à plataforma, estados de interação completos e semântica acessível. Leia interação e movimento e acessibilidade para trabalhos interativos.
  4. Execute a revisão visual antes da conclusão. Revise layouts desktop e estreitos quando um ambiente renderizado estiver disponível. Use as verificações repetíveis em tests/visual-qa-checklist.md; capturas de tela e evidências do Playwright são observações, nunca uma certificação.

Limites inegociáveis

  • Não use logotipos da Apple, ativos de interface proprietários ou código-fonte. Use símbolos SF ou tipografia de sistema da Apple apenas quando a plataforma de destino e a licença permitirem.
  • Prefira semântica HTML, comportamento de teclado, foco visível, contraste suficiente e prefers-reduced-motion antes de adicionar polimento visual.
  • Evite ruídos visuais genéricos de IA: gradientes decorativos, sombras arbitrárias, vidro excessivo, grades densas de cartões, espaçamento inconsistente e animação sem propósito de interação.
  • Use o sistema de design existente quando presente. Novos tokens e componentes devem resolver uma necessidade repetida, não apenas fazer uma tela parecer diferente.

Rotas de implementação

  • Para HTML/CSS, leia padrões de componentes e o exemplo examples/html-css/.
  • Para Vue e Tailwind, use examples/vue-tailwind/ como padrão de marcação semântica, layout responsivo e estados de foco.
  • Para React e TypeScript, use examples/react/ como padrão; preserve as convenções do aplicativo host.
  • Para adaptação de plataforma e breakpoints, leia design responsivo. Para contexto de design nativo, leia filosofia de design.

QA visual baseada em evidências

Para uma interface executável, capture uma viewport larga (1440px) e estreita (390px), depois teste navegação apenas com teclado, foco visível, zoom/redimensionamento de texto, aparência clara e escura, estados de carregamento/erro/vazio e movimento reduzido. Registre a viewport, navegador, rota e observações concretas. Não converta estética subjetiva em uma pontuação numérica e não reivindique conformidade ou certificação.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas