physicalai-runtime-adding-a-robot-integration
Adds or modifies robot hardware integrations under physicalai.robot. Use when implementing the Robot protocol, SO101 or Trossen WidowX drivers, robot connect helpers, verify.py checks, optional extras so101 or trossen, or tests in tests/unit/robot.
How do I install this agent skill?
npx skills add https://github.com/openvinotoolkit/physicalai --skill physicalai-runtime-adding-a-robot-integrationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides documentation and guidelines for implementing robot hardware integrations. It includes explicit security requirements for developers to validate user inputs and avoid unsafe command execution.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Adding a Robot Integration
Robots satisfy the structural Robot protocol in src/physicalai/robot/interface.py — no base class inheritance required. References: src/physicalai/robot/so101/, src/physicalai/robot/trossen/ (WidowX). Connection helpers: src/physicalai/robot/connect.py; validation: src/physicalai/robot/verify.py.
Workflow
- Read
references/robot-protocol.mdand an existing integration (SO-101 for serial servos, WidowX for arms).- Done when: required methods and observation shape are listed.
- Implement connect lifecycle: idempotent
connect(),disconnect(),is_connected(). - Observations: return a type exposing
joint_positions,timestamp(time.monotonic()), optionalsensor_data/images; implementstateproperty when inference expects more than positions. - Actions:
send_action(action, *, goal_time=...)withactionshape matching training data conventions; document joint order viajoint_names. - Optional extra in
pyproject.toml(physicalai[so101],physicalai[trossen]); lazy-import vendor SDKs. - Export public class from
physicalai.robotwhen user-facing. - Tests under
tests/unit/robot/with mocked hardware.- Done when:
uv run pytest tests/unit/robot -k <name>passes.
- Done when:
- Verification CLI/docs — wire
verify.pypatterns if the robot supports automated checks.
Required checks
isinstance(robot, Robot)at runtime (@runtime_checkableprotocol).- No action sent when disconnected.
- Joint count and
joint_namesstay stable across connect/disconnect. - Security: validate user-supplied port/path strings; no shell invocation with unsanitized device paths.
References
references/robot-protocol.mddocs/explanation/robots.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/openvinotoolkit/physicalai/physicalai-runtime-adding-a-robot-integration">View physicalai-runtime-adding-a-robot-integration on skillZs</a>