Skip to content
Back to search

instruktlabs

MarketplaceWorks with Claude CodeGitHub

Instrukt Labs developer tools, including Kiln for editable 3D assets.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/instruktlabs/kiln with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/instruktlabs/kiln'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/instruktlabs--kiln/badge.svg)](/listings/instruktlabs--kiln)

HTML

<a href="/listings/instruktlabs--kiln"><img src="/api/listings/instruktlabs--kiln/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Use Node.js 22 or 24 LTS and npm. See [supported versions and platforms](docs/install.md) for the complete compatibility range. Bun is only needed to work on Kiln itself.

mkdir kiln-install
cd kiln-install
npm init -y
npm install @instruktlabs/kiln
npx --offline --no -- kiln-init ../my-assets --harness codex
cd ../my-assets

Open your coding agent in `my-assets` and follow `START.md`. Choose `claude`, `codex`, `opencode`, `agy`, `hermes`, `copilot` or `cursor-agent` for `--harness`. Setup creates project-local instructions, skills, launchers and a `kiln_workspace` MCP connection. Keep this authoring workspace separate from the engine installation.

Then ask your agent for an asset:

> Create a low-poly camping lantern with a carry handle. Review it from several > angles, refine any problems, and save the editable source and a GLB.

For an **existing project**, Kiln 1.1+ supports a preview followed by adoption:

# Run from kiln-install; replace the path and harness for your project.
npx --offline --no -- kiln-init /absolute/path/to/my-project --adopt --harness codex --check
npx --offline --no -- kiln-init /absolute/path/to/my-project --adopt --harness codex

The preview writes nothing and exits 1 when changes are needed. Adoption preserves existing instructions and unrelated configuration, and reports conflicts before overwriting files. See [installation and upgrades](docs/install.md) for version availability, additional agents, repairs and plugin setup.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "instruktlabs",
  4. "description": "Instrukt Labs developer tools, including Kiln for editable 3D assets.",
  5. "owner": {
  6. "name": "Instrukt Labs"
  7. },
  8. "plugins": [
  9. {
  10. "name": "kiln-engine",
  11. "description": "Set up a pinned local Kiln engine and an asset workspace with MCP tools and authoring skills.",
  12. "author": {
  13. "name": "Instrukt Labs"
  14. },
  15. "category": "development",
  16. "source": "./plugins/kiln-engine"
  17. }
  18. ]
  19. }
README.md · README · 229 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Kiln
  2. [![CI](https://github.com/instruktlabs/kiln/actions/workflows/ci.yml/badge.svg)](https://github.com/instruktlabs/kiln/actions/workflows/ci.yml)
  3. [![npm](https://img.shields.io/npm/v/@instruktlabs/kiln)](https://www.npmjs.com/package/@instruktlabs/kiln)
  4. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  5. [![Discord](https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/fSWVbMdQXK)
  6. **Build and revise 3D assets with your coding agent.**
  7. Your agent writes JavaScript using Kiln's geometry and material helpers. Kiln runs
  8. the program, returns rendered views and structural checks, and exports a GLB.
  9. Keep the editable source to refine the asset later.
  10. Kiln runs locally through MCP, the CLI or a JavaScript/TypeScript SDK. It is free,
  11. open source and account-free. Your coding agent supplies the model; Kiln's tools
  12. do not require a separate model API key.
  13. [Documentation](https://kilnstudio.tools/docs/install/) ·
  14. [Gallery](https://kilnstudio.tools/gallery/) ·
  15. [Interactive scenes](https://kilnstudio.tools/scenes/) ·
  16. [Changelog](CHANGELOG.md)
  17. ## Made with Kiln
  18. <table>
  19. <tr>
  20. <td width="50%" align="center">
  21. <a href="https://holodeck.kilnstudio.tools/worlds/meridian-sanctuary/"><img src="https://raw.githubusercontent.com/instruktlabs/kiln/main/assets/readme/meridian-sanctuary.webp" alt="A marble causeway between mirror pools leading to Meridian Sanctuary's gate tower"></a><br>
  22. <a href="https://holodeck.kilnstudio.tools/worlds/meridian-sanctuary/"><strong>Meridian Sanctuary</strong></a>
  23. </td>
  24. <td width="50%" align="center">
  25. <a href="https://holodeck.kilnstudio.tools/worlds/crescent-cove/"><img src="https://raw.githubusercontent.com/instruktlabs/kiln/main/assets/readme/crescent-cove.webp" alt="The canopied Cove seat among palms overlooking Crescent Cove's lagoon"></a><br>
  26. <a href="https://holodeck.kilnstudio.tools/worlds/crescent-cove/"><strong>Crescent Cove</strong></a>
  27. </td>
  28. </tr>
  29. <tr>
  30. <td width="50%" align="center">
  31. <a href="https://holodeck.kilnstudio.tools/worlds/winter-mountainside-cabin/"><img src="https://raw.githubusercontent.com/instruktlabs/kiln/main/assets/readme/winter-mountainside-cabin.webp" alt="The timber cabin with its glazed gable, deck and stair among snow-covered firs and spruces"></a><br>
  32. <a href="https://holodeck.kilnstudio.tools/worlds/winter-mountainside-cabin/"><strong>Winter Mountainside Cabin</strong></a>
  33. </td>
  34. <td width="50%" align="center">
  35. <a href="https://kilnstudio.tools/scenes/cathedral-square/"><img src="https://raw.githubusercontent.com/instruktlabs/kiln/main/assets/readme/cathedral-square.webp" alt="The Gothic cathedral above its town square, surrounded by rows of stone and timber houses"></a><br>
  36. <a href="https://kilnstudio.tools/scenes/cathedral-square/"><strong>Cathedral Square</strong></a>
  37. </td>
  38. </tr>
  39. </table>
  40. Meridian Sanctuary, Crescent Cove and Winter Mountainside Cabin are walkable
  41. Holodeck worlds built with editable Kiln assets. In Kiln's Cathedral Square scene,
  42. walk from the town square into the nave, through stained-glass light and past
  43. the candlelit altar to the rear chapels.
  44. Editable assets: [Meridian (53)](https://kilnstudio.tools/packs/holodeck/meridian-sanctuary/) ·
  45. [Crescent Cove (49)](https://kilnstudio.tools/packs/holodeck/crescent-cove/) ·
  46. [Winter Cabin (56)](https://kilnstudio.tools/packs/holodeck/winter-mountainside-cabin/) ·
  47. [Cathedral Square (22)](https://kilnstudio.tools/packs/cathedral-square/).
  48. [Explore all Kiln scenes](https://kilnstudio.tools/scenes/), including
  49. [Golden Gate](https://kilnstudio.tools/scenes/golden-gate/), or visit
  50. [the full Holodeck world list](https://holodeck.kilnstudio.tools/#scenes).
  51. To make your own, see
  52. [text to 3D with your coding agent](https://kilnstudio.tools/text-to-3d/): a walking mech and a cathedral, prompt to GLB.
  53. Scene code and asset content retain their own licences; each pack records its scope.
  54. ## From asset to scene
  55. Watch one editable timber wall become part of a cabin kit. The short cut follows
  56. the saved Kiln models through shell assembly, furnishing and the loft staircase,
  57. then shows the finished cabin in its snowy Holodeck world.
  58. [![A timber wall and cabin kit assembling, the kitchen and loft being furnished, then the finished snowy Holodeck world](https://raw.githubusercontent.com/instruktlabs/kiln/main/assets/readme/cabin-construction.gif)](https://kilnstudio.tools/#workflow)
  59. The [full construction film](https://kilnstudio.tools/#workflow) shows the
  60. WebGPU assembly and the finished world.
  61. ## Used in live games
  62. I build Sheepdog Sim, OBJEKT 62 and ski sim alongside Kiln, and use these games
  63. to test Kiln-authored assets in real gameplay.
  64. | Sheepdog Sim | OBJEKT 62 | ski sim |
  65. | --- | --- | --- |
  66. | [![The sheepdog facing a fenced pen, with the farmhouse, red barn and trees behind it](site/src/assets/live-games/sheepdog-sim.webp)](https://sheepdogsim.com/) | [![The survey rifle overlooking an outpost, with a monument on the distant horizon](site/src/assets/live-games/objekt62.webp)](https://objekt62.com/) | [![A skier grinding sideways beside a lit chalet, with pines, trail lights and a chairlift in the background](site/src/assets/live-games/ski-sim-village.webp)](https://skisim.app/) |
  67. Sheepdog Sim's [source](https://github.com/matthew-kissinger/sds) shows how its
  68. Kiln-authored buildings, fencing and trees fit into a working game. OBJEKT 62 uses
  69. Kiln for weapons, vehicles and outpost modules; ski sim uses it for skiers,
  70. vegetation, village buildings and park equipment.
  71. ## Community and hosted access
  72. [Join the Kiln Discord](https://discord.gg/fSWVbMdQXK) to share assets, get help,
  73. and request hosted access. [Hosted Kiln](https://kiln.instruktlabs.com/) is open
  74. as a free, invite-only introductory service, with ten accounts sharing an
  75. allowance of 200 native requests per month. Ask in `#request-access` or message
  76. `matt_941`; individual Kiln codes are sent privately as capacity allows.
  77. Joining Discord does not automatically grant hosted access. Local Kiln remains
  78. free, open source and account-free.
  79. ## Install
  80. Use Node.js 22 or 24 LTS and npm. See [supported versions and platforms](docs/install.md)
  81. for the complete compatibility range. Bun is only needed to work on Kiln itself.
  82. ```sh
  83. mkdir kiln-install
  84. cd kiln-install
  85. npm init -y
  86. npm install @instruktlabs/kiln
  87. npx --offline --no -- kiln-init ../my-assets --harness codex
  88. cd ../my-assets
  89. ```
  90. Open your coding agent in `my-assets` and follow `START.md`. Choose `claude`,
  91. `codex`, `opencode`, `agy`, `hermes`, `copilot` or `cursor-agent` for `--harness`.
  92. Setup creates project-local instructions, skills, launchers and a `kiln_workspace`
  93. MCP connection. Keep this authoring workspace separate from the engine installation.
  94. Then ask your agent for an asset:
  95. > Create a low-poly camping lantern with a carry handle. Review it from several
  96. > angles, refine any problems, and save the editable source and a GLB.
  97. For an **existing project**, Kiln 1.1+ supports a preview followed by adoption:
  98. ```sh
  99. # Run from kiln-install; replace the path and harness for your project.
  100. npx --offline --no -- kiln-init /absolute/path/to/my-project --adopt --harness codex --check
  101. npx --offline --no -- kiln-init /absolute/path/to/my-project --adopt --harness codex
  102. ```
  103. The preview writes nothing and exits 1 when changes are needed. Adoption preserves
  104. existing instructions and unrelated configuration, and reports conflicts before
  105. overwriting files. See [installation and upgrades](docs/install.md) for version
  106. availability, additional agents, repairs and plugin setup.
  107. ## What you can do
  108. | Task | Kiln provides |
  109. | --- | --- |
  110. | Author and refine | Geometry helpers, named parts, immutable source revisions and anchored edits |
  111. | Vary | Declared parameters: one source builds other sizes, counts, options and colours |
  112. | Inspect | Multi-view renders, measurements and image-independent structural QA |
  113. | Save and reuse | A local asset library, revision history and portable source/GLB exports |
  114. | Review together | A local dashboard with materials, optional projects and Live Review |
  115. | Integrate | Shared CLI/MCP tools and compiled ESM with TypeScript declarations |
  116. Projects are optional. A single asset needs no pack, project record or hosted account.
  117. Use [Discovery](docs/tools.md) to find helpers rather than guessing API names.
  118. A program can [declare parameters](docs/programs.md#declared-parameters) with
  119. `defineParams`. The saved GLB is the default build, and `kiln render asset.kiln.js --sweep`
  120. builds each parameter at its extremes and reports what an exported file can carry without
  121. a rebuild: a colour, an option that shows or hides parts, a preset of colours and, with
  122. `kiln export --profile runtime --carry-shapes`, a size that moves in straight lines.
  123. Every other value is another build from the same source.
  124. A build also warns when faces of two parts lie on one plane and would flicker
  125. (`FLUSH_FACES`), with the place and the direction to move one of them.
  126. CPU rendering works without a GPU and is useful for geometry review. Material-faithful
  127. views use the optional local render service; texture and metallic appearance must be
  128. checked against the reported fidelity. See [rendering and materials](docs/rendering.md).
  129. Experimental implicit modeling and the alternative Three.js exporter are opt-in;
  130. their [stability boundaries](docs/sdk.md#stability-in-1x) are documented separately.
  131. ## CLI and SDK
  132. The package installs three commands: `kiln`, `kiln-init` and `kiln-mcp`.
  133. For a command available throughout your terminal, install it globally:
  134. ```sh
  135. npm install -g @instruktlabs/kiln
  136. kiln discover --capabilities --json
  137. kiln render my-asset.kiln.js --out my-asset.glb --views sheet.png
  138. ```
  139. KTX2 texture compression for the three.js runtime export (`export --target three --ktx2`)
  140. uses an optional peer that Kiln does not install or bundle. Add it to the same installation
  141. when you need it: `npm install ktx2-encoder@0.6.0`. It is MIT-licensed and ships its own
  142. notice for the bundled Basis Universal encoder (Apache-2.0); see
  143. [KTX2 textures](docs/export-profiles.md#ktx2-textures).
  144. With a project-local installation, use `npx --no -- kiln discover --capabilities --json`
  145. from that project. The [CLI installation guide](docs/install.md#run-the-cli) covers PATH
  146. and the equivalent `npm exec` command.
  147. Inside a generated authoring workspace, use its launcher to match the MCP server's
  148. Kiln installation, Node version and source store:
  149. ```sh
  150. node kiln.mjs discover --capabilities --json
  151. node kiln.mjs render my-asset.kiln.js --out my-asset.glb --views sheet.png
  152. node kiln.mjs view
  153. ```
  154. The SDK is available as `@instruktlabs/kiln` and documented subpaths.
  155. Read the [SDK guide](docs/sdk.md) for imports and host interfaces, and the
  156. [tool reference](docs/tools.md) for MCP schemas. Local Claude Code and Codex
  157. [plugins](docs/install.md#local-claude-code-and-codex-plugins) use the same workspace
  158. setup. Other MCP clients can connect directly.
  159. [ChatGPT](docs/chatgpt.md) uses a separate remote-connection setup.
  160. [Hosted Kiln](https://kiln.instruktlabs.com/) is a remote MCP server at
  161. `https://kiln.instruktlabs.com/mcp`, open by invitation (see
  162. [Community and hosted access](#community-and-hosted-access)); it signs in through
  163. OAuth with Google or GitHub. Vendor directory listings are not available yet.
  164. ## Work on Kiln
  165. For engine development, use the [pinned toolchain](toolchain.json):
  166. ```sh
  167. git clone --filter=blob:none https://github.com/instruktlabs/kiln
  168. cd kiln
  169. bun install --frozen-lockfile
  170. bun run build:runtime
  171. node scripts/example-archive.mjs --fetch
  172. bun run typecheck
  173. bun run test
  174. ```
  175. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the complete checks, package builds and
  176. bug-report guidance, and [AGENTS.md](AGENTS.md) when changing the engine with an agent.
  177. Author assets in a separate workspace. Large scene downloads are optional and are
  178. not fetched by cloning the repository.
  179. Kiln is maintained by [Instrukt Labs](https://github.com/instruktlabs) and released
  180. under the [MIT license](LICENSE). Downloaded asset packs carry their own licenses.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.