Mint Three.js Skills
A Three.js skill that guides an agent through 3D apps, configurators and games and orders models and materials from Mint MCP.
- 126 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The agent calls Mint MCP to generate assets, creates a project there, downloads files into the repository and maintains `mint-assets.json` at the project root.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mint-three-js-skillsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent calls Mint MCP to generate assets, creates a project there, downloads files into the repository and maintains `mint-assets.json` at the project root.
This is third-party code. Review the repository files before installing.
What it does
Mint Three.js Skills is a skill suite for Claude Code, Cursor and Codex that guides an agent through building, debugging and verifying browser-based 3D apps and games on Three.js. The main `SKILL.md` picks a route: a viewer for generated models and materials, a general 3D app or configurator, or a game with objectives and failure. Eight specialist skills sit inside: app director, game director, visual systems, interaction, gameplay systems, game UI, debugging with profiling, and release QA. The skill orders models, materials, animation and audio from Mint MCP, a separate asset-generation server, and records them in the project through the `mint-assets.json` registry. GLB files from Mint are Draco-compressed, so the project loader has to support Draco. The agent runs the build and tests on its own and starts extended browser QA only after you agree.
Who it is for. Developers of web games, configurators and 3D showcases on Three.js who would rather order models and materials from Mint MCP than build them by hand.
Good fit when
- You need a viewer for one generated model or an asset pack with file downloads.
- A product configurator with material variants, annotations and camera presets is built on Three.js from scratch.
- A Three.js game needs a loop with an objective, failure and progression, and the agent needs game-making practices.
- An existing Three.js project needs repair: its interface, rendering and user journey.
Not a fit when
- The project runs on another engine, such as Unity or Babylon.js: the skill targets browser Three.js scenes.
- You need a 2D game or a native app.
- Object descriptions cannot be sent to an external generation service.
Example request
Use Mint Three.js Skills and Mint MCP to build a responsive product configurator with material variants, annotations and camera presets.Limitations
Mint MCP generates the assets and is connected separately following the instructions at https://mcp.mint.gg. Without it the skill works with procedural and your own assets. Mint models are Draco-compressed, so a plain GLTF loader cannot open them. Mint MCP calls stay in agent tooling and never enter the app browser code. Extended browser QA and a separate mobile check run only after confirmation. The last commit in the repository dates to August 2026.
How to disable. Remove the skill folder from the agent skills directory and disable Mint MCP in its settings. The `mint-assets.json` file and downloaded assets stay in the project, so delete them by hand.
FAQ
Does the skill need Mint MCP?
For generating models, materials and audio, yes. Without it the agent uses procedural or your own assets, because the skill allows that path when MCP lacks a capability.
How do I install the skill in Cursor?
Run `npx skills add mintdotgg/mint-threejs-skills -a cursor -g -y`. Use `claude-code` instead of `cursor` for Claude Code, and `codex` for Codex.
What is the mint-assets.json file for?
It holds the registry of generated assets and the Mint project id so later generations land in the same project. The `scripts/sync-mint-assets.mjs` script maintains it.
Why can a plain GLTFLoader not open Mint models?
The GLB files are Draco-compressed, so a shared loader with Draco support is required. The requirements are written in `references/gltf-runtime-compatibility.md`.
Which checks does the skill run by itself?
The project build or type check, existing logic tests and a check that asset paths resolve. The agent starts a browser, Playwright, screenshots and mobile QA only after you agree.
Discussion
No questions or reviews yet.
Related
SkillsThree.js Awesome Graphics Skills
threejs-awesome-graphics-agent-skills
A three.js skills pack for great scene and game graphics: lighting, PBR, shaders, TSL and WebGPU, post-processing, particles
Ten reference skills for Three.js: scene setup, geometry, materials, lighting, shaders, animation and post-processing
Eight skills for 3D and animated websites: three.js scenes from code, scroll films, transparent video, exploded machine views
Three.js Architecture Effects
threejs-architecture-effects
A skill building an orbitable Three.js building that assembles itself: brick, frame, procedural materials. The result is a working Vite and React site
The skill leads an agent from user goals to Material Design 3 tokens and components: theming, adaptivity, accessibility, review.
A skill for building WebGPU apps on Three.js with TSL shaders: renderer setup, node materials, compute shaders, post-processing
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Mint Three.js Skills (this card) | no | 126 | |
| Three.js Skills | no | 4,143 | ten reference skills for Three.js with no asset generation; Mint Three.js Skills adds task routing and ordering models from Mint MCP |
| Three.js Awesome Graphics Skills | no | 990 | a pack of skills on lighting, shaders and post-processing; Mint Three.js Skills covers whole app or game development and asset tracking |
README in short
The README is short: pick an agent and install command, connect Mint MCP, and use three prompt templates for a general 3D app, a game and an existing project. The skill combines three open source Three.js skill projects and generalizes them beyond games.
README badge
Original SKILL.md
--- name: mint-threejs-skills description: 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 requested Gaussian-splat worlds with Mint MCP as the production asset pipeline. --- # Mint Three.js Skills Mint's agent skill suite for browser-based Three.js work. It combines and adapts open source Three.js game, application, and graphics-agent workflows, generalized for 3D apps while retaining deep game workflows. ## Choose A Route - Fresh request whose primary deliverable is one generated model, an animated model, a coherent model asset pack, one material, a material pack, or one explicitly requested Mint world: read `references/asset-viewer.md`, then use the app director. The asset is the product; the viewer is its inspection and download shell. - General 3D app, viewer, configurator, simulation, walkthrough, editor, or interactive experience: read `skills/threejs-app-director/SKILL.md`. - Game or game-like request with objectives, challenge, scoring, failure, progression, or game feel: read `skills/threejs-game-director/SKILL.md`. - Mixed experience: start with the app director, then add only the relevant game specialists. Both routes share visual systems, interaction, debugging, QA, and `references/mint-mcp-assets.md`. Before the first Mint MCP write for a codebase, read `references/mint-project-workspaces.md` to resolve one Mint Project for the work. Projects that use Mint assets also use the durable registry in `references/asset-pipeline.md`. Existing app or game context wins over asset delivery. Generate and integrate a requested asset into that project instead of scaffolding a separate viewer. ## Invariants - Existing project architecture wins. For greenfield work, default to TypeScript, Vite, and Three.js modules. - Vanilla Three.js is the default; support React Three Fiber or another Three.js-based stack when the project or user chooses it. - Mint MCP is the only generated-asset production pipeline. Keep MCP calls out of browser runtime code. - Distinguish the local code project (the folder or repository being edited) from its Mint Project (the remote workspace that owns Mint chats and assets). Resolve or create the Mint Project once, persist it in `mint-assets.json`, and