SkillAgentSearch skills...

crucible

3D engine that AI agents drive

Install / Use

claude mcp add codepawl -- npx -y github:codepawl/crucible

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

85/100

Category

Other

Supported Platforms

Claude Code
Claude Desktop

Tags

Our assessment of crucible

crucible scores 85/100 on our quality scale, 200th of 329 Other skills we index.

Its MCP Server is 19 KB long, well organised into 14 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.

It has 692 GitHub stars, a meaningful sign that others use it.

Substance
30/30
Structure
20/20
Description
8/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so crucible is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 95/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

crucible compared with similar skills

All 4 of these similar skills score higher than crucible; compare them before choosing.

SkillScoreStarsUpdatedFormat
crucible (this skill)by codepawl85692todayMCP Server
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install crucible?
Run claude mcp add codepawl -- npx -y github:codepawl/crucible. The install tabs above show the steps for each supported agent.
Which AI agents does crucible work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is crucible safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 95/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is crucible still maintained?
The repository was last updated today, so crucible is actively maintained.
<p align="center"> <a href="https://crucible.codepawl.com"><img src="https://crucible.codepawl.com/previews/hero-classroom.webp" alt="A sunlit classroom with wooden desks and chairs, a chalkboard and tall windows with blinds, path traced by Crucible" width="100%"></a> <br> <sub>Classroom by Christophe Seux, CC0, from the Blender demo files, path traced in Crucible with Cook</sub> </p> <p align="center"> <a href="https://www.npmjs.com/package/@codepawlhq/crucible"><img alt="npm version" src="https://img.shields.io/npm/v/@codepawlhq/crucible?style=flat-square&label=npm&color=7CC765&labelColor=0A1D1A"></a> <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-E9F5F0?style=flat-square&labelColor=0A1D1A"></a> <img alt="Node.js 20.19 or later" src="https://img.shields.io/badge/node-%E2%89%A520.19-4DB6FF?style=flat-square&labelColor=0A1D1A"> <img alt="MCP server for agents" src="https://img.shields.io/badge/agents-MCP%20server-F7C948?style=flat-square&labelColor=0A1D1A"> </p>

Crucible is a 3D engine for JavaScript that an AI agent drives through an MCP server. It makes 3D easy to understand and easy to do.

67js → Crucible. 67js is the old name. The @codepawlhq/67js package is deprecated: install @codepawlhq/crucible instead. Old 67js.codepawl.com links redirect here.

The agent knows every part of Crucible and carries the heavy steps. It builds the scene, lights it, checks the preview and renders the result. You keep the creative choices and stay in the loop, because the agent shows previews and asks when a matter of taste is open.

Scenes built with Crucible open live in the browser on the showcase.

What it is

Crucible is a 3D engine for AI agents and for pages. It has a real-time rasterizer, a path tracer, addons for terrain, vegetation, characters, liquid, vehicles and media export, and an MCP server. A scene is plain data: each part has a geometry, a matrix and a material.

An agent builds and changes a scene through the MCP server, looks at PNG previews and renders stills or MP4 video. The goal is to be as capable as Blender and as light as three.js. docs/goal.md defines each part. See the documentation, the guide for agents and the FAQ.

Install

Let your agent do it. Paste this prompt into Claude Code, Codex, Cursor, Gemini CLI or OpenCode. The agent installs the package, reads the guide and connects the MCP server.

Install Crucible from npm as `crucible@npm:@codepawlhq/crucible` and connect its MCP server with `npx crucible-mcp`. Read
https://crucible.codepawl.com/llms.txt first and follow it.

Claude Code plugin. One command adds the MCP server and both skills.

/plugin marketplace add codepawl/crucible
/plugin install crucible@crucible

By hand

npm install crucible@npm:@codepawlhq/crucible

The registry name is @codepawlhq/crucible, and the alias crucible keeps imports short. The package is ESM and needs Node.js 20.19 or later. Glaze and the WebGL2 path tracer need a WebGL2 browser, and the WebGPU backends need WebGPU.

A new minor version ships about once a week. Before 1.0, a minor version can change the API, and CHANGELOG.md lists each change. npx keeps the copy it downloaded first. To update, run npm install crucible@npm:@codepawlhq/crucible@latest or npx -y -p @codepawlhq/crucible@latest crucible-mcp.

Quick start

import { CrucibleRenderer, box, sphere } from 'crucible';

// Column-major 4x4 matrix: scale, then move.
const placed = ([x, y, z], [width, height, depth] = [1, 1, 1]) =>
  new Float32Array([width, 0, 0, 0, 0, height, 0, 0, 0, 0, depth, 0, x, y, z, 1]);

const parts = [
  {
    name: 'Floor',
    geometry: box(),
    matrix: placed([0, 0, 0], [8, 0.1, 8]),
    material: { color: [0.4, 0.42, 0.45], metallic: 0, roughness: 0.9, emission: 0 },
  },
  {
    name: 'Ball',
    geometry: sphere(48, 24),
    matrix: placed([0, 1, 0]),
    material: { color: [0.8, 0.3, 0.2], metallic: 0, roughness: 0.35, emission: 0 },
  },
];

const canvas = document.querySelector('canvas');
const renderer = new CrucibleRenderer(canvas, parts, { samples: 4, memoryBudgetMiB: 256 });
renderer.render({ eye: [4, 3, 6], target: [0, 1, 0] });

Call renderer.updateParts(parts) to move or recolour parts without a new upload. Call renderer.resize() after the canvas changes size, and renderer.dispose() before you replace the renderer. The guide covers cameras, lights, effects and every material field. To save a PNG from a script, use the render-from-a-script recipe.

For agents

The package includes an MCP server that connects an agent to a persistent browser renderer. The server needs a local Chrome installation.

npx crucible-mcp --backend gpu --memory 192

--backend gpu renders with hardware WebGL2 through Chrome. Use --backend cpu on a machine without a GPU. With bun, bunx crucible-mcp takes the same flags; CI runs the packaged server under bun on every pull request. An agent authors a JSON recipe, sets lights and fog, imports GLB assets and adds motion. It gets PNG previews back, compares up to four views in a review grid and runs render jobs for stills and MP4 video. The server accepts no arbitrary code and no remote asset URLs. The MCP reference lists its tools.

Two skills teach an agent to drive the MCP tools: build-crucible-scene for scenes and materials, and render-crucible-media for image and video export. For a plain-text guide, give the agent llms.txt.

viz3d uses Crucible. It is a skill that turns places, systems and events into 3D apps and films, and it renders its films and stills in Crucible. To add it in Claude Code, run /plugin marketplace add codepawl/viz3d, then /plugin install visualize-in-3d@codepawl.

Render images and video

The render command exports a scene to PNG or MP4 through headless Chrome, on the GPU or on the CPU.

npm run render -- --kind image --scene nature --backend gpu --preset high --output artifacts/nature.png

Video export streams one frame at a time, so a film never sits in memory. The render skill lists every preset and flag.

Addons

Each addon is a separate import, so a page loads only what it uses.

| Area | Import | Guide | | --- | --- | --- | | Lighting | crucible/addons/hdri | Image-based lighting from .hdr files | | Terrain | crucible/addons/terrain, crucible/addons/texture-set | Chunked terrain with scanned ground layers | | Vegetation | crucible/addons/vegetation, crucible/addons/grass, crucible/addons/clutter | Trees, grass and ground clutter with wind and level of detail | | Characters | crucible/addons/gltf, crucible/addons/retarget, crucible/addons/skeleton-pose | glTF import, clip retargeting and pose layers with IK | | Liquid | crucible/addons/spume | Baked liquid playback with refraction and spray | | Vehicles | crucible/addons/vehicle | Wheeled vehicles on a path | | Physics | crucible/addons/physics | Rapier contacts and joints recorded into a timeline | | Live games | crucible/addons/runtime | Game loop with fixed or variable steps and pluggable systems | | Live games | crucible/addons/input | Input: keyboard, mouse, gamepad, touch, device motion, replay and custom sources mapped to named actions and axes | | Live games | crucible/addons/streaming | Streaming: loader plugins, distance and request loading, a byte budget with LRU eviction and LOD with hysteresis | | Live games | crucible/addons/netcode | Netcode: server or host authority, pluggable transports, delta snapshots, client prediction with reconciliation and remote interpolation | | Live games | crucible/addons/physics-runtime | Live physics: a physics world stepped in the game loop, contact and sensor events, ray, shape and overlap queries | | Live games | crucible/addons/physics-jolt | Jolt engine: a second engine for live physics, with the same events and queries; needs the optional jolt-physics package | | Live games | crucible/addons/audio | Spatial audio: sounds on nodes, played from contacts, markers and input, with buses and a limiter | | Live games | crucible/addons/animation-graph | Animation graph: states, 1D and 2D blend spaces, parameter transitions with crossfades and masked layers for any rig | | Live games | crucible/addons/player | Player: character, vehicle and flight controllers, follow, first-person, top-down, orbit, chase and side-scroller camera rigs with wall pull-in, custom kinds, swappable at runtime | | Live games | crucible/addons/game-rules | Game rules: a JSON rule document of variables, triggers and actions, played as a runtime system | | Live games | crucible/addons/game | Game: a scene recipe with a game section played in a page, and the scene_export_web MCP tool that writes it as a static web build | | Modeling | crucible/addons/mesh, crucible/addons/modeling, crucible/addons/sculpt | Mesh editing, modeling and sculpt brushes | | Offline light | crucible/addons/path-tracer, crucible/addons/light-bake | Path-traced stills and baked lightmaps | | Post passes | crucible/addons/user-pass | Your own full-screen GLSL passes: dither, pixel downscale, quantise | | Agents | crucible/addons/agent-scene, crucible/addons/agent-asset | Scene sessions with revisions and checkpoints |

The documentation page lists every guide.

Renderers

| Name | What it is | Runs on | | --- | --- | --- | | Glaze (CrucibleRenderer) | The real-time rasterizer | WebGL2 | | Cook | The path tracer, one still per job | CPU (default), WebGL2, Vulkan ray queries through the optional Cook package (@codepawlhq/cook), and WebGPU (opt-in, library only) | | Real-time path tracer | A hybrid tracer with a radiance cache and a temporal denoiser. It is experimental, and the MCP server does not expose it | WebGPU, with a WebGL2 fallback | | Light bake | Baked lightmaps | CPU, WebGL2 and WebGPU |

The WebGPU backend of Cook traces a BVH in WGSL compute, because browsers have no hardware ray tracing. MCP render jobs take the Cook backends cpu, gpu and native only.

Quality tiers

The roadmap in issue 890 groups the renderers into four tiers. The tier names are working names. The quality setting that picks a tier is planned ([issue 904](https://github.com/codepawl/crucible/issues

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars692
CategoryOther
Updated6h ago
Forks54

Languages

JavaScript

Trust signals

95/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low