🤖 Магазин навыков для робототехники

Курируемая коллекция SKILL.md-файлов для AI-агентов, работающих над разработкой робототехнического ПО. Каждый навык следует формату Anthropic: YAML frontmatter, практические паттерны, реальные примеры кода и задокументированные антипаттерны.

Навыки

Навык	Описание	Ключевые темы
robotics-software-principles/	Принципы проектирования	SOLID для робототехники, безопасные значения по умолчанию, разделение частот, компонуемость, graceful degradation
ros1/	Разработка на ROS1	catkin, rospy, roscpp, nodelets, tf, actionlib, launch XML, миграция
ros2/	Разработка на ROS2	rclpy, rclcpp, DDS, QoS, lifecycle nodes, компоненты, Python launch
robotics-design-patterns/	Архитектурные паттерны	Деревья поведения, FSM, HAL, системы безопасности, слияние данных сенсоров, sim-to-real
robot-perception/	Системы восприятия	Камеры, LiDAR, глубина, калибровка, облака точек, детекция, трекинг, слияние сенсоров
robotics-testing/	Стратегии тестирования	pytest + ROS, launch_testing, mock-оборудование, golden files, CI/CD
docker-ros2-development/	Docker + ROS2	Многоэтапные Dockerfiles, docker-compose, DDS между контейнерами, проброс GPU, devcontainers
ros2-web-integration/	Веб-интеграция	rosbridge, мосты FastAPI/Flask, WebSocket-стриминг, REST API, MJPEG/WebRTC, безопасность
robot-bringup/	Запуск системы	systemd-сервисы, компоновка launch-файлов, udev-правила, watchdog-и, ротация логов, graceful shutdown
robotics-security/	Безопасность и защита	SROS2, шифрование DDS, сегментация сети, управление секретами, изоляция e-stop, secure boot

Как агенты используют эти навыки

В Claude Code

Скопируйте или создайте символические ссылки на нужные навыки в директорию .claude/skills/ вашего проекта:

bash

# Copy specific skills into your robotics project
cp -r /path/to/robotics-agent-skills/skills/ros2 .claude/skills/
cp -r /path/to/robotics-agent-skills/skills/robot-bringup .claude/skills/

# Or symlink to avoid duplication
ln -s /path/to/robotics-agent-skills/skills/ros2 .claude/skills/ros2

Claude Code автоматически обнаруживает SKILL.md-файлы в .claude/skills/ и активирует их на основе поля description в YAML.

В Claude Projects

Разместите директории с навыками в /mnt/skills/user/ вашего проекта. Агент автоматически обнаружит и будет ссылаться на них на основе поля description в YAML.

В пользовательских фреймворках агентов

Загружайте нужный SKILL.md как контекст системного промпта, когда агент встречает подходящую задачу:

# Example: Agent skill loader
def load_skill(task_description: str) -> str:
    skills = {
        'ros1': 'skills/ros1/SKILL.md',
        'ros2': 'skills/ros2/SKILL.md',
        'design': 'skills/robotics-design-patterns/SKILL.md',
        'perception': 'skills/robot-perception/SKILL.md',
        'testing': 'skills/robotics-testing/SKILL.md',
        'docker': 'skills/docker-ros2-development/SKILL.md',
        'web': 'skills/ros2-web-integration/SKILL.md',
        'bringup': 'skills/robot-bringup/SKILL.md',
        'security': 'skills/robotics-security/SKILL.md',
    }
    # Match task to skill and inject into context
    for key, path in skills.items():
        if key in task_description.lower():
            return open(path).read()

С LangChain / LlamaIndex

from langchain.tools import Tool

ros2_skill = Tool(
    name="ROS2 Development Guide",
    description="Best practices for ROS2 development including QoS, lifecycle nodes, DDS configuration",
    func=lambda q: open("skills/ros2/SKILL.md").read()
)

Принципы проектирования

Эти навыки следуют нескольким ключевым принципам:

Практичность важнее теории — каждый паттерн включает рабочий код
Антипаттерны задокументированы — учитесь на типичных ошибках, а не только на успехах
Нарастающая сложность — начинайте с основ, добавляйте продвинутые паттерны постепенно
Независимость от формата — навыки работают с любым агентным фреймворком
Реальные сценарии отказов — задокументировано то, что действительно ломается в production

Добавление новых навыков

Следуйте стандартному формату навыка:

my-new-skill/
├── SKILL.md           # Required: Main skill file with YAML frontmatter
├── references/        # Optional: Detailed reference docs
│   └── advanced.md
└── scripts/           # Optional: Executable helper scripts
    └── validate.py

YAML frontmatter должен включать:

name: идентификатор навыка (kebab-case)
description: условие активации (будьте конкретны — перечисляйте явные триггерные фразы)

Карта покрытия

Robot System Architecture
├── Design Principles ──── robotics-software-principles/ (SOLID, safety, composability)
├── Middleware ──────────── ros1/, ros2/
├── Behaviors ──────────── robotics-design-patterns/ (BT, FSM)
├── Perception ─────────── robot-perception/ (cameras, LiDAR, depth, calibration, fusion)
├── Planning ───────────── robotics-design-patterns/ (motion planning)
├── Control ────────────── robotics-design-patterns/ (control loops)
├── Safety ─────────────── robotics-design-patterns/ (watchdogs, limits)
├── Testing ────────────── robotics-testing/ (unit, integration, sim)
├── Containerization ───── docker-ros2-development/ (Dockerfiles, compose, DDS, GPU)
├── Web Interfaces ─────── ros2-web-integration/ (REST, WebSocket, streaming, dashboards)
├── System Bringup ─────── robot-bringup/ (systemd, udev, watchdogs, boot sequence)
├── Security ──────────── robotics-security/ (SROS2, hardening, e-stop isolation)
└── Deployment ─────────── ros2/ (production checklist, CI/CD)

Дорожная карта

Планируемые навыки:

robotics-data-pipelines/ — RLDS, LeRobot, Zarr, конвертация форматов

Навыки агента для робототехники

Установка

README