3d-debugging

3d-debugging is a skill for Claude Code, Codex from murphy977/3d-eyes. It costs 93 tokens per session (964 once invoked), scanned A, original, MIT.

A workflow for diagnosing broken 3D models and scenes with rendered views and reports. It covers formats such as GLB, GLTF, OBJ, PLY, and STL, as well as Gaussian splats, a 3D point-based representation.

In plain words
What is it for?
It helps inspect scenes, identify issues such as flipped normals or holes, edit the file, and compare renders before and after a fix.
Why use it?
It replaces guesses based on file data with visual checks of problems such as invisible, black, oversized, or untextured models.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/murphy977/3d-eyes/skill
Any agent
npx skills add murphy977/3d-eyes --skill skill
Clone the repo
git clone --depth 1 https://github.com/murphy977/3d-eyes

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for 3d-debugging

README.md
[![agentmods](https://agentmods.dev/badge/skills/murphy977/3d-eyes/skill.svg)](https://agentmods.dev/skills/murphy977/3d-eyes/skill)
Your own site
<a href="https://agentmods.dev/skills/murphy977/3d-eyes/skill"><img src="https://agentmods.dev/badge/skills/murphy977/3d-eyes/skill.svg" alt="Measured on agentmods" height="20"></a>
Per session 93 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 964 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00093 $0.00964
Opus 5 $0.00046 $0.00482
Sonnet 5 $0.00019 $0.00193
Haiku 4.5 $0.00009 $0.00096

Measured 4d ago against content hash b2a1cf5baea3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

3d-debugging scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skill/SKILL.md · 57 lines

How it starts

The opening of the file, as written. The whole thing — 57 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Debugging 3D files with 3d-eyes

You have eyes for 3D. The 3d-eyes MCP server renders any mesh or Gaussian splat file so you can look at it instead of guessing from code. Trust what you see in the render plus the JSON report over any assumption.

Workflow

  1. Always start with inspect_scene(path). Look at the contact sheet (6 orthographic views + perspective) and read the findings before theorizing.
  2. Need a closer look? render_views(path, cameras=[{"azimuth": ..., "elevation": ..., "distance": 1.2}]) - small distance zooms in, ortho: true for exact silhouettes.
  3. Fix the problem by editing the user's file or code (trimesh one-liners below).
  4. Verify with diff_renders(before, after) and show the user the comparison image. Never claim a fix worked without looking at it.

Symptom → cause table

What you see (or the user reports) Likely cause First check Typical fix
Model renders black / dark in their engine Flipped normals Red faces in contact sheet (highlight_backfaces) mesh.invert() or trimesh.repair.fix_normals(mesh)
Red patches on some sides only Partially flipped faces flipped_normals finding says "inconsistent winding" trimesh.repair.fix_normals(mesh)
Model invisible or microscopic Scale unit mismatch (mm vs m) scale_anomaly finding; extents in stats Scale by 1000 or 0.001 on export
Model gigantic, camera inside it Same, opposite direction extents > 1000 Scale by 0.001
Gray/white/magenta untextured surface Broken texture paths missing_textures finding lists the files Fix relative paths or re-export as GLB (embeds textures)
Seams, shading artifacts along an edge Non-manifold fins nonmanifold finding Delete/split extra faces on the offending edges
Raycasts/physics/boolean ops fail on a fine-looking model Degenerate faces degenerate_faces finding mesh.update_faces(mesh.nondegenerate_faces())
Splat scene has blobs floating in mid-air / haze Training floaters floaters in the splat report + white specks in renders Crop by bounding box, prune by opacity, or retrain
File "won't load" anywhere Corrupt/mislabeled file inspect_scene returns a parse error report Follow the error's fix field

Read the full file on GitHub · 57 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 57 lines · 93 tokens per session scan A b2a1cf5baea3

Subscribe to this mod's changes

3d-debugging is a skill published in the GitHub repository murphy977/3d-eyes (0 stars, last pushed 1mo ago), licensed MIT. It adds 93 tokens to every session and 964 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

ara3d-sdk

Use when processing AEC/BIM 3D data in .NET 8 — mesh generation and transformation, SIMD-accelerated math, IFC/STEP/PLY to glTF/GLB/VIM conversion, plugin development. Ara3D-SDK: high-performance .NET 3D geometry and BIM library suite.

znlgis/opengis-skills · 70 tokens

supersplat

Use when editing 3D Gaussian Splatting (3DGS) .ply models in browser — cleanup noise/floaters, crop, transform, color-adjust, animate camera, publish online. SuperSplat: open-source browser-based 3DGS editor by PlayCanvas with PLY/compressed PLY/Splat/KSplat/SOG export.

znlgis/opengis-skills · 76 tokens

cesiumjs

Use when building browser-based 3D globes, 3D Tiles visualization, time-dynamic geospatial data, or virtual globe applications. CesiumJS: high-performance WebGL 3D geospatial engine for interactive earth visualization.

znlgis/opengis-skills · 52 tokens

elements

Use when generating building information models (BIM) programmatically in C#/.NET — wall, beam, column, floor creation, geometry kernel (BREP/CSG), glTF/IFC/JSON serialization, MEP systems, spatial grids. Hypar Elements: the smallest useful BIM — a cross-platform C# library for creating building elements without…

znlgis/opengis-skills · 81 tokens

astral3d

Use when building industrial 3D visualization and editing applications — large model rendering, STEP/B-Rep viewing, measurement, markup. Astral3D: industrial 3D visualization and editing framework.

znlgis/opengis-skills · 45 tokens

3d-skills

Use when working with 3D Gaussian Splatting (3DGS), .ply model cleanup/compression/publishing, interactive 360-degree panorama visualization and virtual tours, AEC/BIM 3D data processing, or CSG solid modeling. Index of 5 skills: SuperSplat, Photo-Sphere-Viewer, Ara3D-SDK, Elements, and OpenCSG.NET.

znlgis/opengis-skills · 86 tokens