robotics-agent-skills

로보틱스 소프트웨어 개발을 수행하는 AI 에이전트를 위한 SKILL.md 파일 큐레이션 컬렉션입니다. 각 기술(Skill)은 YAML 프론트매터(frontmatter), 실행 가능한 패턴(actionable patterns), 실제 코드 예시, 그리고 문서화된 안티 패턴(anti-patterns)을 포함하며 Anthropic의 기술 형식을 따릅니다.

기술 (Skill)	설명	주요 주제
robotics-software-principles/	설계 원칙 (Design Principles)	로보틱스를 위한 SOLID, 페일 세이프 기본값 (fail-safe defaults), 속도 분리 (rate separation), 합성 가능성 (composability), 우아한 성능 저하 (graceful degradation)
ros1/	ROS1 개발 (ROS1 Development)	catkin, rospy, roscpp, nodelets, tf, actionlib, launch XML, 마이그레이션 (migration)
ros2/	ROS2 개발 (ROS2 Development)	rclpy, rclcpp, DDS, QoS, 라이프사이클 노드 (lifecycle nodes), 컴포넌트 (components), Python launch
robotics-design-patterns/	아키텍처 패턴 (Architecture Patterns)	행동 트리 (Behavior trees), 유한 상태 기계 (FSMs), HAL, 안전 시스템 (safety systems), 센서 퓨전 (sensor fusion), Sim-to-Real
robot-perception/	인지 시스템 (Perception Systems)	카메라 (Cameras), LiDAR, 깊이 (depth), 캘리브레이션 (calibration), 포인트 클라우드 (point clouds), 탐지 (detection), 추적 (tracking), 센서 퓨전 (sensor fusion)
robotics-testing/	테스트 전략 (Testing Strategies)	pytest + ROS, launch_testing, 모의 하드웨어 (mock hardware), 골든 파일 (golden files), CI/CD
docker-ros2-development/	Docker + ROS2	멀티 스테이지 Dockerfile (Multi-stage Dockerfiles), docker-compose, 컨테이너 간 DDS, GPU 패스스루 (GPU passthrough), devcontainers
ros2-web-integration/	웹 통합 (Web Integration)	rosbridge, FastAPI/Flask 브리지 (bridges), WebSocket 스트리밍, REST API, MJPEG/WebRTC, 보안 (security)
robot-bringup/	시스템 브링업 (System Bringup)	systemd 서비스, launch 구성 (launch composition), udev 규칙 (udev rules), 워치독 (watchdogs), 로그 로테이션 (log rotation), 우아한 종료 (graceful shutdown)
robotics-security/	보안 및 강화 (Security & Hardening)	SROS2, DDS 암호화 (DDS encryption), 네트워크 세분화 (network segmentation), 비밀 관리 (secrets management), 비상 정지 격리 (e-stop isolation), 보안 부팅 (secure boot)

필요한 기술을 프로젝트의 .claude/skills/ 디렉토리로 복사하거나 심볼릭 링크(symlink)를 생성하세요.

# 로보틱스 프로젝트에 특정 기술을 복사합니다
cp -r /path/to/robotics-agent-skills/skills/ros2 .claude/skills/
cp -r /path/to/robotics-agent-skills/skills/robot-bringup .claude/skills/
...

Claude Code는 .claude/skills/에 있는 SKILL.md 파일을 자동으로 검색하며, YAML의 description 필드를 기반으로 이를 실행합니다.

스킬 디렉토리를 프로젝트의 /mnt/skills/user/ 디렉토리에 배치하세요. 에이전트가 YAML의 description 필드를 기반으로 이를 자동으로 감지하고 참조할 것입니다.

에이전트가 일치하는 작업(task)을 마주하면 관련 SKILL.md를 시스템 프롬프트 컨텍스트(system prompt context)로 로드합니다:

# 예시: 에이전트 스킬 로더 (Agent skill loader)
def load_skill(task_description: str) -> str:
    skills = {
...

from langchain.tools import Tool
ros2_skill = Tool(
    name="ROS2 Development Guide",
    ...

이러한 스킬들은 몇 가지 핵심 원칙을 따릅니다:

이론보다 실행 가능성 (Actionable over theoretical) — 모든 패턴에는 작동하는 코드가 포함됩니다.
안티 패턴 문서화 (Anti-patterns documented) — 성공 사례뿐만 아니라 일반적인 실수로부터 배웁니다.
점진적 복잡성 (Progressive complexity) — 기초부터 시작하여 고급 패턴을 계층적으로 쌓아 올립니다.
포맷 불가지론 (Format-agnostic) — 스킬은 어떤 에이전트 프레임워크(agent framework)와도 작동합니다.
실제 실패 모드 (Real failure modes) — 실제 운영 환경(production)에서 무엇이 깨지는지 문서화합니다.

표준 스킬 형식을 따르세요:

my-new-skill/
├── SKILL.md # 필수: YAML 프론트매터 (frontmatter)가 포함된 메인 스킬 파일
├── references/ # 선택 사항: 상세 참조 문서
...

YAML 프론트매터에는 반드시 다음 항목이 포함되어야 합니다:

name: 스킬 식별자 (kebab-case)
description: 트리거 시점 (구체적이고 "강력하게" 작성 — 명시적인 트리거 문구를 나열하세요)

Robot System Architecture
├── Design Principles ──── robotics-software-principles/ (SOLID, 안전성, 구성 가능성)
├── Middleware ──────────── ros1/, ros2/
...

고려할 향후 스킬 목록:

robotics-data-pipelines/ — RLDS, LeRobot, Zarr, 포맷 변환, 비대칭 I/O, 큐레이션 (curation)
robot-simulation/ — MuJoCo, Isaac Sim, Gazebo 설정 및 모범 사례 (best practices)
robot-manipulation/ — MoveIt2, 파지 계획 (grasp planning), 힘/토크 제어 (force/torque control), pick-and-place 파이프라인
robot-navigation/ — Nav2, SLAM, 경로 계획 (path planning), 코스트맵 (costmaps), 위치 추정 (localization)
robot-learning/ — 모방 학습 (Imitation learning), 강화학습 (RL), VLA 모델 미세 조정 (fine-tuning), 정책 배포 (policy deployment)
ros2-control/ — ros2_control 프레임워크, 하드웨어 인터페이스, 컨트롤러, PID 튜닝, 실시간 (real-time)
robot-description/

— URDF, Xacro, 관절 유형 (joint types), 관성 (inertials), 충돌 메쉬 (collision meshes), SDF, robot_state_publisher
robot-hardware-interfaces/

— 시리얼 (Serial) (UART, RS485), CAN 버스 (CAN bus), EtherCAT, GPIO, I2C/SPI, 커스텀 드라이버 (custom drivers)
tf2-transforms/

— 좌표계 (Coordinate frames), 정적 변환 대 동적 변환 (static vs dynamic transforms), 프레임 규약 (frame conventions), 타임 트래블 (time travel), 디버깅 (debugging)
multi-robot-systems/

— 플릿 관리 (Fleet management), 네임스페이싱 (namespacing), 다중 로봇 협업 (multi-robot coordination), 작업 할당 (task allocation), DDS 파티션 (DDS partitions)
robot-debugging/

— ros2 doctor, rqt, 트레이싱 (tracing), CPU/메모리 프로파일링 (CPU/memory profiling), 백 레코딩 및 재생 (bag recording and replay), 진단 (diagnostics)