Communitygithub.com

building-layout-check

Verifica que um edifício, interior ou ambiente fechado (casas, escritórios, bunkers, navios, templos, ruínas, cavernas, complexos, estações) gerado ou construído manualmente seja estruturalmente sensato e adequadamente percorrível — caminhos de carga, paredes que começam e terminam em algo, portas que levam a algum lugar, escadas com patamares e pé-direito, sem salas órfãs, paredes em aberturas, saídas suficientes, becos sem saída rasos, loops e duas rotas de fuga onde as pessoas lutam ou fogem. Neutro em relação a engine e gênero; inclui um script de verificação de grafo espacial. Use ao revisar uma construção ou layout produzido por um agente ou gerador, antes de aceitar um prefab, ou ao escrever regras de layout para um kit.

O que é building-layout-check?

Esta skill oferece uma verificação sistemática em três passagens para garantir que edifícios, interiores e ambientes fechados gerados por agentes ou construídos manualmente sejam estruturalmente sensatos e adequadamente percorríveis, funcionando para qualquer cenário, período e estilo artístico. A primeira passagem usa um script de grafo espacial para analisar a conectividade dos espaços, saídas, becos sem saída, loops e rotas verticais com base em configurações como perfil de uso (exploração ou combate) e tipo de local (edifício, navio, ruína). A segunda passagem realiza sondas geométricas no motor ou ferramenta de modelagem para verificar suporte estrutural, extremidades de paredes, aberturas, folgas e sobreposições. A terceira passagem é uma revisão em altura dos olhos feita por um revisor humano ou agente crítico, garantindo que cada parede e sala tenha um propósito no contexto do mundo. A skill é neutra em relação a engine e gênero, suporta perfis configuráveis e regras desligáveis por ambiente, e é ideal para revisar layouts gerados por IA antes da aceitação final.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TayHD/game-agent-skills/tree/HEAD/skills/building-layout-check

Perguntar na sua IA favorita

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

Documentação

Verificação de layout de edifícios

Kits modulares facilitam colocar uma parede em qualquer lugar da grade, e geradores e agentes farão exatamente isso: paredes que terminam no meio de uma sala ou atravessam uma janela, portas que se abrem para uma parede vazia ou um vão, salas que ninguém consegue alcançar, escadas que chegam viradas para uma parede, caixas de uma porta e corredores que nunca ramificam. Esta skill é a verificação que os detecta. Ela julga layout e estrutura, não acabamento ou materiais.

Funciona para qualquer cenário, período e estilo artístico, porque julga cada espaço pela lógica do próprio mundo, escrita uma vez em um resumo do mundo (abaixo): uma torre de pedra pela forma como pedreiros constroem e uma guarnição vive, uma nave estelar pela forma como sua tripulação se move e o que seu casco carrega, uma caverna pela forma como a água a cortou e como seus habitantes a usam, uma vila de desenho animado pelas regras que seu estilo define. Códigos de construção modernos são apenas o padrão quando um projeto não diz nada.

Três passagens, em ordem, porque cada uma é mais barata que a próxima: o grafo espacial (um script, segundos), as sondas geométricas (no motor ou ferramenta de modelagem, minutos) e a revisão em altura dos olhos (uma pessoa ou um agente crítico novo). Um edifício passa quando nenhum bloqueio permanece em nenhuma passagem.

O resumo do mundo (escreva antes da primeira verificação)

Uma seção curta na documentação de ambiente do projeto, cerca de meia página, que toda verificação e todo revisor leem. Sem ele, os revisores recorrem à sua própria era e estilo e sinalizam as coisas erradas.

  1. Cenário e período: onde e quando (por exemplo "cidade ribeirinha medieval tardia", "estação de mineração orbital, anos 2300", "ruínas pós-inundação de um subúrbio dos anos 1970", "tocas de povo-cogumelo").
  2. Quem construiu, com o quê: a tecnologia e materiais dos construtores, e o que isso permite: vãos (madeira 4 a 6 m, abóbadas de pedra, treliças de aço, coral cultivado), espessura de parede, como os pisos são suportados, como o movimento vertical funciona (escadas, escadas de mão, rampas, elevadores, escalada, voo, plataformas de teletransporte).
  3. Para que serve, e o que lhe aconteceu: seu propósito original, seu uso atual (habitado, abandonado, ocupado por outros, arruinado) e os eventos que o mudaram (cerco, inundação, colapso, crescimento excessivo). Danos precisam de uma causa neste mundo.
  4. As regras do estilo artístico: realista, estilizado, exagerado, low-poly ou parecido com brinquedo, e o que faz com a proporção (portas superdimensionadas, paredes robustas, verticais tortas) e com o detalhe. Um mundo estilizado pode distorcer proporções reais de propósito; o resumo diz até onde.
  5. Quem se move por ele: o tamanho e movimentos do jogador (andar, agachar, engatinhar, escalar, pular, nadar, voar), companheiros, criaturas e veículos que devem caber, e se os espaços são explorados, construídos, combatidos ou percorridos em fuga (isso define PROFILE).
  6. Exceções deliberadas: o que este mundo faz que um edifício moderno não faria, para que os revisores aceitem (parapeitos sem guarda, escadas de mão em vez de escadas, fortificações com uma única entrada, cabanas sem porta, escadas em caracol com degraus íngremes, salas alcançadas apenas escalando).

Regras abaixo que dizem "sensato", "um construtor", "um projetista" ou "uma razão" significam: sensato para os construtores, propósito e estilo neste resumo.

Configurações fornecidas pelo projeto

Toda configuração tem um padrão para um jogador de escala humana, em metros, com proporções modernas. Um projeto com outras proporções ou outro período (uma pequena criatura, um gigante, um veículo, escadas medievais íngremes, uma unidade diferente) define os números a partir de seu resumo do mundo, não do método. No script, as configurações vêm do objeto "settings" do grafo, depois --profile e --site, depois --set NOME=VALOR (o último vence); um nome desconhecido é um erro, para que um erro de digitação nunca passe silenciosamente.

Tipo de local e regras desligadas. Algumas regras vêm de como os edifícios são projetados para pessoas (saídas por área de piso, loops internos, sem funil único, a proporção de salas sem saída, corredores ramificados). Uma caverna, ruína ou espaço natural não as deve para exploração, então com SITE natural ou ruin e PROFILE explore são relatadas como notas; em contested aplicam-se em todos os lugares, porque lutas e perseguições precisam delas onde quer que aconteçam. Qualquer regra também pode ser desligada pelo resumo do mundo com RULES_OFF (por exemplo, uma fortaleza com um único portão por projeto: RULES_OFF=exits,funnel), ou aceita para um espaço na lista accepted do grafo.

ConfiguraçãoPadrãoSignificadoUsado por
WORLD_BRIEFnenhum (moderno, realista, escala humana assumida, e o relatório deve dizê-lo)A meia página acima.Todas as passagens
PROFILEexploreexplore (exploração, história, construção, sobrevivência sem lutas internas) ou contested (jogadores lutam, perseguem ou fogem aqui). contested ativa as regras marcadas (C).Script
SITEbuildingbuilding, vessel (navios, estações, veículos: tratados como edifício), natural (cavernas, desfiladeiros, bosques, gelo, recifes) ou ruin.Script
RULES_OFFnenhumLista separada por vírgulas de IDs de regras relatadas apenas como notas.Script
PLAYER_RADIUS0.40Metade da largura da cápsula de caminhada.Script
CROUCH_HEIGHT1.10Pé-direito necessário em espaços de engatinhar, apertos, natação, escadas de mão, escaladas, alçapões e janelas.Script
MIN_HEADROOM2.10Altura livre sobre toda superfície percorrível que não seja um espaço de engatinhar.Script
MIN_DOOR_WIDTH0.90Largura livre de uma porta, abertura, escada, rampa ou elevador.Script
MIN_CORRIDOR_WIDTH1.20Largura livre de um corredor ou passagem.Script
MIN_SPIRAL_WIDTH0.70Largura livre de uma escada marcada "spiral": true.Script
MIN_CLIMB_WIDTH0.60Largura livre de uma escada de mão, escalada, alçapão ou natação.Script
LARGE_AGENT_DIAMETER0 (nenhum)Diâmetro da maior criatura ou veículo que deve passar; rotas marcadas large_route têm pelo menos 1,5 vezes esta largura.Script
STAIR_RISER_MIN, STAIR_RISER_MAX0.10, 0.20Faixa do espelho. Um mundo medieval ou apertado aumenta o máximo.Script
STAIR_TREAD_MIN, STAIR_TREAD_MAX0.22, 0.40Faixa do piso.Script
STAIR_PACE_MIN, STAIR_PACE_MAX0.55, 0.70A regra da passada: duas vezes o espelho mais o piso. Vale entre períodos e detecta escadas íngremes para seu piso. Não aplicado a espirais.Script
MAX_RISERS_PER_FLIGHT16Um patamar pelo menos com esta frequência (não aplicado a espirais).Script
STEP_HEIGHT0.45O degrau mais alto que o personagem sobe sem uma escada; uma porta ou abertura com um step maior é um bloqueio.Script
GUARD_DROP1.00Um espaço percorrível com um edge_drop maior que isso precisa de "guarded": true (grade, parapeito, parede, ou o que este mundo usar), ou uma condição aceita dizendo que a queda é deliberada e lê-se como uma.Script, sonda
TUBE_LENGTH15Maior corredor ou passagem sem uma ramificação.Script
DEAD_END_DEPTHexplore 20, contested 10Maior profundidade de beco sem saída a partir de sua última junção, em metros.Script
EXIT_SPACING, VERTICAL_SPACING10, 15Saídas mais próximas que isso em uma face contam uma vez; duas rotas verticais devem estar pelo menos a esta distância.Script
MAX_ROOM_OPENINGS4(C) Maioria das aberturas para uma sala ou câmara.Script
MIN_SPACE_AREA1.0Menor espaço utilizável.Script
GUARD_HEIGHT1.00 a 1.10Altura de uma proteção onde necessária.Sonda
LAYOUT_SOURCEos dados de layout do projetoDe onde vem o plano: uma receita ou manifesto, uma exportação de nível, ou um plano desenhado à mão.Entrada da Passagem 1

Saídas por área de piso (todos os pisos internos percorríveis juntos). Saídas mais próximas que EXIT_SPACING na mesma face contam uma vez; uma janela pela qual um jogador pode escalar conta como meia; uma queda unidirecional para o exterior é uma fuga, listada mas não contada.

Área de pisoexplorecontested
Abaixo de 100 m²12, em 2 faces
100 a 400 m²2, em 2 faces3, em pelo menos 2 faces
Acima de 400 m²3, em pelo menos 2 faces4, em pelo menos 3 faces

Passagem 1: o grafo espacial (script)

Descreva o local como espaços e links em JSON (formato e todos os campos em templates/space_graph.example.json) e execute:

python3 -I scripts/layout_check.py <graph.json> [--profile explore|contested] [--site building|natural|ruin|vessel] [--set NOME=VALOR ...] [--json out.json]
  • Um espaço é qualquer lugar onde um jogador pode ficar que se lê como um lugar. Tipos: exterior (o mundo exterior, exatamente um), room, chamber (salas naturais ou irregulares), corridor, passage (corredores naturais), landing, stair (um espaço de poço de escada), roof, deck, yard, void (selado). Salas, câmaras, corredores, passagens, patamares, telhados e conveses contam para becos sem saída; salas e câmaras contam para aberturas e a proporção de becos sem saída. Dê a cada um um id, andar, área e, onde puder: posição (x, y), comprimento e largura (corredores e passagens), pé-direito, edge_drop e guarded, crawl, anchor (o espaço principal), sealed.
  • Um link é qualquer caminho entre dois espaços. Tipos: door, opening, stair, ramp, lift, ladder, hatch, climb, swim, squeeze (passagem rastejante), window (uma pela qual um jogador escala) e drop (unidirecional, de a para b). Dê a ele sua largura livre e pé-direito onde conhecidos, face e x, y para links para o exterior, step para uma mudança de nível em uma porta, e espelho, piso, degraus e spiral para escadas. Modele cada lance de escada como um link de escada entre os espaços que ele une; qualquer link não-drop entre dois andares conta como rota vertical.

IDs de regras, usados em relatórios, accepted e RULES_OFF: reach, return, sealed, exits, dead_end, dead_share, loop, funnel, vertical, door_width, corridor_width, large_width, headroom, step, guard, stair, tube, small, openings. Uma entrada accepted é {"rule": "...", "space": "..."} (ou "link"), ou apenas uma regra e uma razão para aceitá-la em todos os lugares.

O script relata BLOQUEIO, CONSTATAÇÃO, ACEITO, NOTA (incluindo o que não pôde verificar a partir dos dados fornecidos) e OK:

  • Atingibilidade (reach, return): todo espaço não selado atingível a partir do exterior com os movimentos no grafo, e um caminho de volta de cada um (drops são unidirecionais).
  • Saídas (exits): contagem, faces e espaçamento contra a tabela.
  • Becos sem saída (dead_end, dead_share): espaços com uma única entrada, a profundidade da cadeia a partir da última junção, e (C) a proporção de salas sem saída.
  • Loops (loop): pelo menos um loop interior onde o local tem mais de 400 m² ou mais de dois espaços de profundidade.
  • Funil (funnel): rotas separadas (sem compartilhar espaço) do exterior até a âncora, ou até a sala mais profunda se nenhuma estiver marcada; uma rota é um bloqueio em (C) acima de 100 m² e uma constatação acima de 400 m².
  • Rotas verticais (vertical): rotas de cada andar em direção ao andar de entrada, para cima ou para baixo; duas, pelo menos a VERTICAL_SPACING de distância, em andares acima de 200 m², ou acima de 100 m² em (C).
  • Tamanhos e níveis (door_width, corridor_width, large_width, headroom, small, step): larguras e pé-direito por tipo de link, espaços mais estreitos que o jogador, degraus sem escada.
  • Escadas (stair): espelho, piso, passada e comprimento do lance; espelhos mistos em um edifício.
  • Bordas (guard): quedas não guardadas acima de GUARD_DROP.
  • Tubos e aberturas (tube, openings): corredores acima de TUBE_LENGTH sem ramificação; (C) salas com muitas aberturas.

Passagem 2: sondas geométricas (no motor ou ferramenta de modelagem)

O grafo não pode ver geometria. Execute estas no edifício montado com as próprias ferramentas do projeto; cada uma deve produzir um número ou uma lista, não uma captura de tela.

SondaMedeFalha quando
Inundação de caminhadaUma cápsula do tamanho do jogador caminha a partir de cada porta externa com gravidade, tratando paredes como sólidas (uma construção de malha de navegação é aceitável).Um espaço que o grafo chama de atingível não é alcançado, ou a caminhada alcança um lugar que o grafo não tem (uma lacuna, um topo de parede, um telhado sem rota).
SuportePara cada piso, telhado, escada, viga e parede superior: o elemento abaixo dele em sua pegada.Algo repousa sobre nada (mais de 1 cm de ar), uma coluna ou parede acima pousa em um vão de piso sem viga ou parede abaixo, ou uma cantilever excede cerca de um terço de seu vão posterior sem um suporte ou braçadeira visível.
Extremidades de paredesCada extremidade de cada parede e divisória.Uma extremidade não toca nada (e não é uma extremidade livre acabada), pousa dentro de uma porta ou abertura de janela, ou para antes de uma parede por menos que a largura do jogador.
AberturasAltura do piso em ambos os lados de cada porta, um raio através de cada janela.Uma porta se abre para uma parede, uma queda, um vazio selado ou um degrau mais alto que STEP_HEIGHT; uma janela está bloqueada a 1 m atrás dela por uma parede, laje de piso, escada ou suporte alto; um piso ou parede interna cruza uma janela na fachada.
FolgaCápsula varrida ao longo de cada rota, áreas de giro de porta, patamares de escada.Pé-direito ou largura fica abaixo das configurações; um suporte, coluna ou divisória está no caminho de uma porta, em um patamar ou na largura livre de um corredor.
BordasToda borda percorrível e sua queda.Uma queda acima de GUARD_DROP não tem proteção e não está marcada como deliberada.
SobreposiçãoInterseções parede-em-parede, parede-em-piso e suporte-em-parede.Qualquer interseção acima de alguns milímetros que um jogador possa ver.

Passagem 3: revisão em altura dos olhos

Um revisor novo (pessoa ou agente crítico que não viu a construção) percorre-a na altura dos olhos e olha uma planta e um corte de cada andar. Recebem o resumo do mundo, o propósito do edifício ("uma casa de fazenda para duas famílias", "um bunker de pesquisa inundado", "um templo colapsado", "um convés de tripulação em um cargueiro") e as condições aceitas (becos sem saída deliberados, portas trancadas, seções colapsadas, espaços de engatinhar), e respondem:

  1. Cada parede tem uma razão? Ela envolve uma sala, carrega algo, protege uma borda, bloqueia uma vista, ou (em uma ruína) é o que resta de uma dessas. Uma parede que não faz nenhuma destas é removida.
  2. Cada sala tem um propósito e uma entrada que lhe convém? Um lavabo saindo de um corredor, não da cozinha através de um quarto; um depósito perto do que armazena; um posto de guarda onde possa ver o que guarda; uma câmara de descompressão entre pressão e...

... [truncado para tradução]

Individual skills in this repo

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

creature-animation-pipeline

Author and ship a full bespoke animation set for a creature (dinosaur, beast, large biped or quadruped) with AI agents - biomechanics and mass first, rig profile and joint caps, key frames first, clip order and mirrors, a per-species animation studio for review, blind calibrated critics, the owner's stamp lock with a no-regression champion take, every clip wired, a species speed curve and the feel-bug rules. Use when starting a new species, authoring or fixing creature clips, setting up the review studio, critics or stamps, or deciding whether a creature clip is done.

first-person-weapon-animation

Build bespoke first-person and third-person weapon animation for an Unreal shooter - gun-space rig, measured hold poses, gun-first action authoring with key frames first, reload anatomy, modular weapon families with per-weapon profiles, procedural layers with stated interpolation, export and install with round-trip checks, a per-weapon review surface, calibrated blind critics, owner stamps and a no-regression champion take. Use when authoring hold poses, reloads or other weapon actions, installing weapon animation, tuning or debugging first-person feel, or reviewing weapon animation.

human-character-animation

Build bespoke third-person human character animation for a multiplayer Unreal shooter (NPC bodies and the player's third-person body) - rig and retargeting hygiene, vetting clip drops, locomotion with motion matching, turn-in-place, layered upper body and aim offsets, third-person weapon read, cover, hit reactions and deaths, a review studio, calibrated blind critics with measured checks, owner stamps with a champion take, key frames first and the blending law. Use when authoring, importing, wiring or reviewing human character clips, setting up a human animation review loop, or fixing a human body feel bug.

poi-design

Design, build, critique and ship points of interest (compounds, towns, facilities, stations, wrecks, camps, ruins, caves) in an open-world game of any setting, period, style or genre - the site's purpose in the world, how it is found without markers and read from a distance, a visual brief per site, flow sized for the game's players and largest enemies, story told through the environment, loot placement, prop and vehicle sourcing rules, assembly from passed kit pieces, a finish bar, blind calibrated critics with eye-height and aerial reviews, owner or lead stamps, fault-to-rule fixes and the "does it make sense?" rule. Use when planning a POI, writing its brief, laying it out or dressing it, reviewing one, or setting up a POI critic loop.

Habilidades Relacionadas