geometry-debugging

Diagnose terrain and coastline geometry issues in Bevy pipelines.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/gregoryraymond/claude-agents-and-skills --skill geometry-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: geometry-debugging
Source: https://github.com/gregoryraymond/claude-agents-and-skills/tree/main/skills/geometry-debugging
Command: npx skills add https://github.com/gregoryraymond/claude-agents-and-skills --skill geometry-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mesh debugging techniques for terrain/cliff/beach geometry enable diagnosing geometry problems, interpreting diagnostic output, and validating grid math, including change-detection pitfalls.

Core Features & Use Cases

  • Runtime diagnostics overlays: on-screen or logged diagnostics to reveal verts, tris, and grid alignment.
  • VRAM profiling & grid math references: tools to measure memory usage and validate coordinate math.
  • Change-detection pitfalls awareness: guidance to avoid common Bevy change detection mistakes when editing terrain.
  • Use Case: Imagine iterating on a coastal cliff where the cliff wall protrudes; this skill helps you diagnose the geometry cause through logs and overlays.

Quick Start

Toggle runtime diagnostics overlays and start the cliff mesh generator (gen_cliff_glb) to begin diagnosing geometry.

Frequently Asked Questions about geometry-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug terrain mesh generation in Bevy to find geometry misalignment?

Debug Bevy terrain mesh generation by enabling runtime diagnostic overlays to visualize vertices, triangles, and grid alignment issues. These overlays reveal geometry causes directly on-screen or through logged output during iteration.

What is the best way to profile VRAM usage for Bevy terrain workloads?

Profile VRAM usage for Bevy terrain workloads by implementing dedicated VRAM profiling hooks within your mesh generation pipeline. This process measures memory consumption and validates grid math to ensure efficient resource allocation.

Why does my Bevy terrain geometry not update when editing mesh data?

Bevy terrain geometry may not update due to common change-detection pitfalls when editing mesh data. Awareness of these specific Bevy change detection mistakes is required to properly trigger reactivity and update coastline geometry.

Can I use runtime diagnostic overlays to diagnose coastal cliff geometry protrusion?

You can use runtime diagnostic overlays to diagnose coastal cliff geometry protrusion by running the cliff mesh generator and interpreting the logged vertex and triangle data. This identifies the exact grid alignment causing the visual error.

Does this approach require grid-based terrain validation for coastline meshes?

Grid-based terrain validation is required for coastline meshes to accurately interpret diagnostic output and validate coordinate math. This validation ensures grid alignment issues within the Bevy terrain pipeline are correctly identified and resolved.