bt-action-discovery
Discovers available robot actions by reading action_library.yaml. Returns action catalog with parameters and constraints for BT generation and validation.
When & Why to Use This Skill
The bt-action-discovery skill streamlines robotics development by automatically discovering and cataloging available robot actions from configuration files. It extracts detailed parameters, constraints, and usage examples for both primitive and composite actions, providing the foundational data required for automated Behavior Tree (BT) generation and rigorous action validation.
Use Cases
- Automated Behavior Tree Generation: Supplies the necessary action schema and constraints to AI agents for creating valid robot logic sequences.
- Action Validation and Guardrails: Ensures that proposed robot commands adhere to predefined workspace bounds and parameter ranges before execution.
- Robot Capability Mapping: Generates a structured catalog of supported robot actions and services, facilitating easier integration and documentation for developers.
| name | bt-action-discovery |
|---|---|
| description | Discovers available robot actions by reading action_library.yaml. Returns action catalog with parameters and constraints for BT generation and validation. |
Purpose
This skill discovers what actions the robot supports. Currently reads from action_library/action_library.yaml. In the future, this will query the robot's advertised ROS services/actions dynamically.
Workflow
- Read
action_library/action_library.yaml - Parse available primitive and composite actions
- Return structured action catalog
Output Format
Return the following information:
Primitives
- Action name
- Package location
- Parameters (name, type, required, default, description)
- Valid ranges
- Example usage
Composites
- Action name
- Package location
- Parameters
- Example usage
Constraints
- Workspace bounds (x_range, y_range)
- Color value ranges
- Default spawn position
Example Usage
When invoked, this skill reads the YAML and returns:
Available Primitive Actions:
- GoToPose(name, x, y, theta=None, tolerance_pos=0.1, tolerance_angle=0.1)
- x, y must be in [0, 11]
- Example: GoToPose(name='Move', x=5.0, y=5.0)
- SetPen(name, r=255, g=255, b=255, width=3, off=0)
- RGB values in [0, 255]
- Example: SetPen(name='Red', r=255, g=0, b=0, width=3)
[... continues for all actions ...]
Workspace Constraints:
- x_range: [0, 11]
- y_range: [0, 11]
- Default spawn: (5.544445, 5.544445)
Notes
- This skill has low degree of freedom - it simply reads and returns the YAML content in a structured format
- Future enhancement: Query live robot instead of static YAML file
- Invoked by: bt-composer (during generation) and bt-validator (during validation)