
Robotics Software Principles
If you've ever fought a monolithic robot controller where changing a camera driver somehow breaks your motion planner, this walks through the classical SOLID principles reinterpreted for robotics constraints. It covers dependency inversion for sim-to-real portability, single responsibility when physical consequences amplify coupling costs, and interface design for swappable hardware. The examples are concrete (UR5 vs MuJoCo arms behind the same interface, separated perception/planning/execution modules) and the framing is honest about why normal software principles need sharper teeth when code controls physical systems with real-time deadlines. Use it when reviewing robotics codebases or designing APIs that need to work across vendors and simulation.
- skills.sh installs
- 194
- GitHub stars
- 400
- last updated
- May 25, 2026
Install
$ npx -y skills add arpitg1304/robotics-agent-skills --skill robotics-software-principles --agent claude-codeInstalls into .claude/skills of the current project.
Files
Robotics Software Design Principles
Why Robotics Software Is Different
Robotics code operates under constraints that most software never faces:
- Physical consequences — A bug doesn't just crash a process, it crashes a robot into a wall
- Real-time deadlines — Missing a 1ms control loop deadline can cause oscillation or damage
- Sensor uncertainty — All inputs are noisy, delayed, and occasionally wrong
- Hardware diversity — Same algorithm must work on 10 different grippers from 5 vendors
- Sim-to-real gap — Code must run identically in simulation and on real hardware
- Long-running operation — Robots run for hours/days; memory leaks and drift matter
- 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.
Sponsors
Details
- Repository
- github.com/arpitg1304/robotics-agent-skills
- Category
- AI & Agent Building
- License
- Apache-2.0
- First seen
- Jun 11, 2026