kernelcad-design-loop
/kernelcad-design-loop
Build or revise a CAD model with the hosted kernelCAD MCP — write .kcad.ts source, evaluate, review with design_loop until green. Use for any "design / model / make a part" request when the kernelcad MCP server is connected.
- Author
- w1ne ↗
- Repository
- kernelcad-web ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Build or revise a CAD model with the hosted kernelCAD MCP — write .kcad.ts source, evaluate, review with design_loop until green. Use for any "design / model / make a part" request when the kernelcad MCP server is connected.
Triggers from the description
Original author description
Build or revise a CAD model with the hosted kernelCAD MCP — write .kcad.ts source, evaluate, review with design_loop until green. Use for any "design / model / make a part" request when the kernelcad MCP server is connected.
How it works
- Loop
- Rules
SKILL.md preview
---
name: kernelcad-design-loop
description: Build or revise a CAD model with the hosted kernelCAD MCP — write .kcad.ts source, evaluate, review with design_loop until green. Use for any "design / model / make a part" request when the kernelcad MCP server is connected.
---
# kernelCAD design loop (hosted MCP)
The `kernelcad` MCP server (https://mcp.kernelcad.com/mcp) runs the OpenCASCADE
kernel for you. Nothing needs to be installed locally. Discover the live tool
list from the server; tool availability depends on whether the user is signed in.
## Loop
1. Check for a canonical pattern first: `lookup_cookbook({ query })`
(see the `kernelcad-cookbooks` skill). Start from a hit when one exists.
2. Write `.kcad.ts` source. Use `lookup_api({})` for the API surface instead of guessing.
3. Iterate fast with `evaluate_script({ code, dryRun: true })`, then finish with a
full `evaluate_script({ code })`. A dry run is not evidence that the solid builds.
4. For housings, mechanisms, gearboxes, robot arms and other production builds,
call `design_loop({ goal, attempts: [{ code }] })`. Apply its
`nextActionPrompt` / `revisionAssist` patches and repeat until `ok: true`
or `convergence.escalate` says to stop and ask the user.
5. On failure, `why_did_this_fail({ code })` then `repair_script({ code })`.
`lookup_diagnostics({})` explains any diagnostic code.
6. For assemblies that must be built, run
`verify({ check: 'assembly-path', sequence: true })`. Declare helical
fastener motion and press/snap fits on the fastened mate
(`{ fastener: { part?, axis, pitchMm?, tool? }, fit?: { kind, part? } }`);
the planner reports `helical`, `requires-force` and `tool-blocked` steps
instead of guessing. Add `stability: true` (with `gravity`/`fixtures` when
needed) to flag steps whose part cannot be proven to rest on an
already-stable part: read `sequence.needsHold` and `Step.heldBy`. That is an
approximate support projection, not physics. Tool reach is a swept
envelope, not a hardware check.
7. Show the result once with `open_in_studio` (see `kernelcad-studio-paint`),
then export (see `kernelcad-export`).
## Rules
- Report the numbers the tools return (volumes, bbox, diagnostics); do not
describe geometry you have not evaluated.
- Keep the source as the deliverable: give the user the final `.kcad.ts`.
- If a tool says sign-in is required, tell the user to complete the OAuth
prompt their client shows for the `kernelcad` server.
Versions
The database has no other skills named kernelcad-design-loop.
Database snapshot: 13.11.2026 · package version 627b79c43628 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95kernelcad-mcp
kernelCAD MCP server (kernelcad mcp) — introspect a running model, list features, run edit ops, fetch diagnostic codes. Use when you need to inspect a live model dynamically rather than re-evaluate from source. - 86kernelcad-export
Export a kernelCAD model to STEP, STL, 3MF, GLB, OBJ, USD, DXF or G-code through the hosted MCP, and check it before handing it over. Use when the user asks for a file to print, machine, simulate or import into other CAD. - 100audit
Audit an MCP server with mcpscore, explain its score and fix what it finds in the user's own server code. Use when the user asks to check, audit, score, test or review an MCP server they are building (a server URL, a local server file or a server command), or asks why their MCP… - 100solidcraft-cad
Design parametric 3D parts in SolidCraft (ArtCraft's parametric CAD app, driven through the `solidcraft` MCP server, tools `mcp__solidcraft__*`; units mm, Z up). Use whenever the user mentions SolidCraft or its MCP tools, or asks to design, model or build a 3D part: bracket,… - 95generate_cad_script
Write a CadQuery (or FreeCAD) script for a described part, run it in the MetaForge sandbox, check the geometry against the user's dimensions, and commit it to the twin as a named CAD model. Use when the user asks for a part whose shape is more than a single primitive ("model a…