Robotics Agent Skills

Десять скиллов по робототехнике: ROS 1 и ROS 2, QoS, тесты, Docker, запуск робота, восприятие и защита для агентов-программистов

  • 393 ★ репозитория
  • Последний коммит
  • Apache-2.0
Скилл

Минимальный доступ

Почему такой уровень

  • Скиллы состоят из инструкций и примеров кода: сами они ничего не запускают и не обращаются к сети
Все причины и проверки

arpitg1304/robotics-agent-skills

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/robotics-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скиллы состоят из инструкций и примеров кода: сами они ничего не запускают и не обращаются к сети

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Robotics Agent Skills — набор из десяти файлов SKILL.md, которые добавляют агенту инженерные знания по робототехнике. Общие модели хорошо знают синтаксис ROS, но промахиваются в деталях, важных для работы на настоящем роботе: совместимость QoS, предсказуемый запуск, ограниченные обратные вызовы, проверки датчиков и безопасное завершение. В наборе есть скиллы по ROS 1 и ROS 2, принципам проектирования, шаблонам архитектуры, восприятию, тестированию, Docker, веб-интеграции, запуску робота и безопасности. Скилл `ros2` охватывает `rclpy`, `rclcpp`, DDS, QoS, жизненный цикл узлов и компоненты. Скилл восприятия говорит про камеры, лидары, калибровку и облака точек. Скилл запуска описывает службы systemd, правила udev и сторожевые таймеры. Автор приводит и сравнение на одном запросе, где агент пишет пакет ROS 2 без скиллов и с ними. С ними получился узел с жизненным циклом, разные профили QoS для сенсоров и статуса, буферы с учетом потерь и 601 строка тестов, без них тестов не было. Автор оговаривает, что это единичный запуск без проверки на реальной сборке и его нельзя считать замером.

Для кого. Для разработчиков роботов на ROS, которые пишут узлы, запуск и тесты вместе с Claude Code, Cursor или другим агентом, умеющим читать SKILL.md.

Подходит, если

  • Агент пишет пакет ROS 2, и нужны узлы с жизненным циклом, правильные профили QoS и параметры
  • Надо поддерживать старый проект на ROS 1 с catkin, `rospy`, узлами nodelet и файлами запуска в формате XML, а затем переносить его на ROS 2
  • Робот должен стартовать сам при включении питания: службы systemd, правила udev, сторожевые таймеры и ротация журналов
  • Нужны тесты для узлов: `pytest` с ROS, `launch_testing`, подмена оборудования и CI
  • Пакеты ROS 2 запускаются в контейнерах, с передачей DDS между ними и доступом к GPU

Не подходит, если

  • Нужны навигация Nav2, манипуляция MoveIt2 или симуляция: отдельные скиллы для них автор только планирует
  • Проект не связан с роботами и ROS: набор не принесет пользы вне робототехники
  • Нужна готовая система управления роботом: скиллы дают агенту знания и шаблоны, а программу пишет агент
  • Нужны доказанные улучшения по метрикам: сравнение автора единичное и самооценочное, это иллюстрация, а не тест

Пример запроса к агенту

Напиши пакет ROS 2 для записи демонстраций робота: узел с жизненным циклом, QoS для камеры и суставов, тесты и launch-файл.

Ограничения

Набор покрывает ROS 1 и ROS 2, но не полный круг задач робототехники. В дорожной карте автор называет еще не написанные скиллы: навигацию Nav2, манипуляцию MoveIt2, ros2-control, симуляцию, описание робота в URDF, отладку, конвейеры данных и многороботные системы.

Сравнение со скиллами и без них проводилось один раз, оценивал его сам автор, и ни один из двух пакетов не собирали на настоящем дистрибутиве ROS 2. Известные дефекты сборки перечислены в отчете evals/EVAL_REPORT.md. Скиллы кладут в каталог `.claude/skills/` проекта или, для Autohand Code, в `.autohand/skills/`, а в произвольных фреймворках подгружают файл SKILL.md в системный промпт.

Репозиторий не обращается к внешним сервисам, ограничений для России у набора нет.

Как отключить. Удалите папки установленных скиллов из каталога `.claude/skills/` проекта или соответствующего каталога другого агента. Клон репозитория можно удалить отдельно, на работу уже установленных скиллов он не влияет.

Частые вопросы

Как поставить Robotics Agent Skills в Claude Code?

Склонируйте репозиторий и запустите install.sh с каталогом `.claude/skills` вашего проекта в параметре --target и списком нужных скиллов в --skills. Либо скопируйте папки из каталога skills вручную, например командой cp -R skills/ros2 в каталог скиллов проекта.

Какие скиллы входят в набор?

Десять: `robotics-software-principles`, `ros1`, `ros2`, `robotics-design-patterns`, `robot-perception`, `robotics-testing`, `docker-ros2-development`, `ros2-web-integration`, `robot-bringup` и `robotics-security`.

Какие скиллы взять для робота в эксплуатации?

Автор рекомендует комплект «Робот в эксплуатации»: ros2, robot-bringup, robotics-security и robotics-testing. Для приложения на ROS 2 добавьте принципы проектирования, а для поддержки старого кода возьмите ros1.

Работает ли набор в Cursor и других агентах?

Формат SKILL.md понимают Claude Code, Autohand Code, Cursor и агенты вроде Copilot. В собственных фреймворках файл подгружают в системный промпт, пример кода на Python приведен в README.

Насколько надежно подтверждение пользы скиллов?

Слабо, и автор это признает. В сравнении один запуск с одним запросом, оценка самостоятельная, а пакеты не собирали на настоящем ROS 2. Это иллюстрация решений, к которым подталкивают скиллы, а не замер.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Набор независимых скиллов против дрейфа в больших кодовых базах: hard-cut, поиск первопричины, тесты и проверка CI.

СкиллМинимальный доступ139Звезды репозитория

Набор из 16 инженерных скиллов для агентов: разработка под Apple, упаковка macOS, производительность React, ревью и рефакторинг кода

СкиллРасширенный доступ4 тыс.Звезды репозитория

Builder Skills

Skills for agents

Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные

СкиллРасширенный доступ4,6 тыс.Звезды репозитория

Проверяемый реестр скиллов с CLI для установки в два десятка агентов и MCP-сервером для поиска скиллов на лету

СкиллРасширенный доступ7,1 тыс.Звезды репозитория

Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации

СкиллШирокий доступ7,5 тыс.Звезды репозитория

Свыше 1100 готовых скиллов для Claude Code, Codex, Gemini CLI и Cursor и MCP-сервер, который подбирает скилл под задачу

СкиллРасширенный доступ192Звезды репозитория

Коротко о README

README объясняет, зачем нужен слой робототехники поверх общих агентов, показывает таблицу сравнения, готовые комплекты скиллов под типовые задачи и способы подключения в Claude Code, Autohand Code, проекты Claude и собственные фреймворки. Завершают его дорожная карта из восьми будущих скиллов и ссылка на правила участия.

Бейдж для README

Исходный SKILL.md

---
name: ros2
description: >
  Comprehensive best practices, design patterns, and common pitfalls for ROS2 (Robot Operating System 2)
  development. Use this skill when building ROS2 nodes, packages, launch files, components, or debugging
  ROS2 systems. Trigger whenever the user mentions ROS2, colcon, rclpy, rclcpp, DDS, QoS, lifecycle nodes,
  managed nodes, ROS2 launch, ROS2 parameters, ROS2 actions, nav2, MoveIt2, micro-ROS, or any ROS2-era
  robotics middleware. Also trigger for ROS2 workspace setup, DDS tuning, intra-process communication,
  ROS2 security, or deploying ROS2 in production. Also trigger for colcon build issues, ament_cmake,
  ament_python, CMakeLists.txt for ROS2, package.xml dependencies, rosdep, workspace overlays, custom
  message generation, or ROS2 build troubleshooting. Covers Humble, Iron, Jazzy, and Rolling distributions.
---

# ROS2 Development Skill

## When to Use This Skill
- Building ROS2 packages, nodes, or component containers
- Setting up colcon workspaces, ament_cmake, or ament_python packages
- Writing CMakeLists.txt, package.xml, or setup.py for ROS2
- Defining custom messages, services, or actions
- Writing Python launch files with conditional logic
- Configuring DDS middleware and QoS profiles
- Implementing lifecycle (managed) nodes
- Working with Nav2, MoveIt2, or other ROS2 frameworks
- Debugging DDS discovery, QoS mismatches, or build failures
- Deploying ROS2 to production or embedded systems (micro-ROS)
- Setting up CI/CD for ROS2 packages

## Core Architecture

### 1. Node Design Patterns

**Basic Node (rclpy)**:
```python
#!/usr/bin/env python3
import rclpy
from rclpy.node import Node
from rclpy.qos import QoSProfile, ReliabilityPolicy, HistoryPolicy
from std_msgs.msg import String

class PerceptionNode(Node):
    def __init__(self):
        super().__init__('perception_node')

        # 1. Declare parameters with types and descriptions
        self.declare_parameter('rate_hz', 30.0,
            descriptor=ParameterDescriptor(
                description='Processing rate in Hz',
                floating_point_range=[FloatingPointRange(
                    from_value=1.0, to_value=120.0, step=0.0

Сообщить о проблеме

Foxx AIRobotics Agent Skills
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.