Communitygithub.com

Geruyang/agent-skills-library

Projete superfícies de UI para jogos de navegador. Use quando o usuário solicitar HUDs, menus, sobreposições, layouts responsivos ou direção visual que proteja a área de jogo.

O que é agent-skills-library?

Esta skill é voltada para o design de interfaces de usuário (UI) que complementam jogos no navegador, com foco em proteger a área de jogo e melhorar a experiência do jogador. Ela é útil para desenvolvedores que desejam criar HUDs temáticas, menus, sobreposições e layouts responsivos, priorizando a legibilidade e a imersão. A skill suporta o desenvolvimento para desktop e mobile, com ênfase especial em jogos 3D, onde o gerenciamento da câmera e dos controles de entrada é crucial. Ela descreve padrões de design, como o uso de variáveis CSS para temas, hierarquia clara de informações e estratégias de revelação que mantêm a área de jogo livre de poluição visual. Além disso, fornece regras de animação parcimoniosas, exemplos de boas práticas e anti-padrões a evitar, garantindo que a UI pareça nativa do mundo do jogo e não um painel administrativo genérico.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Geruyang/agent-skills-library/tree/HEAD/original-skills/x-openai-game-ui-frontend-1cdc78a

Perguntar na sua IA favorita

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

Documentação

Game UI Frontend

Visão Geral

Use esta skill sempre que o jogo precisar de uma camada de interface visível. O objetivo não é produzir UI de dashboard genérica. O objetivo é produzir uma interface de jogo legível, temática e que suporte a experiência de jogo.

Suposição padrão: construa o mundo do jogo em canvas ou WebGL, e construa a UI com muito texto em DOM.

Padrões de Frontend

  1. Estabeleça direção visual antes de codificar.
    • Gênero e fantasia
    • Linguagem material
    • Tipografia
    • Paleta
    • Tom de movimento
  2. Use variáveis CSS para o tema da UI.
  3. Construa hierarquia clara.
    • Informações críticas de combate ou sobrevivência primeiro
    • Ferramentas secundárias em segundo lugar
    • Configurações raramente usadas atrás de menus ou gavetas
  4. Proteja a área de jogo primeiro, especialmente em 3D.
    • A tela inicial deve parecer jogável em poucos segundos.
    • Padrão: um cluster primário de HUD persistente e no máximo um pequeno cluster secundário.
    • Mantenha o centro da área de jogo livre durante o jogo normal.
    • Mantenha a parte central inferior da área de jogo principalmente livre durante o jogo normal.
    • Coloque lore, notas de campo, detalhes de missões e longas listas de controle atrás de gavetas, alternadores ou superfícies de pausa.
    • Prefira prompts contextuais e dicas transitórias em vez de painéis com caixas permanentes.
  5. Mantenha as sobreposições legíveis sobre movimento.
    • Use painéis de fundo, tratamento de borda, contraste e desfoque controlado onde necessário.
  6. Projete para desktop e mobile desde o início.
  7. Projete UI 3D em torno dos limites de câmera e controle de entrada.
    • Pause ou bloqueie a entrada de controle de câmera quando menus, diálogos ou UI baseada em ponteiro estiverem ativos.
    • Mantenha os estados de bloqueio de ponteiro, arrastar para olhar e interação com menus explícitos.

Padrões Iniciais para 3D

Para scaffolds iniciais de exploração, travessia ou terceira pessoa, prefira este orçamento de UI:

  • um chip de objetivo compacto ou faixa de status na borda
  • uma dica de controles transitória ou prompt de interação
  • uma superfície secundária opcional colapsável, como um diário, mapa ou registro de missões

Não abra todas as superfícies informativas no primeiro carregamento. A cena deve ser legível antes que o usuário abra qualquer UI mais profunda.

Como uma restrição de implementação padrão para jogos 3D no navegador:

  • nenhum layout sempre ativo de cabeçalho em largura total + corpo com vários cartões + rodapé em largura total
  • nenhuma sobreposição grande no centro da tela ou na parte central inferior durante o movimento normal
  • não mais do que aproximadamente 20-25% da janela de visualização coberta por HUD persistente no desktop, a menos que o usuário solicite explicitamente um layout mais denso
  • no mobile, colapse em uma pilha estreita ou chips contextuais antes de cobrir a área de jogo com painéis maiores

Regras de Prompt

Ao pedir ao modelo para projetar ou implementar UI de jogo, inclua:

  • a fantasia do jogo
  • a câmera ou ponto de vista
  • os verbos do jogador
  • as camadas de HUD
  • o modo de câmera ou controle quando o jogo é 3D
  • o tom de movimento
  • expectativas para desktop e mobile
  • estratégia de proteção e revelação da área de jogo
  • anti-padrões explícitos a evitar

Use ../../references/frontend-prompts.md para formatos concretos de prompt.

Regras de Movimento

  • Prefira algumas transições significativas em vez de micro-animação constante.
  • Reserve movimentos fortes para mudança de estado, recompensa, perigo e integração.
  • Respeite as configurações de movimento reduzido para animações não essenciais.
  • Evite que o movimento do HUD 3D entre em conflito com o movimento da câmera.

O que Parece Bom

  • Elementos de HUD são legíveis sem achatar a cena.
  • Menus parecem nativos do mundo do jogo, não como um painel administrativo de SaaS.
  • O layout se adapta perfeitamente entre pontos de interrupção.
  • Feedback de ponteiro, teclado e estado do jogo são óbvios.
  • Em jogos 3D, os estados de menu e HUD não competem com o controle da câmera ou bloqueio de ponteiro.
  • Em jogos 3D, a primeira visão jogável mantém a maior parte da janela de visualização disponível para movimento, mira e leitura espacial.
  • A densidade de informações persistentes é baixa o suficiente para que capturas de tela ainda pareçam cenas de jogo, não composições de UI.

Anti-Padrões

  • Layouts genéricos de dashboard de aplicativo
  • Estilo simples de espaço reservado sem tema
  • Pilhas de fontes padrão sem intenção
  • Sobreposições densas que obscurecem a área de jogo
  • Grandes cartões de título ou notas de vários parágrafos sobre uma cena jogável ao vivo
  • Painéis com caixas de peso igual distribuídos em cada borda da janela de visualização
  • Controles, objetivos, notas e lore todos expandidos ao mesmo tempo no primeiro carregamento
  • Chrome de topo e fundo em largura total com grandes painéis sempre ativos no centro ou corpo em jogos 3D
  • Movimento excessivo em cada elemento
  • UI apenas em canvas quando DOM seria mais claro e barato
  • Forçar controles de HUD para a cena 3D quando DOM padrão seria mais claro
  • Deixar a entrada da câmera ativa sob modais ou painéis de inventário

Referências

  • Arquitetura compartilhada: ../web-game-foundations/SKILL.md
  • Receitas de prompt: ../../references/frontend-prompts.md
  • Padrões de layout 3D com pouco chrome: ../../references/three-hud-layout-patterns.md
  • Contexto de UI 3D hospedada em React: ../react-three-fiber-game/SKILL.md
  • Revisão de playtest: ../../references/playtest-checklist.md

Individual skills in this repo

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

Geruyang/agent-skills-library

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

Geruyang/agent-skills-library

Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal styling

Geruyang/agent-skills-library

Use for new frontend applications, dashboards, games, creative websites, hero sections, and visually driven UI from scratch, or when the user explicitly asks for a redesign/restyle/modernization. Builds from clean, airy, high-taste, readable image-generated concept design with section-specific references, faithful implementation, and browser testing.

Geruyang/agent-skills-library

Use when testing, debugging, or making targeted improvements to rendered frontend apps through the Build Web Apps or web dev plugin: local dev servers, UI regressions, interaction bugs, console errors, responsive layout, and visual QA. Check whether the Browser plugin is available and use it first when it is; otherwise use regular Playwright with the recorded reason.

Geruyang/agent-skills-library

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

Geruyang/agent-skills-library

Guide for building, configuring, and deploying microfrontends on Vercel. Use this skill when the user mentions microfrontends, multi-zones, splitting an app across teams, independent deployments, cross-app routing, incremental migration, composing multiple frontends under one domain, microfrontends.json, @vercel/microfrontends, the microfrontends local proxy, or path-based routing between Vercel projects. Also use when the user asks about shared layouts across projects, navigation between microfrontends, fallback environments, asset prefixes, or feature flag controlled routing.

Geruyang/agent-skills-library

Next.js App Router expert guidance. Use when building, debugging, or architecting Next.js applications — routing, Server Components, Server Actions, Cache Components, layouts, middleware/proxy, data fetching, rendering strategies, and deployment on Vercel.

Geruyang/agent-skills-library

Use when sizing Public Equity Investing positions, finding equity hedges, or building an integrated position-and-hedge risk plan from a listed-equity thesis. Do not use for thesis construction, standalone event underwriting, trade execution, personal investment advice, or credit-instrument risk.

Geruyang/agent-skills-library

Integrate data visualizations into React and Next.js applications. Use when the user needs chart components, UML-like or architecture diagram components, React integration patterns, Next.js client or server boundaries, hydration-safe rendering, lazy loading, framework-aware performance, scroll-driven visual stories, or export guidance.

Geruyang/agent-skills-library

shadcn/ui expert guidance — CLI, component installation, composition patterns, custom registries, theming, Tailwind CSS integration, and high-quality interface design. Use when initializing shadcn, adding components, composing product UI, building custom registries, configuring themes, or troubleshooting component issues.

Geruyang/agent-skills-library

v0 by Vercel expert guidance. Use when discussing AI code generation, generating UI components from prompts, v0 CLI usage, v0 SDK/API integration, or integrating v0 into development workflows with GitHub and Vercel deployment.

Geruyang/agent-skills-library

Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", or "switch to --preset".

Habilidades Relacionadas