Update to text-to-cad

{
  "description": "MoveIt2 SRDF authoring, validation, and planning-semantics workflow. Use when creating, editing, inspecting, or validating `.srdf` files, MoveIt planning groups, virtual joints, passive joints, end effectors, group states, disabled collisions, URDF-paired planning semantics, or SRDF handoff for live review. Use the URDF skill for robot structure and the SDF skill for simulator descriptions. Open and visually review existing SRDF files in CAD Viewer.",
  "included_files": [
    {
      "relative_path": "LICENSE",
      "size_in_bytes": 1074
    },
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 317
    },
    {
      "relative_path": "references/authoring-contract.md",
      "size_in_bytes": 4611
    },
    {
      "relative_path": "references/disabled-collisions.md",
      "size_in_bytes": 1870
    },
    {
      "relative_path": "references/end-effectors.md",
      "size_in_bytes": 1593
    },
    {
      "relative_path": "references/planning-ledger.md",
      "size_in_bytes": 3354
    },
    {
      "relative_path": "references/srdf-workflow.md",
      "size_in_bytes": 2919
    },
    {
      "relative_path": "references/validation.md",
      "size_in_bytes": 3938
    },
    {
      "relative_path": "requirements.txt",
      "size_in_bytes": 25
    }
  ],
  "name": "srdf",
  "skill_md_contents": "---\nname: srdf\ndescription: MoveIt2 SRDF authoring, validation, and planning-semantics workflow. Use when creating, editing, inspecting, or validating `.srdf` files, MoveIt planning groups, virtual joints, passive joints, end effectors, group states, disabled collisions, URDF-paired planning semantics, or SRDF handoff for live review. Use the URDF skill for robot structure and the SDF skill for simulator descriptions. Open and visually review existing SRDF files in CAD Viewer.\nlicense: MIT\n---\n\n# SRDF\n\nProvenance: maintained in [earthtojake/text-to-cad](https://github.com/earthtojake/text-to-cad).\nUse the installed local skill files as the runtime source of truth; the\nrepository link is only for provenance and release review.\n\nUse this skill for MoveIt semantic robot descriptions on top of an existing valid URDF. SRDF defines planning semantics; it does not define physical robot structure. The `.srdf` file is the source of truth: author and edit the XML directly. There is no `gen_srdf()` contract.\n\nSRDF correctness is a **planning semantics** problem. The common failure is not invalid XML; it is a plausible SRDF that gives MoveIt the wrong planning group, wrong tool link, wrong default state, unsafe disabled-collision matrix, or wrong joint units. Because language models are weak at spatial and kinematic reasoning, derive planning groups, end effectors, group states, and disabled collisions from the URDF topology, MoveIt Setup Assistant output, sampled collision analysis, or explicit user data. Do not infer them from visual theme alone — and do not type any link or joint name from memory: extract the URDF's link/joint table first and copy names from it.\n\n## Setup\n\nThis skill's commands are thin entrypoints over the `cadgen` distribution, which\ncarries the Python build runtime and the JavaScript it executes. Install it once:\n\n```bash\npython -m pip install -r requirements.txt\n```\n\nSnapshots additionally need a browser, which pip cannot supply:\n\n```bash\npython -m playwright install chromium\n```\n\n## Format boundary\n\n- **URDF** owns physical robot structure: links, joints, geometry, inertials, limits, mimic joints, transmissions, and robot-state publishing.\n- **SRDF** owns MoveIt semantics: virtual joints, passive joints, planning groups, group states, end effectors, and disabled collision pairs.\n- **SDF** owns simulator/world semantics: physics, sensors, lights, plugins, worlds, and simulation-specific metadata.\n\nDo not place geometry, inertials, joint origins, link poses, mesh references, physical joint limits, transmissions, or `ros2_control` interfaces in SRDF.\n\n## Show the model\n\nShow the user each file you create or change, and any they ask to see. Snapshots and\nvalidation don't replace this.\n\n- If your tools include `cad_show` (your host may prefix it), use it, and follow its\n  description for when to call it again. `cad_view` reads what the user selected;\n  `cad_screenshot` shows you what they see. Neither is a review of your own work.\n- Otherwise run the CAD Viewer from the models directory (usually `models/`, not an\n  artifact's output folder):\n\n  ```bash\n  cd /absolute/path/to/model-workspace && cadgen viewer --host 127.0.0.1 --json --detach\n  ```\n\n  `--detach` returns once the viewer answers requests and leaves it running in the\n  background: always pass it, since a foreground viewer never exits (and piping its\n  output through `tail` can hide the URL for good). It starts or reuses the viewer.\n  Read `url` from its one JSON line (never guess the port); for each file under that\n  directory return `url?file=<URL-encoded relative path>`, or `url` alone to review the\n  directory. If it fails to launch, say so.\n\nKeep the SRDF beside its uniquely matching URDF (same robot name). Review\nplanning groups, named states and joints; visual review does not prove planning\ncorrectness.\n\n## Required workflow\n\n1. **Start from a valid URDF.** Author or fix the URDF first with `$urdf` and validate it. The SRDF pairs with that URDF by colocation and robot name, and every name in the SRDF must exist in it.\n2. **Extract the URDF table.** Before writing any SRDF XML, list the URDF's robot name, links, joints (with type, parent, child, limits, mimic flags). Copy names from this table only; never type them from memory. See `references/srdf-workflow.md`.\n3. **Identify the planning task.** Record whether the goal is arm IK, gripper control, mobile base planning, dual-arm planning, tool use, or local smoke testing.\n4. **Create or update the planning ledger.** Use `references/planning-ledger.md` before writing XML; keep a compact copy as a comment block in the `.srdf`.\n5. **Pair with the URDF by colocation.** Save the `.srdf` in the same folder as its `.urdf`, with the same `<robot name>` — that is the only linking mechanism. The validator and the viewer both resolve the pairing by scanning the folder for the URDF whose robot name matches; exactly one URDF per robot name per folder. No metadata element links the files. See `references/authoring-contract.md`.\n6. **Define virtual and passive joints deliberately.** Use them when needed by the robot model.\n7. **Define planning groups from URDF topology.** Prefer chain groups for serial manipulators when base/tip form a real parent-to-child path in the URDF tree (the validator verifies this). Use joint/link/subgroup definitions only when they are deliberate.\n8. **Define end effectors after group membership is known.** Avoid overlap between an end-effector group and its parent group. Record the actual target/TCP link.\n9. **Define group states in URDF-native units.** Revolute and continuous values are radians; prismatic values are meters. Do not store degrees in SRDF. Values must lie within URDF limits and must not set fixed or mimic joints.\n10. **Generate disabled collisions from evidence.** Use adjacency derived from the URDF joint table, MoveIt Setup Assistant sampling, or explicit user-provided collision matrices. Do not invent broad disable lists. See `references/disabled-collisions.md`.\n11. **Validate every created or modified `.srdf`** with `cadgen srdf validate`; it cross-validates all names, chains, states, and pairs against the paired URDF. Fix findings and re-validate until clean.\n12. **Run MoveIt smoke tests when available.** Use MoveIt Setup Assistant or a project MoveIt launch directly.\n13. **Report assumptions and skipped checks.** Include incomplete validation, missing MoveIt environment, manually reasoned collision disables, and inferred target links.\n\n## Commands\n\nRun `cadgen` from the Python environment this skill's `requirements.txt` was installed into (`python -m cadgen.cli <verb>` with that interpreter is the PATH-independent equivalent). `cadgen doctor <skill-dir>` verifies the installed cadgen matches this skill's pin — docs drift silently on a mismatched install. Validation itself needs nothing beyond the Python standard library; only snapshots need the browser. Use `cadgen <verb> --help` for the complete current interface.\n\nThe validator shape is:\n\n```bash\ncadgen srdf validate path/to/robot.srdf\ncadgen srdf validate path/to/robot.srdf --strict\ncadgen srdf validate path/to/robot.srdf --json\n```\n\nThe validator parses the SRDF, resolves the paired URDF (the same-folder `.urdf` whose robot name matches; none, several, or an invalid one is an error), and cross-validates: group/joint/link/subgroup name existence, chain path resolvability, subgroup cycles, virtual/passive joints, end-effector topology, group-state membership/limits/completeness, disabled-collision pairs (including Adjacent-reason truthfulness), and misspelled elements. Each phase collects all its findings in one pass (severity, code, XML path), but a structural error stops the cross-file phase — re-run after every fix. One run validates ONE file: `--strict` treats warnings as failures and `--json` prints one line of `{\"ok\", \"path\", \"issues\": [{\"severity\", \"code\", \"message\", \"element\", \"hint\"}], \"summary\"}`, where `element` is the XML path. It exits nonzero if the target fails. Relative targets resolve from the current working directory.\n\n## Hard rules\n\n- The SRDF lives in the same folder as its URDF and shares its `<robot name>`; that colocation-plus-name match is the only pairing mechanism, and exactly one URDF per robot name may exist in the folder.\n- Every link, joint, group, and subgroup name must come from the URDF table or a group defined in the same file.\n- Group states use URDF-native units: radians for revolute/continuous, meters for prismatic.\n- Disabled collision pairs require truthful reasons and provenance.\n- End-effector groups should not share links with their parent planning group.\n- Visual rendering review is useful but cannot prove planning correctness.\n\n## Snapshot Tool\n\n`cadgen snapshot` renders the robot to a PNG still, using the same shared\nCLI and headless browser runtime every rendering skill uses — so a snapshot matches what\nthe CAD Viewer shows.\n\n```bash\ncadgen snapshot path/to/robot.srdf review.png\n```\n\nHand it the `.srdf`; it routes by suffix and renders the paired URDF's geometry — the same-folder `.urdf` whose `<robot name>` matches, exactly as `cadgen srdf validate` pairs them. No match, or more than one, is refused before anything renders, naming the robot name it looked for and the `.urdf` files it found. Pose the robot with `--joint-values` — `{joint: degrees}` JSON,\njoints you do not name staying where the CAD Viewer opens the robot: each at its default, then\nthis SRDF's `home` group state if it declares one (the `\"jointValues\"` job field is the same\nthing in a packet). The snapshot draws the robot with the viewer's own scene, so it shows what\nthe viewer shows, and a link mesh that cannot be loaded fails it rather than leaving the link\nout. Robots are authored in metres and are framed on the robot scene scale automatically.\n\nA normal snapshot uses the Solid preset and Light appearance; omitted groups inherit preset defaults.\nPass `--display render` for the shared photographic scene. Inline display JSON and\nJSON files use grouped settings such as `lighting`, `background`, and `floor`;\n`appearance` is `light` (default) or `dark`. Projection and focal length belong\nin `display.camera`. Top-level `--camera` and `--joint-values` remain active in every display\nmode. The display modes are `solid` and `render`: `edges`, `clip`, `exploded`, the\n`xray`, `hidden-line` and `wireframe` modes and the `hidden`/`off` surface styles\ndescribe a STEP model's CAD edges, parts and solids, and are refused by name here.\n\nLink meshes are resolved relative to the description, so they must be present: an\nunhydrated Git LFS pointer fails as \"No link mesh loaded for robot\". Run\n`git lfs checkout <mesh dir>` first.\n\nAn SRDF's geometry comes from its paired URDF, so it has no snapshot door of its\nown; the polymorphic `cadgen snapshot` routes one by suffix. The grammar is\n`cadgen snapshot TARGET [OUT] [flags]`, the same one every format door uses. Use\n`cadgen snapshot --help` for the complete current interface.\n\n## References\n\n- Authoring contract (structure, URDF pairing, golden skeleton): `references/authoring-contract.md`\n- SRDF workflow (URDF table extraction, edit loop): `references/srdf-workflow.md`\n- Planning ledger: `references/planning-ledger.md`\n- Validation and verification recipe: `references/validation.md`\n- End effectors: `references/end-effectors.md`\n- Disabled collisions: `references/disabled-collisions.md`\n"
}