Files
likang 678058c940
CI / Select checks (push) Has been cancelled
CI / Format and repository checks (push) Has been cancelled
CI / Compile RISC-V (manual) (push) Has been cancelled
Docker / image (push) Has been cancelled
Generated files / Regenerate and commit (push) Has been cancelled
Kernel rig / Select the rig areas (push) Has been cancelled
Lists / Design format changes merge cleanly (push) Has been cancelled
Lists / Lists are sorted one item per line (push) Has been cancelled
Packaging lint / lint (push) Has been cancelled
Pages / build (push) Has been cancelled
CI / Dependency advisories (push) Has been cancelled
CI / Quick compile (push) Has been cancelled
CI / Native Linux Clippy (push) Has been cancelled
CI / Build tests (push) Has been cancelled
CI / Native Linux tests (push) Has been cancelled
CI / GPU path tests (1/4) (push) Has been cancelled
CI / GPU path tests (2/4) (push) Has been cancelled
CI / GPU path tests (3/4) (push) Has been cancelled
CI / GPU path tests (4/4) (push) Has been cancelled
CI / Action matrix (1/16) (push) Has been cancelled
CI / Action matrix (10/16) (push) Has been cancelled
CI / Action matrix (11/16) (push) Has been cancelled
CI / Action matrix (12/16) (push) Has been cancelled
CI / Action matrix (13/16) (push) Has been cancelled
CI / Action matrix (14/16) (push) Has been cancelled
CI / Action matrix (15/16) (push) Has been cancelled
CI / Action matrix (16/16) (push) Has been cancelled
CI / Action matrix (2/16) (push) Has been cancelled
CI / Action matrix (3/16) (push) Has been cancelled
CI / Action matrix (4/16) (push) Has been cancelled
CI / Action matrix (5/16) (push) Has been cancelled
CI / Action matrix (6/16) (push) Has been cancelled
CI / Action matrix (7/16) (push) Has been cancelled
CI / Action matrix (8/16) (push) Has been cancelled
CI / Action matrix (9/16) (push) Has been cancelled
CI / Action matrix determinism (push) Has been cancelled
CI / Property tests (many cases) (push) Has been cancelled
CI / Doc tests (push) Has been cancelled
CI / Reference tests (push) Has been cancelled
CI / Windows D3D12 FXC shaders (push) Has been cancelled
CI / Windows app startup (push) Has been cancelled
CI / ci (push) Has been cancelled
CI / Compile WebAssembly (push) Has been cancelled
CI / Nightly alert (push) Has been cancelled
Kernel rig / Build the CLI (push) Has been cancelled
Kernel rig / Kernel rig (${{ matrix.shard }}) (push) Has been cancelled
Kernel rig / kernel-rig (push) Has been cancelled
Pages / deploy (push) Has been cancelled
优化skill
2026-11-16 11:32:34 +08:00
..
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00
2026-11-16 11:32:34 +08:00

Agent skills

Skills for contributing to makeCAD and modelling through its MCP server. Each folder is one skill in the Agent Skills format: a SKILL.md with a name and a description that tell the agent when to load it, and an optional supporting reference file.

The modelling documents are built into makeCAD: its MCP server's skill_reference tool returns them, so an agent without file access (such as the one in makeCAD's own chat) can still read a skill's reference. All 17 skills and their text resources are embedded in the tool, including the contributor skills. Select them by task; repository guidance does not grant filesystem, shell or publishing permissions. AGENTS.md routes to them; cargo xtask skills fails when its table and this folder disagree or a file, cargo xtask command or skill they name is gone.

Skill Loads when the agent
makecad-contributing helps someone set up a fork, choose and claim an issue, and submit a contribution for review; the rules every PR follows
makecad-ground-rules adds a dependency, asset or wording: independence, licences, attribution, the product name
makecad-crash-safety writes non-test Rust, handles hostile input or investigates a crash report
makecad-commands adds a command or decides which crate code belongs in
makecad-ui adds a dialog, panel, camera input, icon or colour
makecad-ui-text adds a label, message or translation
makecad-file-formats changes what a design saves, or touches import and export
makecad-preferences adds a setting or changes a default
makecad-tests places or runs tests
makecad-performance works on slow code, the window thread or the wasm build
makecad-packaging prepares a release or changes packages
makecad-agent-tools runs the app, drives the control channel or changes MCP tools
makecad-modeling builds a new part (enclosure, bracket, plate, flange, …)
makecad-editing changes, fixes or extends an existing design
makecad-checking builds, changes or ports a design, next to the two above: parameter ranges, every allowed value, exact STEP comparison, regression tests, designs kept in git
makecad-mechanisms builds, drives or animates an assembly: components, joints, motion links, closed loops such as actuators, contact sets, motion studies
makecad-reporting hears that something went wrong (a crash, a failed command, a wrong shape or number, a hang): reproduces it in a fresh design, shrinks it to a minimal script and writes the bug report

The modelling skills teach the agent to:

  • plan the part as numbers
  • build it in a few batch calls with parametric positions
  • verify every stage with measure against values it computed itself
  • skip the large replies it doesn't need, such as the unfiltered command catalog and full topology dumps

They also list the traps that otherwise cost failed calls. Examples are the sketch axes of the XZ plane, edge picks that snap to the nearest edge, and cuts that miss but still report success.

The modelling skills are written for makeCAD 0.8 and later; makecad-mechanisms for main after 0.11.1 (the next release), which counts the degrees of freedom of closed loops; makecad-reporting for 0.18 and later.

Install

From this makeCAD checkout, install the modelling skills for Claude Code in all projects:

cp -r skills/makecad-{modeling,editing,checking,mechanisms} ~/.claude/skills/

Windows (PowerShell):

foreach ($s in 'modeling','editing','checking','mechanisms') { Copy-Item -Recurse skills\makecad-$s $HOME\.claude\skills\ }
  • One project only: copy the folders into that project's .claude/skills/ instead.
  • Other agents: for agents that read the Agent Skills format, copy the folders into the skills directory their documentation names.
  • Updating: copy the folders again after you update makeCAD.
  • Contributing: the contributor skills need no install. Tell your assistant: "I want to contribute to makeCAD. Read skills/makecad-contributing/SKILL.md and help me get started."

Maintaining

  • The worked example in makecad-modeling/reference.md runs in CI. skill_reference_example_builds_as_documented in crates/mcp/src/tests.rs builds it, checks the documented volume, changes a parameter and checks it again.
  • The sketch-plane table is covered by sketch_plane_axes_match_the_skill_reference in the same file.
  • The worked example in makecad-mechanisms/reference.md runs in CI too: mechanisms_skill_example_moves_as_documented builds it, drives the hinge and checks the actuator stroke, the linked panel and the stop against their analytic values.
  • skills_name_only_real_tools_and_commands checks that every tool and command the skills call exists.
  • makecad-checking/scripts/tests checks that skill's helpers, its traps and conventions, and the facts behind the corrections in makecad-modeling: PYTHONDONTWRITEBYTECODE=1 uv run --no-project --with pytest --with build123d pytest -p no:cacheprovider skills/makecad-checking/scripts/tests. The tests run the solidcraft-cli on PATH, not the workspace build, and CI does not run them.
  • When a command, a parameter name or a behaviour that these files describe changes, update them in the same PR.
  • Facts that describe current limitations, such as edge picks without a distance limit, should go once the limitation is fixed.

Shared hosted workflow

agent-workflow.md is used verbatim by MCP and the desktop assistant. The Java model gateway packages the same workflow, skill metadata and files:

node scripts/sync-cad-ai-skills.mjs ../community
node scripts/sync-cad-ai-skills.mjs --check ../community

The sync command writes a self-contained versioned resource; production does not read a developer's absolute directory. Rebuild Java and WASM after changes. skill_reference defaults to SKILL.md, accepts exact registered file paths only, and never executes scripts. Legacy lowercase skill ids remain read aliases in MCP; the catalog advertises only makecad ids.

The shared process is: choose relevant skills, inspect, clarify material ambiguity or state assumptions, calculate parameters and expected geometry, build in stages, measure, check parameter ranges, repair and report evidence. Identical geometry commands use the same engine; identical model output additionally requires the same provider, model, sampling, history and context and must be evaluated on representative tasks.