rca-annotator

Guide users through labeling root-cause-analysis outputs with evidence traceability.

9|10|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/redhat-et/rhdp-rca-plugin --skill rca-annotator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rca-annotator
Source: https://github.com/redhat-et/rhdp-rca-plugin/tree/main/skills/rca-annotator
Command: npx skills add https://github.com/redhat-et/rhdp-rca-plugin --skill rca-annotator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill helps human reviewers validate and label automated root-cause-analysis outputs by capturing whether the agent diagnosis is correct, logging precise evidence traceability, scoring difficulty, and recording alternative hypotheses for dataset building and evaluation.

Core Features & Use Cases

  • Interactive annotation workflow: Presents the agent's final diagnosis and walks a user through category confirmation, summary accuracy, evidence validation, difficulty calibration, and alternative diagnosis capture.
  • Evidence traceability: Requires and enforces source_file, json_path, exact_value/quote and line references so each evidence item is auditable.
  • Jumpbox synchronization: Optional download and upload of analysis artifacts and annotations via SSH/rsync/scp for environments that use a remote MLflow artifact store.
  • Use case: Manually curate ground-truth labels for RCA agent outputs to build benchmarks, iterate agent improvements, or produce training data.

Quick Start

Run an interactive annotation session for job 1234567 to review the agent's step5_summary, label evidence and difficulty, and save annotation.json to the .analysis/1234567 directory.

Frequently Asked Questions about rca-annotator

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

FAQPage Schema
How do I label root cause analysis outputs to build evaluation datasets?

You can label root cause analysis outputs by interactively reviewing agent diagnoses, confirming categories, validating evidence traceability, scoring difficulty, and capturing alternative hypotheses to produce structured annotation files.

What is evidence traceability in root cause analysis annotation?

Evidence traceability in root cause analysis annotation enforces source_file, json_path, exact_value, and line references for each item, ensuring every diagnosis label is auditable and grounded in the original logs.

How do I annotate RCA results stored on a remote MLflow artifact store?

You can annotate RCA results on a remote MLflow artifact store by using the jumpbox synchronization feature, which downloads and uploads analysis artifacts and annotations via SSH, rsync, or scp.

What files are required to validate automated root cause analysis diagnoses?

Validating automated root cause analysis diagnoses requires completed jobs containing step1_job_context.json, step3_correlation.json, step4_github_fetch_history.json, and step5_summary.json in the local .analysis directory.

Can I use this annotation workflow without SSH access to a jumpbox?

Yes, you can use the annotation workflow without SSH access by reading artifacts directly from a local .analysis/<job_id> directory, as jumpbox synchronization is an optional feature for remote environments.

What limitations exist when curating ground truth labels for RCA agent outputs?

A key limitation is that annotation depends entirely on the presence of completed RCA job artifacts; without the required step1 through step5 JSON files, the interactive labeling and evidence validation workflow cannot proceed.