ros2-build-resolver

Diagnose Colcon ROS 2 build failures and propose CMake and rosdep fixes.

8|2|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/p1tl0rd/antigravity-ros2-skills --skill ros2-build-resolver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ros2-build-resolver
Source: https://github.com/p1tl0rd/antigravity-ros2-skills/tree/main/.agent/skills/ros2-build-resolver
Command: npx skills add https://github.com/p1tl0rd/antigravity-ros2-skills --skill ros2-build-resolver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ROS 2 Colcon build failures (CMake linking errors, missing dependencies, and Python issues) are diagnosed and fixed automatically to keep development moving.

Core Features & Use Cases

  • Analyze failure types (CMake, Python, dependencies, interface issues) and propose targeted fixes.
  • Apply common ROS 2 build fixes (ament_target_dependencies, rosdep validation, and package.xml checks) to ensure successful builds.
  • Use case: When a workspace fails during colcon build, the resolver suggests fixes and helps regenerate a clean build environment.

Quick Start

Describe a failing ROS 2 Colcon build in your workspace and let the agent propose targeted fixes.

Frequently Asked Questions about ros2-build-resolver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix CMake linking errors during a ROS 2 Colcon build?

Resolve missing ROS 2 dependencies by running rosdep validation checks and correcting package.xml declarations. The resolver diagnoses dependency failures and provides actionable fixes to ensure reproducible Colcon workflows and a clean build environment.

Why does colcon build fail due to missing dependencies in my ROS 2 workspace?

Colcon build fails when package.xml dependencies are not installed or declared correctly. The resolver identifies missing dependencies, applies rosdep validation, and recommends package.xml updates to ensure successful ROS 2 workspace compilation.

Can this resolver diagnose Python module issues in a ROS 2 Colcon build?

The resolver analyzes ROS 2 Colcon build failures by evaluating CMake configurations, Python module issues, and rosdep dependencies. It identifies failure types and recommends ament_target_dependencies updates, package.xml checks, and validation steps to regenerate a clean build environment.

What is the best way to ensure reproducible workflows when fixing ROS 2 build failures?

Ensure reproducible workflows by applying diagnostic steps, recommended CMake config updates, and rosdep validation. The resolver provides actionable fixes for CMake linking errors and missing dependencies to achieve a clean ROS 2 build environment.

Do I need to provide my Colcon build error logs for the resolver to suggest fixes?

Yes, describe the failing ROS 2 Colcon build in your workspace. The resolver uses the failure details to analyze CMake, Python, and dependency issues, proposing targeted fixes to regenerate a clean build environment.