# Synthcad Cad Authoring

> Build, modify, and validate SynthCAD build123d CAD projects, including project-local tests and generated review artifacts.

- **Type:** Skill
- **Install:** `agentstack add skill-bencaunt-synthcad-synthcad-cad-authoring`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [BenCaunt](https://agentstack.voostack.com/s/bencaunt)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [BenCaunt](https://github.com/BenCaunt)
- **Source:** https://github.com/BenCaunt/SynthCAD/tree/main/skills/synthcad-cad-authoring

## Install

```sh
agentstack add skill-bencaunt-synthcad-synthcad-cad-authoring
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SynthCAD CAD Authoring

Use this skill when working in the SynthCAD repository on CAD projects, exports,
inspection, project-local tests, or URDF handoff.

## Operating Rules

- Use millimeters for all CAD dimensions.
- Discover the active project and target before editing. Use the build
  registry or user request as the source of truth.
- Prefer small parameterized changes in the target's existing source module.
- Preserve real component interfaces first: hole patterns, shafts, registers,
  fastener clearances, mounting faces, service access, cable/connector access,
  and other constraints documented by the current project.
- Do not hand-edit generated STEP, STL, GLB, URDF, inspection, or BREP files.
- Keep each project's source references, docs, tests, and generated artifacts
  inside `projects//`.
- Put project-specific tests under `projects//tests/`. Reserve
  root `tests/` for reusable framework, CLI, registry, and library behavior.
- When creating a new project or build target, add or update tests for its
  geometry invariants, critical component interfaces, source refs/docs metadata,
  and expected assembly interferences.
- If a drawing or component constraint is incomplete, record the assumption in
  the project's own `docs/` directory.

## Commands

Set these from the current repo and request:

```bash
uv run synthcad-build --list
PROJECT=
TARGET=
ASSEMBLY_TARGET=
URDF_TARGET=
```

Use the variables consistently:

```bash
uv run synthcad-build --project "$PROJECT"
uv run synthcad-probe --target "$TARGET" --children
uv run synthcad-inspect --target "$ASSEMBLY_TARGET"
uv run show-interference --target "$ASSEMBLY_TARGET"
uv run synthcad-report --project "$PROJECT"
test -z "$URDF_TARGET" || uv run synthcad-urdf --target "$URDF_TARGET"
uv run pytest
uv run pytest "projects/$PROJECT/tests"
```

Use `synthcad-probe` before writing throwaway geometry scripts. It reports
target bounds, child labels, and inspection model structure quickly.

## Done Criteria

A CAD change is done when:

- the changed target imports and builds without errors;
- relevant project-local tests are added/updated and pass;
- exports regenerate for the affected project or target;
- inspection artifacts are generated for the changed target or assembly;
- unexpected interferences are fixed or documented as intentional; and
- project-specific assumptions or validation notes are updated.

## Reference

Open `references/project-workflow.md` for the generic project workflow and
test expectations.

## Robotics Robustness Extension

For robotics parts/assemblies, pair this skill with:

- `references/robotics-robustness-prompt.md` for a reusable prompt add-on.
- `docs/robotics-design-guidelines.md` for design guardrails and tooling roadmap.

When outputs include rotating shafts, bearing supports, or structural load paths,
require explicit rationale and fail the task if support topology is unsafe or
insufficiently specified.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [BenCaunt](https://github.com/BenCaunt)
- **Source:** [BenCaunt/SynthCAD](https://github.com/BenCaunt/SynthCAD)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bencaunt-synthcad-synthcad-cad-authoring
- Seller: https://agentstack.voostack.com/s/bencaunt
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.