Skip to content
Skills Library
Programming · Building & coding

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 ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

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

design / model / make a part
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

  1. Loop
  2. Rules
Original SKILL.md headings · 41 lines, 320 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.