New advertisers: 50% off your first month with code FIRSTMONTHSee slots
arpitg1304 avatar

Robotics Software Principles

Foundational software design principles for robotics modules, covering SOLID-style structure, hardware abstraction, and real-time constraints.

skills.sh installs
202
GitHub stars
405
last updated
May 25, 2026
View on GitHub

What it does

  • Covers module responsibility, dependency inversion, and interface design for perception, planning, and control code
  • Includes worked Python examples that separate perception, planning, and execution into modules with explicit ABC interfaces
  • Demonstrates hardware abstraction with ArmInterface, CameraInterface, and GripperInterface so a real UR5 and a MuJoCo arm share one contract
  • Designed for reviewing, refactoring, or designing reusable robotics libraries where sim-to-real portability matters

Install

$ npx -y skills add arpitg1304/robotics-agent-skills --skill robotics-software-principles -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

Robotics Software Design Principles

Why Robotics Software Is Different

Robotics code operates under constraints that most software never faces:

  1. Physical consequences — A bug doesn't just crash a process, it crashes a robot into a wall
  2. Real-time deadlines — Missing a 1ms control loop deadline can cause oscillation or damage
  3. Sensor uncertainty — All inputs are noisy, delayed, and occasionally wrong
  4. Hardware diversity — Same algorithm must work on 10 different grippers from 5 vendors
  5. Sim-to-real gap — Code must run identically in simulation and on real hardware
  6. Long-running operation — Robots run for hours/days; memory leaks and drift matter
  7. Safety criticality — Some failures must NEVER happen, regardless of software state

These constraints demand disciplined design. Below are principles that account for them.


Principle 1: Single Responsibility — One Module, One Job

Every module (node, class, function) should have exactly ONE reason to change.

Details

Repository
github.com/arpitg1304/robotics-agent-skills
Category
AI & Agent Building
License
Apache-2.0
First seen
Jun 11, 2026

More from arpitg1304/robotics-agent-skills

All 11

Similar to Robotics Software Principles

More AI & Agent Building