urdf
URDF 机器人描述创作和验证。在创建、编辑、检查、验证或调试“.urdf”文件、机器人链接、关节、限制、惯性、视觉/碰撞几何、网格参考、框架约定或机器人描述工件时使用。将 SRDF 技能用于 MoveIt2 语义组和 IK/路径规划语义;使用 cad-viewer 技能进行本地 MoveIt2 服务器控件;使用 CAD 技能进行 STEP/STL/3MF/DXF/GLB 输出。
- License 许可
- MIT
- 最近更新
- 2026-09-29
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- urdf
- description
- URDF 机器人描述创作和验证。在创建、编辑、检查、验证或调试“.urdf”文件、机器人链接、关节、限制、惯性、视觉/碰撞几何、网格参考、框架约定或机器人描述工件时使用。将 SRDF 技能用于 MoveIt2 语义组和 IK/路径规划语义;使用 cad-viewer 技能进行本地 MoveIt2 服务器控件;使用 CAD 技能进行 STEP/STL/3MF/DXF/GLB 输出。
02 资源文件 99
- 参考文档agents/openai.yaml263 B
- 许可证LICENSE1.0 KB
- 参考文档references/authoring-contract.md6.7 KB
- 参考文档references/design-ledger.md5.3 KB
- 参考文档references/frame-semantics.md3.5 KB
- 参考文档references/inertials.md4.7 KB
- 参考文档references/meshes.md3.9 KB
- 参考文档references/urdf-workflow.md5.6 KB
- 参考文档references/validation.md4.7 KB
- 参考文档requirements.txt26 B
- 许可证scripts/packages/cadgen/LICENSE1.0 KB
- 脚本scripts/packages/cadgen/pyproject.toml1.5 KB
- 脚本scripts/packages/cadgen/src/cadgen/__init__.py2.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/__init__.py235 B
- 脚本scripts/packages/cadgen/src/cadgen/_internal/assembly_spec.py1.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/atomic_replace.py7.0 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/cli_errors.py4.1 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/cli_locking.py3.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/component_package.py37.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/drawing_package.py27.4 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/file_metadata.py1.9 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/font_scan.py9.6 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/generation_runner.py25.5 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/generation_spec.py20.7 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/generation.py59.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/glb_mesh_payload.py25.9 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/glb_topology.py21.9 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/glb.py45.2 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/implicit_package.py15.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/legacy_artifacts.py6.4 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/node_resolve_hooks.mjs2.4 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/node_resolve_register.mjs367 B
- 脚本scripts/packages/cadgen/src/cadgen/_internal/node_runtime.py19.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/package_freshness.py4.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/source_hash.py22.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_hash.py345 B
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_metadata.py12.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_scene_cache.py14.4 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_scene_geometry.py24.1 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_scene_loader.py18.0 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_scene_mesh.py17.0 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_scene_selectors.py44.7 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_scene_types.py4.5 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/step_scene.py5.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/stl.py926 B
- 脚本scripts/packages/cadgen/src/cadgen/_internal/threemf.py19.6 KB
- 脚本scripts/packages/cadgen/src/cadgen/_internal/validators.py3.9 KB
- 脚本scripts/packages/cadgen/src/cadgen/analysis.py24.4 KB
- 脚本scripts/packages/cadgen/src/cadgen/api.py292 B
- 脚本scripts/packages/cadgen/src/cadgen/assembly_lookup.py25.2 KB
- 脚本scripts/packages/cadgen/src/cadgen/assembly.py14.6 KB
- 脚本scripts/packages/cadgen/src/cadgen/cad_ref_syntax.py11.7 KB
- 脚本scripts/packages/cadgen/src/cadgen/catalog.py19.6 KB
- 脚本scripts/packages/cadgen/src/cadgen/check_fonts.py3.7 KB
- 脚本scripts/packages/cadgen/src/cadgen/cli_logging.py1.6 KB
- 脚本scripts/packages/cadgen/src/cadgen/cli_progress.py6.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/color.py2.2 KB
- 脚本scripts/packages/cadgen/src/cadgen/coordination/__init__.py20.7 KB
- 脚本scripts/packages/cadgen/src/cadgen/coordination/kinds.py4.5 KB
- 脚本scripts/packages/cadgen/src/cadgen/coordination/lock.py20.2 KB
- 脚本scripts/packages/cadgen/src/cadgen/coordination/paths.py5.0 KB
- 脚本scripts/packages/cadgen/src/cadgen/coordination/phases.py11.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/coordination/record.py6.9 KB
- 脚本scripts/packages/cadgen/src/cadgen/drawing_checks.py16.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/drawing_render.py16.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/dxf_artifact.py8.4 KB
- 脚本scripts/packages/cadgen/src/cadgen/flatten.py11.0 KB
- 脚本scripts/packages/cadgen/src/cadgen/generation.py496 B
- 脚本scripts/packages/cadgen/src/cadgen/implicit_artifact.py8.6 KB
- 脚本scripts/packages/cadgen/src/cadgen/implicit_export.py9.5 KB
- 脚本scripts/packages/cadgen/src/cadgen/instances.py3.6 KB
- 脚本scripts/packages/cadgen/src/cadgen/interference.py11.1 KB
- 脚本scripts/packages/cadgen/src/cadgen/label_refs.py8.5 KB
- 脚本scripts/packages/cadgen/src/cadgen/lookup.py10.9 KB
- 脚本scripts/packages/cadgen/src/cadgen/metadata.py13.2 KB
- 脚本scripts/packages/cadgen/src/cadgen/progress.py3.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/py.typed1 B
- 脚本scripts/packages/cadgen/src/cadgen/render.py1.9 KB
- 脚本scripts/packages/cadgen/src/cadgen/reporting.py4.0 KB
- 脚本scripts/packages/cadgen/src/cadgen/selector_types.py374 B
- 脚本scripts/packages/cadgen/src/cadgen/snapshot_cli.py63.0 KB
- 脚本scripts/packages/cadgen/src/cadgen/snapshot_core.py46.1 KB
- 脚本scripts/packages/cadgen/src/cadgen/sources.py1.2 KB
- 脚本scripts/packages/cadgen/src/cadgen/step_artifact_cli.py21.3 KB
- 脚本scripts/packages/cadgen/src/cadgen/step_artifacts.py21.7 KB
- 脚本scripts/packages/cadgen/src/cadgen/step_export_target.py17.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/step_export.py14.9 KB
- 脚本scripts/packages/cadgen/src/cadgen/step_scene.py629 B
- 脚本scripts/packages/cadgen/src/cadgen/step_targets.py19.8 KB
- 脚本scripts/packages/cadgen/src/cadgen/validity.py7.7 KB
- 脚本scripts/snapshot/__init__.py31 B
- 脚本scripts/snapshot/__main__.py1.6 KB
- 脚本scripts/snapshot/runtime/render.html386 B
- 脚本scripts/snapshot/runtime/snapshot-render.js1.2 MB
- 脚本scripts/urdf/__init__.py46 B
- 脚本scripts/urdf/cli.py5.9 KB
- 脚本scripts/urdf/findings.py2.5 KB
- 脚本scripts/urdf/source.py48.4 KB
- 脚本scripts/validate/__main__.py285 B
03 SKILL.md 正文
URDF
Provenance: maintained in earthtojake/text-to-cad. Use the installed local skill files as the runtime source of truth; the repository link is only for provenance and release review.
Use this skill for URDF robot-description outputs. Treat URDF work as constrained kinematic modeling, not just XML writing. The main correctness risks are frame placement, joint-axis semantics, unit consistency, mesh scale, and inertial data.
Core Rules
- The
.urdffile is the source of truth. Author and edit URDF XML directly; do not build a Python generation pipeline for it. There is nogen_urdf()contract. - Before writing or changing URDF XML, establish the robot's frame, joint, geometry, unit, and assumption ledger and embed it as a comment block at the top of the
.urdffile. Seereferences/design-ledger.md. - Use URDF frame semantics exactly. Joint origins, link frames, joint axes, and visual/collision/inertial origins use different reference frames. See
references/frame-semantics.md. - Do not infer spatial transforms, mesh units, handedness, axes, or joint signs from vague prose. Use CAD transforms, dimensioned drawings, measured values, existing source data, or explicit documented assumptions.
- Never freehand numeric values that are the result of computation — inertia tensors, centers of mass, unit conversions across many links, mirrored transforms. Compute them: closed-form formulas for primitives, or a throwaway helper script for mesh-derived values. See
references/inertials.md. - For physical links, model
inertial,visual, andcollisionseparately when the target consumer needs them. Frame-only links may intentionally omit mass and geometry. - Validate every created or modified
.urdfwithscripts/validatebefore reporting completion. Seereferences/validation.md. - Helper scripts are allowed and encouraged for computation, but they are scaffolding, not the artifact's source of truth. For complex or genuinely parametric models it is reasonable to keep a model-local helper script on disk next to related source code (for example STEP generator sources) and note it in the ledger; this is optional, and the checked-in
.urdfremains canonical.
CAD Viewer Handoff
After completing URDF work that creates or modifies a .urdf, you must ALWAYS hand the explicit file path to $cad-viewer when that skill is installed. $cad-viewer must start CAD Viewer if it is not already running and return link(s) to the relevant created or updated file(s); if $cad-viewer is unavailable or startup fails, report that instead of silently omitting the handoff.
Workflow
- Identify the target
.urdffile and its consumers: RViz, robot_state_publisher, Gazebo/Ignition, MoveIt, a real robot driver, or another simulator. - Read or create the design ledger before editing frames, origins, axes, mesh scale, limits, or inertials. Keep the ledger as a comment block in the
.urdfitself. - Prepare mesh assets first when links reference meshes: one mesh per link, exported in that link's frame by the owning CAD/mesh workflow. See
references/meshes.md. - Author or edit the URDF XML directly, following
references/authoring-contract.mdfor structure, ordering, and naming. - Compute — never guess — inertials and other derived numbers. See
references/inertials.md. - Validate with
scripts/validate; fix findings and re-validate until clean. - Run the verification recipe in
references/validation.md: external tools when available (check_urdf), then a viewer review sweeping every joint. - Report remaining assumptions, unchecked spatial data, and validation gaps.
Commands
Run with the Python environment for the project or workspace. Treat python in examples as an interpreter placeholder; if bare python is unavailable, substitute python3, a project virtualenv interpreter, or the configured interpreter path. The validator uses only the Python standard library.
From this skill directory, the validator shape is:
python scripts/validate path/to/robot.urdf
python scripts/validate path/to/a.urdf path/to/b.urdf
python scripts/validate path/to/robot.urdf --strict
python scripts/validate path/to/robot.urdf --format json
python scripts/validate path/to/robot.urdf --package robot_description=/path/to/pkg
The validator collects all findings in one pass (severity, code, XML path) across XML structure, tree topology, joint semantics (limits, mimic, dynamics), geometry, mesh references, materials, inertial physics, and misspelled elements, and prints a per-file summary. --strict treats warnings as failures; --format json emits a machine-readable findings document; --package NAME=PATH resolves package:// mesh URIs. It exits nonzero if any target fails. Relative targets resolve from the current working directory; when running from outside this skill directory, prefix the launcher path so target files still resolve from the intended workspace.
Validation is a guardrail, not spatial proof: a URDF can pass every structural check while placing a joint in the wrong spot. The ledger and viewer sweep exist for that reason.
Snapshot Tool
scripts/snapshot renders the robot to a PNG still or an orbit GIF, using the same shared
CLI and headless browser runtime every rendering skill uses — so a snapshot matches what
the CAD Viewer shows.
python scripts/snapshot --input path/to/robot.urdf --output review.png
python scripts/snapshot --input path/to/robot.urdf --output turntable.gif --mode orbit
It accepts .urdf only. Pose the robot with the job field "jointValues" (joint name to
degrees, defaulting to the rest pose) rather than --params, which is STEP-only; robots
are authored in metres and are framed on the robot scene scale automatically.
Theme settings live under one --theme, mirroring the viewer's Theme tab. The default
theme is snapshot — Workbench Light with the ground grid, origin axis and shadows
removed, because in a still image those read as geometry. There is no --display: display
settings (mode, clip, exploded, edges) are CAD topology settings, and a robot carries none.
Link meshes are resolved relative to the description, so they must be present: an
unhydrated Git LFS pointer fails as "No link mesh loaded for robot". Run
git lfs checkout <mesh dir> first.
Use python scripts/snapshot --help for the complete current command interface.
References
- Authoring contract (structure, ordering, golden skeleton):
references/authoring-contract.md - Design ledger:
references/design-ledger.md - Frame semantics:
references/frame-semantics.md - Mesh preparation and references:
references/meshes.md - Inertials (formulas, scripts, sanity gates):
references/inertials.md - URDF edit workflow:
references/urdf-workflow.md - Validation and verification recipe:
references/validation.md
04 同仓库更多 Skills
vercel-react-view-transitions
使用 React 的视图转换 API(`<ViewTransition>` 组件、`addTransitionType` 和 CSS 视图转换伪元素)实现流畅、原生感觉的动画的指南。每当用户想要添加页面转换、为路线更改设置动画、创建共享元素动画、为组件的进入/退出设置动画、为列表重新排序设置动画、实现定向(向前/向后)导航动画或在 Next.js 中集成视图转换时,请使用此技能。当用户提及视图转换、startViewTransition、ViewTransition、转换类型或询问有关在 React 中的 UI 状态之间设置动画而无需第三方动画库时也可使用。
vercel-react-native-skills
React Native和Expo构建高性能移动应用程序的最佳实践。在构建React Native组件、优化列表性能、实现动画或使用本机模块时使用。涉及React Native、Expo、移动性能或本机平台API的任务的触发器。
vercel-react-best-practices
Vercel Engineering的React和Next.js性能优化指南。在编写、审查或重构React/Next.js代码时,应使用此技能,以确保最佳性能模式。涉及React组件、Next.js页面、数据获取、捆绑优化或性能改进的任务的触发器。
vercel-composition-patterns
可扩展的React组合模式。在重构具有布尔属性增殖的组件、构建灵活的组件库或设计可重用的API时使用。涉及复合组件、渲染道具、上下文提供者或组件架构的任务的触发器。包括React 19 API变更。
ui-styling
使用 shadcn/ui 组件(基于 Radix UI + Tailwind 构建)、Tailwind CSS 实用优先样式和基于画布的视觉设计创建美观、可访问的用户界面。在构建用户界面、实现设计系统、创建响应式布局、添加可访问组件(对话框、下拉菜单、表单、表格)、自定义主题和颜色、实现深色模式、生成视觉设计和海报或跨应用程序建立一致的样式模式时使用。
design
“综合设计技能:品牌标识、设计标记、UI 样式、徽标生成(55 种样式、Gemini 或 Atlas Cloud AI)、企业形象程序(50 个可交付成果、CIP 模型)、HTML 演示文稿(Chart.js)、横幅设计(22 种样式、社交/广告/网页/打印)、图标设计(15 种样式、SVG、Gemini 3.1 Pro)、社交照片(HTML→屏幕截图、多平台)。操作:设计徽标、创建 CIP、生成模型、构建幻灯片、设计横幅、生成图标、创建社交照片、社交媒体图像、品牌标识、设计系统:Facebook、Twitter、LinkedIn、YouTube、Instagram、Pinterest、TikTok、Threads、Google Ads。”