Agent skill

Threejs Debug Profiler

by valkor-ai in valkor-ai/loom

Debug and profile Three.js browser games: blank canvases, render and runtime bugs, asset and audio loading, animation, resize, mobile input, plus performance profiling of draw calls, triangles…

Apache-2.0Auto-check passedGame Development

Install Threejs Debug Profiler

skills CLI
$ npx skills add valkor-ai/loom --skill threejs-debug-profiler -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install valkor-ai/loom threejs-debug-profiler --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/valkor-ai/loom.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/shared/loom/skills/threejs/threejs-debug-profiler .claude/skills/threejs-debug-profiler && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
threejs-debug-profiler
GitHub stars
1.2k
Used in
1 other repo
Token cost
~602 tokens
SKILL.md length
301 words
Files
3 (incl. references)
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

Debug and profile Three.js browser games: blank canvases, render and runtime bugs, asset and audio loading, animation, resize, mobile input, plus performance profiling of draw calls, triangles…

  • Works in 8 steps: Reproduce locally with the same command… → Read console, page, and network errors. → Check canvas display size against… → …
  • Tasks that involve 3D graphics and WebGL
  • SKILL.md covers Reference, Debug, Profile and Report
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Threejs Debug Profiler is an agent skill from valkor-ai/loom. Debug and profile Three.js browser games: blank canvases, render and runtime bugs, asset and audio loading, animation, resize, mobile input, plus performance profiling of draw calls, triangles, textures, memory, shader and post-processing cost, and bundle size.

Its SKILL.md is about 600 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/debug-playbook.md`).

It sits in Game Development, covering 3D graphics and WebGL and Performance optimization. It works with Three.js. The repository describes itself as: Loop engineering for agentic software delivery. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve 3D graphics and WebGL
  • Tasks that involve Performance optimization

Example prompts

  • “/threejs-debug-profiler”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Reproduce locally with the same command and URL the user had.
  2. Read console, page, and network errors.
  3. Check canvas display size against drawing-buffer size.
  4. Check renderer, context, and loop ownership — more than one active loop is a common cause.
  5. Check camera aspect, near/far, lights, materials, fog, scene contents, transforms.
  6. Check asset paths, loaders, CORS, and base path.
  7. Check animation delta units, physics update order and fixed timestep, collider and body ownership, input listeners, pointer and touch…
  8. Fix the root cause in the module that owns it, then retest the exact broken path.

What it can do on your machine

Read from SKILL.md and the folder at commit a30a7e6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Threejs Debug Profiler loads about 602 tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 301 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~602
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from valkor-ai/loom at commit a30a7e6, republished under its Apache-2.0 licence (© valkor-ai). 301 words, ~602 tokens.

Download SKILL.mdSave it as .claude/skills/threejs-debug-profiler/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
threejs-debug-profiler
description
Debug and profile Three.js browser games: blank canvases, render and runtime bugs, asset and audio loading, animation, resize, mobile input, plus performance profiling of draw calls, triangles, textures, memory, shader and post-processing cost, and bundle size.

Three.js Debug Profiler

Find root causes and optimize measured bottlenecks without breaking playability.

Follow the changed behavior's scope. Reuse the lead's existing reproduction and evidence; verify the affected path after a fix. A passing focused check only needs broader testing when shared behavior changed or an unresolved risk warrants it. Return measurements and defects to the lead for the consolidated verification pass.

Reference

references/debug-playbook.md — ordered triage for blank canvas, asset and audio loading, loop/animation/physics, input and mobile, the profiling sequence, and the __THREE_GAME_DIAGNOSTICS__ shape. Read it when debugging or profiling anything non-obvious.

Debug

  1. Reproduce locally with the same command and URL the user had.
  2. Read console, page, and network errors.
  3. Check canvas display size against drawing-buffer size.
  4. Check renderer, context, and loop ownership — more than one active loop is a common cause.
  5. Check camera aspect, near/far, lights, materials, fog, scene contents, transforms.
  6. Check asset paths, loaders, CORS, and base path.
  7. Check animation delta units, physics update order and fixed timestep, collider and body ownership, input listeners, pointer and touch behavior, resize, and audio context unlock when audio is involved.
  8. Fix the root cause in the module that owns it, then retest the exact broken path.

Profile

  1. Reproduce in the correct build mode — production preview when user-facing performance matters.
  2. Baseline the scenario: FPS and frame time, draw calls, triangles, geometries, textures, memory, bundle.
  3. Classify the bottleneck as CPU, GPU draw, GPU fragment, GPU vertex, memory, or network.
  4. Change one thing — instancing, shared resources, culling, LOD, DPR cap, cheaper shadows or post, texture discipline.
  5. Re-measure the same scenario and confirm visuals and playability held.

Report

Lead with the root cause or the measured bottleneck. Then files changed, baseline and post metrics, commands, screenshots, the broken path retested, and residual risks.

© valkor-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in plugins/shared/loom/skills/threejs/threejs-debug-profiler of valkor-ai/loom.

  • SKILL.md
  • agents/openai.yaml
  • references/debug-playbook.md

Open the folder on GitHubat commit a30a7e6

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in valkor-ai/loom, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Threejs Debug Profiler next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Threejs Debug Profiler compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Threejs Debug Profiler this skillvalkor-ai/loom1.2k1 repos~602Automated safety check: PassApache-2.0
Optimize Performancetextura-agency/next16-claude-starter132—~3.7kAutomated safety check: NotesUnlicense
Threejs Debug Profilermintdotgg/mint-threejs-skills114—~435Automated safety check: PassMIT
Vtj Anti PatternshexianWeb/Third-Person-MC194—~1.5kAutomated safety check: PassMIT
Tresjs Core Skilldskilld-dev/vue-ecosystem-skills181—~2.2kAutomated safety check: PassMIT
Ship Web Gamesnirholas/three.ws2261 repos~284Automated safety check: PassApache-2.0

Similar skills

  • Optimize Performance

    textura-agency/next16-claude-starter

    Make a page in this starter actually smooth — build it, scroll it in real Chrome on PC and on an emulated phone, fix what the measurement blames, re-measure to prove it.

    132 GitHub stars~3.7k tokensUpdated yesterday
    Game DevelopmentAuto-check: notes
  • Threejs Debug Profiler

    mintdotgg/mint-threejs-skills

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

    114 GitHub stars~435 tokensUpdated 2 mo ago
    Game DevelopmentAuto-check passed
  • Vtj Anti Patterns

    hexianWeb/Third-Person-MC

    Prevents common mistakes and prohibited practices in vite-threejs projects.

    194 GitHub stars~1.5k tokensUpdated 2 mo ago
    Game DevelopmentAuto-check passed
  • Tresjs Core Skilld

    skilld-dev/vue-ecosystem-skills

    Declarative Three.js using Vue components. An agent skill from skilld-dev/vue-ecosystem-skills.

    181 GitHub stars~2.2k tokensUpdated 15 days ago
    Game DevelopmentAuto-check passed
  • Ship Web Games

    nirholas/three.ws

    Package, deploy, and verify a playable Three.js or web game.

    226 GitHub starsUsed in 1 repo~284 tokens
    Game DevelopmentAuto-check passed
  • Browser Viz Verify

    automateyournetwork/netclaw

    Verifies that a NetClaw-generated visualization HTML file (three.js, canvas, drawio, UML, markmap) actually renders correctly — screenshot, console-error check, and an optional Lighthouse audit.

    674 GitHub stars~1.5k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed

More from valkor-ai/loom

All 17 skills in this repo
  • Build and iterate playable Three.js game systems: starter scaffold, architecture, design briefs, core loops, level and encounter design, entities, input, camera, collision and physics, scoring…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Threejs 3D Generator

    valkor-ai/loom

    Generate, texture, rig, animate, stylize, convert, and download 3D assets for Three.js games via the Tripo API.

    1.2k GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check passed
  • Generate and edit 2D image assets for Three.js games with Google's Gemini image API: concept sheets, image-to-3D inputs, texture and material references, sky and background plates, decals, logos…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Threejs Game Director

    valkor-ai/loom

    Entrypoint for building, upgrading, and finishing Three.js browser games.

    1.2k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Generate, convert, clean, and integrate audio for Three.js browser games with ElevenLabs: sound effects, looping ambience, UI sounds, impact/weapon/vehicle audio, creature and boss stingers…

    1.2k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Threejs QA Release

    valkor-ai/loom

    Verify and release Three.js browser games: playtest QA, automated bot playtests, mobile and responsive checks, production builds, static-hosting base paths, debug gating, bundle review, screenshots…

    1.2k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

Works with

Questions about Threejs Debug Profiler

What does Threejs Debug Profiler do?

Debug and profile Three.js browser games: blank canvases, render and runtime bugs, asset and audio loading, animation, resize, mobile input, plus performance profiling of draw calls, triangles…. Threejs Debug Profiler is an agent skill from valkor-ai/loom.js browser games: blank canvases, render and runtime bugs, asset and audio loading, animation, resize, mobile input, plus performance profiling of draw calls, triangles, textures, memory, shader and post-processing cost, and bundle size.

When should I use Threejs Debug Profiler?

Threejs Debug Profiler fits situations like: tasks that involve 3D graphics and WebGL; tasks that involve Performance optimization.

How do I install Threejs Debug Profiler in Claude Code?

Run `npx skills add valkor-ai/loom --skill threejs-debug-profiler -a claude-code`. Or copy the skill folder (plugins/shared/loom/skills/threejs/threejs-debug-profiler in valkor-ai/loom) into .claude/skills/threejs-debug-profiler in your project. Claude Code loads it when a task matches its description.

How do I install Threejs Debug Profiler in Codex?

Run `npx skills add valkor-ai/loom --skill threejs-debug-profiler -a codex`. Or copy the skill folder (plugins/shared/loom/skills/threejs/threejs-debug-profiler in valkor-ai/loom) into .agents/skills/threejs-debug-profiler in your project. Codex loads it when a task matches its description.

Can I use Threejs Debug Profiler in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add valkor-ai/loom --skill threejs-debug-profiler -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/threejs-debug-profiler, .gemini/skills/threejs-debug-profiler, .github/skills/threejs-debug-profiler and .opencode/skills/threejs-debug-profiler in your project.

What does Threejs Debug Profiler need to run?

SKILL.md names no scripts, command-line tools or credentials: Threejs Debug Profiler is instructions for the agent only.

Does Threejs Debug Profiler access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Threejs Debug Profiler safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Threejs Debug Profiler use?

Threejs Debug Profiler is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Threejs Debug Profiler use?

About 602 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Threejs Debug Profiler?

Skills that share tags, products or a category with Threejs Debug Profiler: Optimize Performance (textura-agency/next16-claude-starter, 132 stars), Threejs Debug Profiler (mintdotgg/mint-threejs-skills, 114 stars), Vtj Anti Patterns (hexianWeb/Third-Person-MC, 194 stars) and Tresjs Core Skilld (skilld-dev/vue-ecosystem-skills, 181 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Threejs Debug Profiler?

valkor-ai (a GitHub organization) maintains it in valkor-ai/loom, which has 1,192 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

Source: valkor-ai/loom on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.