# Threejs Debug Profiler

> Diagnose Three.js rendering, loading, animation, resize, audio, physics, input, mobile, and performance problems using reproduction and measured evidence.

- **Type:** Skill
- **Install:** `agentstack add skill-mintdotgg-mint-threejs-skills-threejs-debug-profiler`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mintdotgg](https://agentstack.voostack.com/s/mintdotgg)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [mintdotgg](https://github.com/mintdotgg)
- **Source:** https://github.com/mintdotgg/mint-threejs-skills/tree/main/skills/mint-threejs-skills/skills/threejs-debug-profiler
- **Website:** https://mcp.mint.gg

## Install

```sh
agentstack add skill-mintdotgg-mint-threejs-skills-threejs-debug-profiler
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Three.js Debug Profiler

Find the owning cause or measured bottleneck before changing code.

Read `references/debug-profile-checklists.md` for the applicable render,
runtime, loading, mobile, audio, physics, or performance path.

## Debug Workflow

1. Reproduce in the correct build mode.
2. Read the first console, page, and relevant network errors.
3. Check canvas display/drawing-buffer size, renderer/context, and loop ownership.
4. Check camera, clipping, lights, fog, materials, visibility, transforms, and
   scene contents.
5. Check asset paths, loaders, CORS, base path, async ordering, and Mint artifact
   integration.
6. Check delta units, update order, fixed timestep, bodies/colliders, listeners,
   pointer/touch behavior, resize, and audio unlock/decode.
7. Fix the cause in the owning module.
8. Retest the broken path plus screenshot, canvas pixels, and errors.

## Performance Workflow

1. Record target device, viewport, DPR, build mode, and worst-case scenario.
2. Measure frame time/FPS, draw calls, triangles, resources, memory, bundle, and
   expensive shadows/shaders/post-processing.
3. Identify CPU, GPU, memory, or network ownership.
4. Change one bottleneck at a time using reuse, instancing, culling, LOD,
   pooling, disposal, DPR limits, or cheaper rendering.
5. Re-measure the same scenario and verify playability and visuals.

## Final Response

Lead with root cause or bottleneck. Report files changed, baseline/post metrics,
commands, screenshots/artifacts, retested paths, and residual risks.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [mintdotgg](https://github.com/mintdotgg)
- **Source:** [mintdotgg/mint-threejs-skills](https://github.com/mintdotgg/mint-threejs-skills)
- **License:** MIT
- **Homepage:** https://mcp.mint.gg

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-mintdotgg-mint-threejs-skills-threejs-debug-profiler
- Seller: https://agentstack.voostack.com/s/mintdotgg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
