skills.rest
Waterball-Software-Academy
Waterball-Software-AcademyOFFICIAL
Explore all skills by this author →
GitHub

skill-rca

Trace defective skill outputs to the earliest faulty artifact and classify defect types.

77|15|Updated May 12, 2026
Search Tags:#acceptance criteria#workflow governance#skill rca#artifact traceability#program-like migration#defect classification#safe patch
One-click install
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill skill-rca
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-rca
Source: https://github.com/Waterball-Software-Academy/aixbdd/tree/main/.agents/skills/skill-rca
Command: npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill skill-rca

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill turns an observed defective skill output into a traceable root-cause analysis of the earliest faulty skill artifact, then proposes (and optionally applies) the smallest safe correction while preserving the original public contract.

Core Features & Use Cases

  • Root-cause traceability: pinpoints the earliest faulty skill artifact with concrete file/line evidence.
  • Defect classification: maps the issue to one or more Traditional Chinese skill defect types using a shared taxonomy.
  • Minimal corrective patch proposal: drafts the smallest artifact changes and includes backward verification (mental replay) to ensure the original defect would not recur.
  • Optional repair and reporting: can apply the patch after approval, logs clarification entries when applicable, and emits a readable RCA report; also recommends program-like reformulation when structural drift is detected.

Quick Start

Use the skill-rca workflow to analyze a defective skill artifact by providing the faulty output details, the target skill path/name, and (if available) an issue id for logging.

Frequently Asked Questions about skill-rca

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

FAQPage Schema
How do I trace the root cause of a defective skill output?▼

Root cause analysis for defective outputs works by building an artifact graph to pinpoint the earliest faulty artifact with concrete file and line evidence, then classifying the defect for targeted repair.

What is defect classification in skill root cause analysis?▼

Defect classification maps identified skill issues to a shared taxonomy of Traditional Chinese defect types, enabling targeted repair and structured corrective patch proposals.

How do I apply a minimal safe patch to fix skill artifacts?▼

To apply a minimal safe patch, draft the smallest artifact changes that preserve the original public contract, verify mentally that the defect won't recur, and apply it after user approval.

When do I need to use root cause analysis for skill review?▼

You need root cause analysis for skill review when a request asks for a review or consistency analysis identifies a skill-level issue requiring traceable artifact evidence and corrective patching.

What are the limitations of corrective patches for skill defects?▼

Corrective patches are limited to preserving the original public contract, meaning changes must be minimal and structurally safe without altering the expected public behavior or interface.

Related Skills

Explore More Software Engineering Skills→
jaskaranhundaljaskaranhundal
3

attack-path-analysis

Map adversarial attack paths from BloodHound and cloud identity data.

Community
Advanced
DuqueOMDuqueOM
5

performance-degradation-rca

Merge metrics, drift, deployment history, and data provenance to document root causes of production performance degradations.

Community
Advanced
duy-tungduy-tung

ck:debug

Debug software issues through systematic root cause analysis and verification.

Community
Advanced
muskie9muskie9

graphify

Build and analyze codebase dependency graphs with NetworkX.

Community
Advanced