Communitygithub.com

verificación-de-diseño-de-edificios

Verifica que un edificio, interior o entorno cerrado generado o construido manualmente sea estructuralmente sensato y transitable correctamente: rutas de carga, paredes que comienzan y terminan en algo, puertas que llevan a algún lugar, escaleras con descansos y altura libre, sin habitaciones huérfanas, sin paredes colocadas en vanos, suficientes salidas, callejones sin salida poco profundos, bucles y dos rutas verticales donde la gente lucha o huye. Neutral en cuanto a motor y género; incluye un script de verificación de grafo espacial. Útil al revisar un edificio o diseño producido por un agente o generador, antes de aceptar un prefabricado, o al escribir reglas de diseño para un kit.

¿Qué es verificación-de-diseño-de-edificios?

Esta habilidad proporciona una verificación integral de la estructura y navegabilidad de entornos cerrados (edificios, naves, cuevas, etc.), independientemente del motor de juego o género. Es útil para desarrolladores, diseñadores de niveles y agentes de IA que generan o revisan diseños, asegurando que cumplan con criterios de sentido común y usabilidad. Funciona en tres pasos: un análisis rápido del grafo espacial (script en Python), sondas geométricas detalladas en el motor o herramienta de modelado, y una revisión final desde la altura de los ojos realizada por un revisor humano o agente crítico. Se basa en un 'brief mundial' que define el entorno, la época, los materiales y las reglas de estilo, permitiendo que la verificación sea contextualmente apropiada (por ejemplo, una fortaleza medieval tendrá reglas diferentes a una estación espacial). El script de grafo espacial verifica conectividad, salidas, callejones sin salida, bucles, rutas verticales, dimensiones de puertas y pasillos, escaleras y bordes peligrosos, y puede adaptarse mediante ajustes como `PROFILE` (exploración o combate) y `SITE` (edificio, nave, natural o ruina).

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Verificación de diseño de edificios

Los kits modulares facilitan colocar una pared en cualquier lugar que permita la cuadrícula, y los generadores y agentes harán exactamente eso: paredes que terminan en medio de una habitación o cruzan una ventana, puertas que se abren a una pared en blanco o a un vacío, habitaciones a las que nadie puede llegar, escaleras que llegan mirando a una pared, cajas de una sola puerta y pasillos que nunca se ramifican. Esta habilidad es la verificación que los detecta. Juzga el diseño y la estructura, no el acabado ni los materiales.

Funciona para cualquier entorno, época y estilo artístico, porque juzga cada espacio según la lógica del propio mundo, escrita una vez en un breve mundial (abajo): una fortaleza de piedra según cómo construyen los canteros y cómo vive la guarnición, una nave estelar según cómo se mueve su tripulación y qué transporta su casco, una cueva según cómo la cortó el agua y cómo la usan sus habitantes, un pueblo de dibujos animados según las reglas que marca su estilo. Los códigos de construcción modernos son solo el respaldo cuando un proyecto no dice nada.

Tres pasos, en orden, porque cada uno es más barato que el siguiente: el grafo espacial (un script, segundos), las sondas geométricas (en el motor o herramienta de modelado, minutos) y la revisión a la altura de los ojos (una persona o un agente crítico nuevo). Un edificio pasa cuando no queda ningún bloqueador en ningún paso.

El breve mundial (escríbelo antes de la primera verificación)

Una sección corta en los documentos de entorno del proyecto, aproximadamente media página, que todos los verificadores y revisores lean. Sin él, los revisores recurren a su propia época y estilo y señalan lo incorrecto.

  1. Entorno y época: dónde y cuándo (por ejemplo "ciudad fluvial bajomedieval", "estación minera orbital, año 2300", "ruinas post-inundación de un suburbio de los 70", "madrigueras de gente-hongo").
  2. Quién lo construyó, con qué: la tecnología y los materiales de los constructores, y lo que eso permite: vanos (madera de 4 a 6 m, bóvedas de piedra, cerchas de acero, coral cultivado), grosor de paredes, cómo se sostienen los suelos, cómo funciona el desplazamiento vertical (escaleras, escalas de mano, rampas, ascensores, escalada, vuelo, plataformas de teletransporte).
  3. Para qué sirve y qué le pasó: su propósito original, su uso actual (habitado, abandonado, ocupado por otros, en ruinas) y los eventos que lo cambiaron (asedio, inundación, derrumbe, crecimiento excesivo). Los daños necesitan una causa en este mundo.
  4. Las reglas del estilo artístico: realista, estilizado, exagerado, low-poly o de juguete, y lo que hace a la proporción (puertas sobredimensionadas, paredes rechonchas, verticales torcidas) y al detalle. Un mundo estilizado puede doblar las proporciones reales a propósito; el breve dice hasta qué punto.
  5. Quién se mueve por él: el tamaño y los movimientos del jugador (caminar, agacharse, gatear, trepar, saltar, nadar, volar), acompañantes, criaturas y vehículos que deben caber, y si los espacios se exploran, se construyen, se luchan o se huyen (esto establece PERFIL).
  6. Excepciones deliberadas: lo que este mundo hace que un edificio moderno no haría, para que los revisores lo acepten (almenas sin protección, escalas de mano en lugar de escaleras, fortificaciones de una sola entrada, chozas sin puerta, escaleras de caracol con peldaños empinados, habitaciones a las que solo se llega trepando).

Las reglas a continuación que dicen "sensato", "un constructor", "un diseñador" o "una razón" significan: sensato para los constructores, el propósito y el estilo de este breve.

Configuraciones que el proyecto proporciona

Cada configuración tiene un valor predeterminado para un jugador de escala humana, en metros, con proporciones modernas. Un proyecto con otras proporciones u otra época (una criatura pequeña, un gigante, un vehículo, escaleras medievales empinadas, una unidad diferente) establece los números a partir de su breve mundial, no del método. En el script, las configuraciones provienen del objeto "settings" del grafo, luego --perfil y --sitio, luego --set NOMBRE=VALOR (el último gana); un nombre desconocido es un error, para que un error tipográfico nunca pase en silencio.

Tipo de sitio y reglas desactivadas. Algunas reglas provienen de cómo se diseñan los edificios para personas (salidas por superficie, bucles interiores, sin un solo embudo, la proporción de habitaciones sin salida, pasillos que se ramifican). Una cueva, una ruina o un espacio natural no las debe por exploración, así que con SITIO natural o ruina y PERFIL explorar se reportan como notas; en disputado se aplican en todas partes, porque las peleas y persecuciones las necesitan dondequiera que ocurran. Cualquier regla también se puede desactivar mediante el breve mundial con REGLAS_DESACTIVADAS (por ejemplo, una fortaleza con una sola puerta por diseño: REGLAS_DESACTIVADAS=salidas,embudo), o aceptarse para un espacio en la lista aceptado del grafo.

ConfiguraciónValor predeterminadoSignificadoUsado por
BREVE_MUNDIALninguno (moderno, realista, escala humana asumida, y el informe debe decirlo)La media página de arriba.Todos los pasos
PERFILexplorarexplorar (exploración, historia, construcción, supervivencia sin peleas en interiores) o disputado (los jugadores luchan, persiguen o huyen aquí). disputado activa las reglas marcadas (C).Script
SITIOedificioedificio, nave (barcos, estaciones, vehículos: tratado como un edificio), natural (cuevas, cañones, arboledas, hielo, arrecifes) o ruina.Script
REGLAS_DESACTIVADASningunoLista separada por comas de identificadores de reglas reportadas solo como notas.Script
RADIO_JUGADOR0.40La mitad del ancho de la cápsula de caminata.Script
ALTURA_AGACHARSE1.10Altura libre necesaria en espacios de gateo, apretujones, nados, escalas de mano, trepadas, escotillas y ventanas.Script
ALTURA_LIBRE_MIN2.10Altura libre sobre toda superficie transitable que no sea un espacio de gateo.Script
ANCHO_PUERTA_MIN0.90Ancho libre de una puerta, abertura, escalera, rampa o ascensor.Script
ANCHO_PASILLO_MIN1.20Ancho libre de un pasillo o pasaje.Script
ANCHO_CARACOL_MIN0.70Ancho libre de una escalera marcada "espiral": true.Script
ANCHO_TREPADA_MIN0.60Ancho libre de una escala de mano, trepada, escotilla o nado.Script
DIÁMETRO_AGENTE_GRANDE0 (ninguno)Diámetro de la criatura o vehículo más grande que debe pasar; las rutas marcadas ruta_grande tienen al menos 1,5 veces este ancho.Script
CONTRAHUELLA_MIN, CONTRAHUELLA_MAX0.10, 0.20Rango de contrahuella. Un mundo medieval o apretado aumenta el máximo.Script
HUELLA_MIN, HUELLA_MAX0.22, 0.40Rango de huella.Script
PASO_ESCALERA_MIN, PASO_ESCALERA_MAX0.55, 0.70La regla de la zancada: dos veces la contrahuella más la huella. Se cumple en todas las épocas y detecta escaleras empinadas para su huella. No se aplica a las de caracol.Script
MÁX_CONTRAHUELLAS_POR_TRAMO16Un descanso al menos cada esta cantidad (no se aplica a las de caracol).Script
ALTURA_PASO0.45El escalón más alto que el personaje sube sin escalera; una puerta o abertura con un paso mayor es un bloqueador.Script
CAÍDA_BARRERA1.00Un espacio transitable con un borde_caída mayor que esto necesita "barrera": true (barandilla, pretil, pared, o lo que use este mundo), o una condición aceptada que indique que la caída es deliberada y se percibe como tal.Script, sonda
LONGITUD_TUBO15Pasillo o pasaje más largo sin ramificación.Script
PROFUNDIDAD_SIN_SALIDAexplorar 20, disputado 10La profundidad máxima de un callejón sin salida desde su última bifurcación, en metros.Script
ESPACIADO_SALIDAS, ESPACIADO_VERTICAL10, 15Las salidas a menos de esta distancia en una misma cara cuentan una vez; dos rutas verticales deben estar al menos a esta distancia.Script
MÁX_ABERTURAS_HABITACIÓN4(C) La mayoría de aberturas hacia una habitación o cámara.Script
ÁREA_ESPACIO_MIN1.0Espacio utilizable más pequeño.Script
ALTURA_BARRERA1.00 a 1.10Altura de una barrera donde se necesita.Sonda
FUENTE_DISEÑOlos datos de diseño del proyectoDe dónde proviene el plano: una receta o manifiesto, una exportación de nivel o un plano dibujado a mano.Entrada del paso 1

Salidas por superficie (todas las plantas transitables interiores juntas). Las salidas a menos de ESPACIADO_SALIDAS en la misma cara cuentan una vez; una ventana por la que el jugador pueda trepar cuenta como media; una caída unidireccional al exterior es una escapatoria, listada pero no contada.

Superficieexplorardisputado
Menos de 100 m²12, en 2 caras
100 a 400 m²2, en 2 caras3, en al menos 2 caras
Más de 400 m²3, en al menos 2 caras4, en al menos 3 caras

Paso 1: el grafo espacial (script)

Describe el lugar como espacios y enlaces en JSON (formato y cada campo en templates/space_graph.example.json) y ejecuta:

python3 -I scripts/layout_check.py <grafo.json> [--perfil explorar|disputado] [--sitio edificio|natural|ruina|nave] [--set NOMBRE=VALOR ...] [--json salida.json]
  • Un espacio es cualquier lugar donde un jugador pueda estar de pie y que se perciba como un lugar. Tipos: exterior (el mundo exterior, exactamente uno), habitación, cámara (habitaciones naturales o irregulares), pasillo, pasaje (pasillos naturales), descanso, escalera (un espacio de caja de escalera), techo, cubierta, patio, vacio (sellado). Las habitaciones, cámaras, pasillos, pasajes, descansos, techos y cubiertas cuentan para callejones sin salida; las habitaciones y cámaras cuentan para aberturas y la proporción de callejones sin salida. Dale a cada uno un id, planta, área y, donde puedas: posición (x, y), longitud y anchura (pasillos y pasajes), altura libre, borde_caída y barrera, gateo, ancla (el espacio principal), sellado.
  • Un enlace es cualquier camino entre dos espacios. Tipos: puerta, abertura, escalera, rampa, ascensor, escala_mano, escotilla, trepada, nado, apretujón (gatear), ventana (una por la que el jugador trepa) y caída (unidireccional, de a a b). Dale su ancho libre y altura libre cuando se conozcan, cara y x, y para enlaces al exterior, paso para un cambio de nivel en una puerta, y contrahuella, huella, contrahuellas y espiral para escaleras. Modela cada tramo de escalera como un enlace de escalera entre los espacios que une; cualquier enlace que no sea una caída entre dos plantas cuenta como ruta vertical.

Identificadores de reglas, usados en informes, aceptado y REGLAS_DESACTIVADAS: alcance, retorno, sellado, salidas, sin_salida, proporcion_sin_salida, bucle, embudo, vertical, ancho_puerta, ancho_pasillo, ancho_grande, altura_libre, paso, barrera, escalera, tubo, pequeño, aberturas. Una entrada aceptado es {"regla": "...", "espacio": "..."} (o "enlace"), o solo una regla y una razón para aceptarla en todas partes.

El script reporta BLOQUEADOR, HALLAZGO, ACEPTADO, NOTA (incluyendo lo que no pudo verificar a partir de los datos dados) y OK:

  • Accesibilidad (alcance, retorno): cada espacio no sellado accesible desde el exterior con los movimientos en el grafo, y un camino de regreso desde cada uno (las caídas son unidireccionales).
  • Salidas (salidas): cantidad, caras y espaciado según la tabla.
  • Callejones sin salida (sin_salida, proporcion_sin_salida): espacios con una sola entrada, la profundidad de la cadena desde la última bifurcación, y (C) la proporción de habitaciones sin salida.
  • Bucles (bucle): al menos un bucle interior donde el lugar tiene más de 400 m² o más de dos espacios de profundidad.
  • Embudo (embudo): rutas separadas (sin compartir espacio) desde el exterior hasta el ancla, o hasta la habitación más profunda si no hay ninguna marcada; una ruta es un bloqueador en (C) de más de 100 m² y un hallazgo de más de 400 m².
  • Rutas verticales (vertical): rutas desde cada planta hacia la planta de entrada, hacia arriba o hacia abajo; dos, al menos a ESPACIADO_VERTICAL de distancia, en plantas de más de 200 m², o de más de 100 m² en (C).
  • Tamaños y niveles (ancho_puerta, ancho_pasillo, ancho_grande, altura_libre, pequeño, paso): anchos y altura libre según el tipo de enlace, espacios más estrechos que el jugador, pasos sin escalera.
  • Escaleras (escalera): contrahuella, huella, zancada y longitud del tramo; contrahuellas mixtas en un mismo edificio.
  • Bordes (barrera): caídas sin barrera mayores a CAÍDA_BARRERA.
  • Tubos y aberturas (tubo, aberturas): pasillos de más de LONGITUD_TUBO sin ramificación; (C) habitaciones con demasiadas aberturas.

Paso 2: sondas geométricas (en el motor o herramienta de modelado)

El grafo no puede ver la geometría. Ejecuta estas en el edificio ensamblado con las herramientas propias del proyecto; cada una debe producir un número o una lista, no una captura de pantalla.

SondaMideFalla cuando
Inundación de caminataUna cápsula del tamaño del jugador camina desde cada puerta exterior con gravedad, tratando las paredes como sólidas (se acepta una construcción de malla de navegación).Un espacio que el grafo llama accesible no se alcanza, o la caminata llega a un lugar que el grafo no tiene (un hueco, una parte superior de una pared, un techo sin ruta).
SoportePara cada suelo, techo, escalera, viga y pared superior: el elemento debajo de él en su huella.Cualquier cosa descansa sobre nada (más de 1 cm de aire), una columna o pared superior aterriza sobre un vano de suelo sin viga o pared debajo, o un voladizo excede aproximadamente un tercio de su vano posterior sin un soporte o refuerzo visible.
Extremos de paredCada extremo de cada pared y tabique.Un extremo no toca nada (y no es un extremo libre acabado), aterriza dentro de una abertura de puerta o ventana, o se detiene a menos del ancho del jugador de una pared.
AberturasAltura del suelo en ambos lados de cada puerta, un rayo a través de cada ventana.Una puerta se abre a una pared, un vacío, un espacio sellado o un escalón más alto que ALTURA_PASO; una ventana está bloqueada dentro de 1 m detrás de ella por una pared, losa de suelo, escalera o soporte alto; un suelo o pared interior cruza una ventana en la fachada.
Espacio libreCápsula barrida a lo largo de cada ruta, áreas de giro de puertas, descansos de escaleras.La altura libre o el ancho caen por debajo de las configuraciones; un soporte, columna o tabique se interpone en la trayectoria de una puerta, en un descanso o en el ancho libre de un pasillo.
BordesCada borde transitable y su caída.Una caída de más de CAÍDA_BARRERA no tiene barrera y no está marcada como deliberada.
SuperposiciónIntersecciones pared-en-pared, pared-en-suelo y soporte-en-pared.Cualquier intersección de más de unos pocos milímetros que un jugador pueda ver.

Paso 3: revisión a la altura de los ojos

Un revisor nuevo (persona o agente crítico que no haya visto la construcción) la recorre a la altura de los ojos y mira un plano y una sección de cada planta. Se le da el breve mundial, el propósito del edificio ("una casa de campo de dos familias", "un búnker de investigación inundado", "un templo derrumbado", "una cubierta de tripulación en un carguero") y las condiciones aceptadas (callejones sin salida deliberados, puertas cerradas con llave, secciones derrumbadas, espacios de gateo), y responde:

  1. ¿Tiene cada pared una razón? Encierra una habitación, sostiene algo, protege un borde, oculta una vista o (en una ruina) es lo que queda de una de esas. Una pared que no hace ninguna de estas se elimina.
  2. ¿Tiene cada habitación un propósito y una entrada que le convenga? Un lavadero fuera de un pasillo, no fuera de la cocina a través de un dormitorio; un almacén cerca de lo que almacena; un puesto de guardia donde pueda ver lo que guarda; una esclusa entre presión y...

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.

Skills relacionados