ric-xapp-dev
Guidance for developing OSC RIC xApps (RC/KPM/E2 subscription patterns), safe integration steps, and common pitfalls (polling vs periodic reporting).
When & Why to Use This Skill
This Claude skill provides expert guidance for developing O-RAN Software Community (OSC) RIC xApps, focusing on RC, KPM, and E2 subscription patterns. It streamlines the integration process by enforcing best practices for gRPC communication, RMR message flows, and periodic reporting, helping developers build scalable and maintainable telecommunications software while avoiding common architectural pitfalls.
Use Cases
- Developing E2 subscription services and KPM periodic reporting modules for real-time RAN monitoring.
- Implementing gRPC-based RAN Control (RC) integrations with isolated, modular communication layers.
- Designing robust RMR message handling logic to ensure reliable data flow between RIC components.
- Configuring external endpoints and simulation modes for offline testing and troubleshooting of xApp logic.
| name | ric-xapp-dev |
|---|---|
| description | Guidance for developing OSC RIC xApps (RC/KPM/E2 subscription patterns), safe integration steps, and common pitfalls (polling vs periodic reporting). |
| allowed-tools | Read, Grep, Glob, Bash |
RIC xApp Development Skill
Use this Skill when implementing anything that touches:
- RC xApp gRPC integration
- E2 subscription / KPM periodic reporting
- RMR message flow assumptions
Rules of thumb
- Prefer subscription periodic reporting over xApp polling loops.
- Keep integration points isolated: only one module should speak gRPC to RC (
beam_tracking/ric/rc_grpc_client.py). - All external endpoints must be configurable (host/port/timeout).
- Always add a "sim mode" fallback to reproduce issues offline.
Files to consult
docs/03_kpm_reporting_period_notes.mdbeam_tracking/ric/rc_grpc_client.py.claude/commands/gen-rc-protos.md
Output expectations
When you propose changes:
- list exact files + functions
- provide small diff-sized code blocks
- include a minimal test plan