sdf
An agent skill by earthtojake, from earthtojake/text-to-cad. Tags: design, developer-tools, documentation, evaluation, local-workflow.
What it does
SDFormat/SDF model and world authoring, validation, and simulator handoff. Use for `.sdf` files, SDFormat XML, models, worlds, links, joints, poses, frames, inertials, visual/collision geometry, mesh URIs, sensors, lights, physics, plugins, includes, Gazebo, static SDF review, or simulator-specific metadata. Do not use for signed-distance-field geometry.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add earthtojake/text-to-cad --skill sdfOr copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/earthtojake/text-to-cad
cp -r text-to-cad/skills/sdf ~/.claude/skills/sdfSafety box score
Grade C, moderate risk: 28 of 100 risk points, rated 2026-10-20. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This is a bounded SDF authoring/validation skill: it edits `.sdf` XML, runs `cadgen` and optional `gz sdf --check`, and launches a CAD Viewer for visual review. The main risks are external code/network use through `uvx --from cadgen==0.7.26` and the fact that the real validator/viewer runtime is fetched outside the repo bundle.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 2 (moderate) | It shells out to external tools via `uvx --from cadgen==0.7.26 cadgen` / `python` and `cadgen sdf validate`, so using the skill executes non-repo code, though in a narrow, purpose-built way. |
| Network access | 2 (moderate) | Setup says "The first run downloads that installation and the first snapshot its headless browser," and the skill also permits external resource URIs like `fuel://`, `http://`, and `https://`. |
| Filesystem reach | 1 (low) | Its normal work is to "author and edit the XML directly" and produce snapshot files, which is project-scoped file writing rather than system-wide access. |
| Secrets & credentials | 0 (none) | No commands or prompts ask for tokens, key files, browser sessions, `.env` contents, or other credentials. |
| Privilege & persistence | 0 (none) | There is no sudo use, service installation, shell-startup editing, or other privilege escalation in the skill files. |
| Instruction hijack surface | 0 (none) | The files do not tell the agent to ignore instructions, follow remote prompts, hide behavior, or otherwise override its policy. |
| Irreversible actions | 1 (low) | The skill can modify SDF artifacts and generate viewer links, but it does not itself publish, deploy, send messages, or make irreversible external changes. |
| Transparency | 2 (moderate) | The effective runtime is the fetched `cadgen==0.7.26` toolchain plus a headless browser snapshot, neither of which is shipped in the reviewed files. |
Before installing
- Read the `Setup` section and confirm you accept `uvx --from cadgen==0.7.26` fetching and running external code.
- If you will use snapshots, test once in a scratch environment and verify the first-run browser download is acceptable.
- Decide whether `gz sdf --check` should be allowed to run on your machine, or whether you want to keep `gz` off PATH so it stays skipped.
Rated 2026-10-20 by an automated review of 10 files from the skill's repository.
Source
- Repository
- earthtojake/text-to-cad (all skills from this repository)
- Path
- skills/sdf/SKILL.md
- Branch
- main
- Updated
- 2026-09-19
Related skills
- cad — Create/edit parametric CAD models, organize CAD projects, export STEP/STL/3MF/GLB files, resolve prompt references, and measure geometry with cadgen.
- srdf — MoveIt2 SRDF authoring, validation, and planning-semantics workflow.
- urdf — URDF robot description authoring and validation.
- shadcn-ui — Expert guidance for integrating and building applications with shadcn/ui components, including component discovery, installation, customization.
- cad-viewer — Start CAD Viewer and return review links for CAD and robot-description files.
- dfam-check — Measure mesh files against Design for Additive Manufacturing (DfAM) rules and report printability findings per process (FDM, SLS, SLA/DLP, metal PBF, MJF).