arpitg1304 avatar

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-code

Installs 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:

  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.

Sponsors

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
1chengzuopeng avatarmarket-overviewchengzuopeng/stock-sdk-mcp市场概览 - 快速了解大盘走势和热点板块,把握市场脉搏194skills.sh installs
2get-convex avatarmigration-helperget-convex/convex-agent-pluginsPlan and execute Convex schema migrations safely, including adding fields, creating tables, and data transformations. Use when schema changes affect existing da194skills.sh installs
3sergiodxa avatarfrontend-internationalization-best-practicessergiodxa/agent-skillsInternationalization best practices for React Router framework mode using remix-i18next. Use when setting up locales, middleware, resource routes, or language s193skills.sh installs
4buiducnhat avatarbootstrapbuiducnhat/agent-skillsbootstrap192skills.sh installs
5hoodini avatarbunhoodini/ai-agents-skillsBuild fast applications with Bun JavaScript runtime. Use when creating Bun projects, using Bun APIs, bundling, testing, or optimizing Node.js alternatives. Trig191skills.sh installs
6itechmeat avatarchangelogitechmeat/llm-codeKeep a Changelog format. Covers structure, change types, versioning. Use when creating or updating CHANGELOG.md files following the Keep a Changelog specificati191skills.sh installs