solidcraft-editing
Use when changing, fixing or extending an existing SolidCraft design through its MCP server - a .sc file (or an older .solidcraft one) or the design open in the app. Typical requests: resize it, move a cut, change a hole or standoff, add a fillet or chamfer, make a fixed value parametric, or a feature shows an error after a change or after the app crashed.
How do I install this agent skill?
npx skills add https://github.com/tangency-labs/solidcraft --skill solidcraft-editingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides safe and structured instructions for editing CAD designs through a SolidCraft MCP server, including safety checkpoints and verification steps.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
SolidCraft editing
Overview
Edit an existing design through its parameters instead of rebuilding it. Every sketch dimension and feature input is already a parameter (d1, d2, ...), so most edits are a parameters.change each, sent together in one batch. Map the design with a few compact calls rather than walking the timeline one feature at a time. For command shapes and traps, in SolidCraft's own chat or any MCP client, call skill_reference {"skill":"solidcraft-modeling"}. Elsewhere, use reference.md from the solidcraft-modeling skill.
Map the design (3-4 calls)
- Open: if the design is not open yet, run
open {path}. When the server is bridged to the app and the current design isdirty, ask before opening anything. - Overview:
inspect_design {"measure":false,"sketches":false}lists the user parameters, the sketch dimensions (d1,d2, ... with their expressions), the features in order, and their errors. - Feature inputs:
execute parameters.list {"filter":"feature"}gives every feature input as an object such as{"name":"d9","expression":"(6) / 2","feature":"Cylinder1","input":"Radius"}.inspect_designleaves these out.- Match sketch dimensions by expression.
- If that is ambiguous,
sketch.inspect {sketch}that one sketch, which also shows its points in world coordinates.
- Baseline:
measure {}, so you can predict every change against it.
timeline.inspect {feature} is only for two cases:
- changing more than a number: profiles, direction, operation or edges
- checking whether a position follows a parameter, for example a cylinder
basewritten aswidth/2 - wall - 6
Inspect one feature of each kind, not every copy.
Change
-
A number:
parameters.change {"name":"d9","expression":"..."}.- To make a fixed value parametric: add a user parameter first (
parameters.add standoff_d), then set each input to an expression of it (standoff_d/2). - Several changes: one
batch.
- To make a fixed value parametric: add a user parameter first (
-
A user parameter:
set_parameterorparameters.change. Every expression that uses it follows. -
Structure:
timeline.edit {"feature":..., "set":{...}}, with the field shapestimeline.inspectshows. -
A new feature goes at the end of the timeline. To place it earlier:
timeline.roll_to {"position":N}. A position is safer than a name, since a sketch and a feature can share one.- Add the feature.
timeline.roll_to {}to return to the end.
Everything after the insert recomputes, and a feature that worked can now fail. Seen: a corner fillet after an inserted chamfer.
-
Risky or multi-step edits: take
edit.checkpointin its own call first.edit.restore_checkpoint {checkpoint}goes back exactly. Restoring uses the checkpoint up (and any later ones): take a new one to go back again. Only the last 16 are kept. Abatchrolls itself back; separateexecutecalls do not. -
Deleting:
timeline.dependents {feature}first. It lists what is deleted with it and what would fail. -
Ambiguous wording: "2 mm higher" on a value written as
wall + 6can be relative (wall + 8) or absolute.- Keep the design's intent, which is the relative reading.
- Tell the user which reading you used. This matters most when the same request also changes
wall, because then the two readings give different heights.
-
New constants such as a chamfer size go in user parameters, so the user can change them later.
Verify
- Predict, then measure once. Send the independent changes in one batch, predict the total volume change, then run
measureonce.- A move does not change the volume. To confirm a moved sketch, read its points' world coordinates with
sketch.inspect. You can also predict the COM shift,Δcom = V_moved · Δz / V_body, but only when nothing else in that batch changes the volume. - If it matches to about 0.01%, you are done.
- If not, restore the checkpoint, take a new one, then apply the changes one at a time, measuring after each.
- A cut or chamfer that leaves the volume unchanged has missed.
- A move does not change the volume. To confirm a moved sketch, read its points' world coordinates with
- Timeline health: run
inspect_design {"measure":false,"sketches":false}. Everyerrorandwarningmust be null. If something broke, restore orundobefore you try anything else. - Interior features: take one top-view screenshot,
{"source":"model","view":"top","width":480,"height":320}. When the server is bridged,viewalso turns the user's camera. The iso view hides standoffs behind the walls. - Still parametric: if the user wants it kept parametric, change one driving size,
measure, then set it back.
When something is already broken
- A feature has an
errorafter opening: read it withtimeline.inspect, fix the input or definition, and recompute. - The app crashed:
crash_reportslists the reports, andcrash_reports {id}gives the command that crashed.execute doc.recovery_listand thendoc.recover {id}reopen the autosaved design.- Never retry the crashing command unchanged.
Save
save {"path":"...-v2.sc"} writes a copy. save {} overwrites the opened file; do that only when the user asked for it.
Red flags
| Thought | Do instead |
|---|---|
| "timeline.inspect each feature to understand it" | parameters.list {"filter":"feature"} shows every input in one call. |
| "Delete and remodel the feature" | Change its dN input, or use timeline.edit. History and downstream picks stay intact. |
| "The insert worked, done" | Check the errors of every later feature. |
| "Edge points with expressions, so the chamfer follows the size" | They are rejected, and stored picks already follow size changes. |
| "Pick all 8 rim edges" | One pick on a tangent chain fillets or chamfers the whole chain. |
| "Measure after every edit" | One batch, one measure against the summed prediction. Split only when it misses. |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tangency-labs/solidcraft/solidcraft-editing">View solidcraft-editing on skillZs</a>