Agent skill

Threejs App Director

by mintdotgg in mintdotgg/mint-threejs-skills

Build and upgrade general Three.js apps including model and material viewers, configurators, walkthroughs, simulations, visualizations, editors, showcases, and interactive experiences.

MITAuto-check passedGame Development

Install Threejs App Director

skills CLI
$ npx skills add mintdotgg/mint-threejs-skills --skill threejs-app-director -a claude-code

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

GitHub CLI
$ gh skill install mintdotgg/mint-threejs-skills threejs-app-director --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/mintdotgg/mint-threejs-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mint-threejs-skills/skills/threejs-app-director .claude/skills/threejs-app-director && 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-app-director
GitHub stars
114
Token cost
~1.2k tokens
SKILL.md length
544 words
Files
21 (incl. scripts, references, assets)
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Build and upgrade general Three.js apps including model and material viewers, configurators, walkthroughs, simulations, visualizations, editors, showcases, and interactive experiences.

  • Works in 9 steps: Inspect the existing stack, scene… → Define the app brief: user goal, primary… → If the work needs Mint assets, resolve… → …
  • Tasks that involve 3D graphics and WebGL
  • SKILL.md covers Route The Work, Workflow, Asset Viewer Scaffold and Completion Gates, plus 1 more section
  • Runs TypeScript scripts from its folder; calls python3

What it does

Threejs App Director is an agent skill from mintdotgg/mint-threejs-skills. Build and upgrade general Three.js apps including model and material viewers, configurators, walkthroughs, simulations, visualizations, editors, showcases, and interactive experiences.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 24 other files, including scripts, reference files and assets (for example `assets/threejs-vite-asset-viewer/package.json`, `assets/threejs-vite-asset-viewer/src/asset-manifest.ts` and `assets/threejs-vite-asset-viewer/src/main.ts`).

It sits in Game Development, covering 3D graphics and WebGL. It works with Three.js. The repository describes itself as: Agent guidance for building polished Three.js apps and games with Mint MCP. The licence is MIT.

When your agent uses it

  • Tasks that involve 3D graphics and WebGL

Example prompts

  • “/threejs-app-director”

Requirements

  • Python 3
  • Node.js

Workflow steps

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

  1. Inspect the existing stack, scene lifecycle, assets, interactions, UI, data
  2. Define the app brief: user goal, primary 3D subject, essential interactions,
  3. If the work needs Mint assets, resolve one Mint Project for the local
  4. Establish one owner for renderer, scene, camera, animation frame, resize,
  5. Use Mint MCP through ../../references/mint-mcp-assets.md when production
  6. Implement the smallest complete user journey before secondary polish.
  7. Apply visual systems and interaction guidance appropriate to the archetype.
  8. Reproduce and measure defects or performance issues before optimizing.
  9. Follow ../../references/verification-policy.md: run the automatic minimum,

What it can do on your machine

Read from SKILL.md and the folder at commit de7af44. 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

    Ships 1 file in scripts/ (TypeScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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 App Director loads about 1.2k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 51 tokens; SKILL.md has 544 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~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); the scripts in this folder are not scanned.

SKILL.md

The full file from mintdotgg/mint-threejs-skills at commit de7af44, republished under its MIT licence (© mintdotgg). 544 words, ~1,208 tokens.

Download SKILL.mdSave it as .claude/skills/threejs-app-director/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.
name
threejs-app-director
description
Build and upgrade general Three.js apps including model and material viewers, configurators, walkthroughs, simulations, visualizations, editors, showcases, and interactive experiences.

Three.js App Director

Own the complete non-game 3D application outcome. Do not invent game objectives, scoring, failure, or progression unless the experience genuinely needs them.

Read references/app-patterns.md for the matching application archetype. For a fresh model, animation, asset-pack, material, material-pack, or Mint-world delivery whose asset is the requested product, read ../../references/asset-viewer.md and start from the packaged Asset Viewer scaffold. For imported-model orientation, manipulation, simulation, terrain, or other spatially complex work, read ../../references/spatial-contracts.md.

Route The Work

NeedSkill
Models, composition, materials, lighting, shaders, VFX../threejs-visual-systems/SKILL.md
Cameras, controls, picking, selection, configuration, manipulation, UI../threejs-interaction-systems/SKILL.md
Rendering, loading, input bugs, profiling, optimization../threejs-debug-profiler/SKILL.md
Browser QA, visual regression, production release../threejs-qa-release/SKILL.md
Game mechanics or game feel inside a mixed experience../threejs-gameplay-systems/SKILL.md

Workflow

  1. Inspect the existing stack, scene lifecycle, assets, interactions, UI, data ownership, loading states, target devices, and deployment constraints.
  2. Define the app brief: user goal, primary 3D subject, essential interactions, camera/control model, state or data flow, loading/error behavior, outputs, and performance budget.
  3. If the work needs Mint assets, resolve one Mint Project for the local codebase through ../../references/mint-project-workspaces.md. Infer its name from the app brief when no association or explicit destination exists.
  4. Establish one owner for renderer, scene, camera, animation frame, resize, asset lifecycle, and disposal.
  5. Use Mint MCP through ../../references/mint-mcp-assets.md when production assets are needed. Register ordinary artifacts and remote world runtime configuration in the project-root mint-assets.json through ../../references/asset-pipeline.md; stream world RAD manifests through ../../references/mint-world-splats.md.
  6. Implement the smallest complete user journey before secondary polish.
  7. Apply visual systems and interaction guidance appropriate to the archetype.
  8. Reproduce and measure defects or performance issues before optimizing.
  9. Follow ../../references/verification-policy.md: run the automatic minimum, then offer a scoped desktop/browser QA pass. Treat mobile as a separate approval.

Asset Viewer Scaffold

For a greenfield asset-delivery viewer, create the canonical vanilla Three.js project:

bash
python3 <this-skill-dir>/scripts/create_threejs_asset_viewer.py ./my-asset-viewer

Use --force only when overwriting the target is intended. Configure src/asset-manifest.ts from the synchronized mint-assets.json; do not replace the scaffold's model, animation, material, pack, or RAD session with a bespoke scene unless the user requested a broader application.

Show full SKILL.md (204 more words)Show less

Completion Gates

  • Build/typecheck or the nearest compile gate passes.
  • Focused non-browser tests for changed logic pass when available.
  • Referenced project-local assets and changed imports resolve.
  • mint-assets.json records every integrated Mint artifact or remote world runtime under a stable logical key and records the validated Mint Project.
  • Report that extended browser QA was not run unless the user approved it.

After the user approves the relevant QA scope:

  • The primary user journey works through real input.
  • Camera and controls match the task and do not fight each other.
  • Loading, empty, unsupported, and error states are handled when applicable.
  • Selection, configuration, manipulation, playback, or navigation state has one owner and visible feedback.
  • Assets load from stable local paths or the deliberate remote world runtime with correct scale, orientation, materials, animation, bounds, and disposal.
  • Desktop behavior is verified; mobile behavior is verified only under its separate approval.
  • Build/typecheck, browser errors, canvas pixels, screenshots, and changed risky paths pass.
  • Visual quality and renderer cost meet the requested bar.

Final Response

Lead with the implemented user journey. Report controls, state ownership, changed files, Mint links and artifact paths, screenshots, verification, performance evidence, deployment assumptions, and remaining risks. Explicitly name the extended desktop and mobile QA that was not run.

© mintdotgg, MIT. 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 20 other files (scripts, references, assets) in skills/mint-threejs-skills/skills/threejs-app-director of mintdotgg/mint-threejs-skills.

  • SKILL.md
  • assets/threejs-vite-asset-viewer/.gitignore
  • assets/threejs-vite-asset-viewer/index.html
  • assets/threejs-vite-asset-viewer/package.json
  • assets/threejs-vite-asset-viewer/src/asset-manifest.ts
  • assets/threejs-vite-asset-viewer/src/main.ts
  • assets/threejs-vite-asset-viewer/src/styles.css
  • assets/threejs-vite-asset-viewer/src/viewer/dispose.ts
  • assets/threejs-vite-asset-viewer/src/viewer/gltf-runtime.ts
  • assets/threejs-vite-asset-viewer/src/viewer/material-session.ts
  • assets/threejs-vite-asset-viewer/src/viewer/model-session.ts
  • assets/threejs-vite-asset-viewer/src/viewer/types.ts
  • assets/threejs-vite-asset-viewer/src/viewer/world-session.ts
  • assets/threejs-vite-asset-viewer/src/vite-env.d.ts
  • assets/threejs-vite-asset-viewer/tsconfig.json
  • assets/threejs-vite-asset-viewer/vite.config.ts
  • references
  • … and 4 more

Open the folder on GitHubat commit de7af44

Compare with similar skills

Threejs App Director 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 App Director compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Threejs App Director this skillmintdotgg/mint-threejs-skills114—~1.2kAutomated safety check: PassMIT
Image to Three.js Modelimg2threejs/img2threejs18k1 repos~8.2kAutomated safety check: PassApache-2.0
Web CloneJane-xiaoer/claude-skill-web-clone1k2 repos~2.7kAutomated safety check: PassMIT
Threejs Game Directormajidmanzarpour/threejs-game-skills2.4k—~2.2kAutomated safety check: PassMIT
Threejs Gameplay Systemsvalkor-ai/loom1.2k1 repos~1.4kAutomated safety check: PassApache-2.0
Threejs World Generationcalesthio/OpenMontage65k—~2kAutomated safety check: PassAGPL-3.0

Similar skills

  • Image to Three.js Model

    img2threejs/img2threejs

    Rebuilds the object in a reference image as a procedural, animation-ready Three.js model written entirely in code, using staged sculpting with quality checks.

    18k GitHub starsUsed in 1 repo~8.2k tokens
    Game DevelopmentAuto-check passed
  • Web Clone

    Jane-xiaoer/claude-skill-web-clone

    网站复刻 / 克隆方法论。USE WHEN 用户说 复刻网站、克隆网站、clone website、抄个站、仿站、 照着这个站做一个、reproduce site、还原某个网页效果、把这个站搬下来改成我的、 复刻某个交互/WebGL/Canvas/Three.js 效果。提供「先拿真源码 → 判路径 → 逆向拆解 → 搭工程 → 替换内容」的可移植决策树,覆盖静态站 /…

    1k GitHub starsUsed in 2 repos~2.7k tokens
    Game DevelopmentAuto-check passed
  • Threejs Game Director

    majidmanzarpour/threejs-game-skills

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

    2.4k GitHub stars~2.2k tokensUpdated 10 days ago
    Game DevelopmentAuto-check passed
  • 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
    Game DevelopmentAuto-check passed
  • Threejs World Generation

    calesthio/OpenMontage

    Build deterministic, editable, free-viewpoint Three.js worlds from text or structured briefs.

    65k GitHub stars~2k tokensUpdated 5 days ago
    Game DevelopmentAuto-check passed
  • 3Dviz Pro Max Scene Builder

    viettranx/3dviz-pro-max

    Guides building an expressive 3D scene in Three.js or Blender by reasoning through intent, object construction and scientific grounding before using a catalog of recipes and kits.

    683 GitHub stars~2.8k tokensUpdated 27 days ago
    Game DevelopmentAuto-check passed

More from mintdotgg/mint-threejs-skills

All 9 skills in this repo
  • Threejs Gameplay Systems

    mintdotgg/mint-threejs-skills

    Design and implement playable Three.js game loops, architecture, controls, cameras, physics, levels, encounters, audio hooks, feedback, and game feel.

    114 GitHub stars~677 tokensUpdated 2 mo ago
    Auto-check passed
  • Threejs QA Release

    mintdotgg/mint-threejs-skills

    Verify and release Three.js apps and games through primary-journey QA, desktop/mobile visual checks, canvas metrics, visual regression, optional game bot playtests, production previews, and…

    114 GitHub stars~856 tokensUpdated 2 mo ago
    Auto-check passed
  • Threejs Game Director

    mintdotgg/mint-threejs-skills

    Build or upgrade complete Three.js browser games by coordinating gameplay, Mint MCP assets, graphics, UI, debugging, performance, QA, and release.

    114 GitHub stars~1.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Mint Threejs Skills

    mintdotgg/mint-threejs-skills

    Build, revise, debug, and verify browser-based Three.js apps, games, asset viewers, model and asset-pack deliveries, material and material-pack deliveries, animated-model viewers, and explicitly…

    114 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Threejs Visual Systems

    mintdotgg/mint-threejs-skills

    Build and upgrade Three.js visual systems for apps and games using Mint MCP assets, authored geometry, materials, lighting, shaders, VFX, technical art, and measured performance.

    114 GitHub stars~816 tokensUpdated 2 mo ago
    Auto-check passed
  • 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
    Auto-check passed

Works with

Questions about Threejs App Director

What does Threejs App Director do?

Build and upgrade general Three.js apps including model and material viewers, configurators, walkthroughs, simulations, visualizations, editors, showcases, and interactive experiences. Threejs App Director is an agent skill from mintdotgg/mint-threejs-skills.js apps including model and material viewers, configurators, walkthroughs, simulations, visualizations, editors, showcases, and interactive experiences.

When should I use Threejs App Director?

Threejs App Director fits situations like: tasks that involve 3D graphics and WebGL.

How do I install Threejs App Director in Claude Code?

Run `npx skills add mintdotgg/mint-threejs-skills --skill threejs-app-director -a claude-code`. Or copy the skill folder (skills/mint-threejs-skills/skills/threejs-app-director in mintdotgg/mint-threejs-skills) into .claude/skills/threejs-app-director in your project. Claude Code loads it when a task matches its description.

How do I install Threejs App Director in Codex?

Run `npx skills add mintdotgg/mint-threejs-skills --skill threejs-app-director -a codex`. Or copy the skill folder (skills/mint-threejs-skills/skills/threejs-app-director in mintdotgg/mint-threejs-skills) into .agents/skills/threejs-app-director in your project. Codex loads it when a task matches its description.

Can I use Threejs App Director 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 mintdotgg/mint-threejs-skills --skill threejs-app-director -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-app-director, .gemini/skills/threejs-app-director, .github/skills/threejs-app-director and .opencode/skills/threejs-app-director in your project.

What does Threejs App Director need to run?

Going by SKILL.md and its folder, Threejs App Director needs TypeScript for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3; Node.js.

Does Threejs App Director 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 App Director 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Threejs App Director use?

Threejs App Director is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Threejs App Director use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 834 tokens, read only when the agent opens those files.

What are the alternatives to Threejs App Director?

Skills that share tags, products or a category with Threejs App Director: Image to Three.js Model (img2threejs/img2threejs, 18k stars), Web Clone (Jane-xiaoer/claude-skill-web-clone, 1k stars), Threejs Game Director (majidmanzarpour/threejs-game-skills, 2.4k stars) and Threejs Gameplay Systems (valkor-ai/loom, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Threejs App Director?

mintdotgg (a GitHub organization) maintains it in mintdotgg/mint-threejs-skills, which has 114 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on August 1, 2026.

Source: mintdotgg/mint-threejs-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.