Troubleshooting Skill Creation Guide

Use this guide to build high-quality troubleshooting skills that enable AI agents to diagnose complex failures in GKE workloads.

🏗️ Skill Structure Standard

Mandatory Components

1. SKILL.md: The core diagnostic and resolution workflow.
2. README.md: Public-facing overview and "When to use" guide.
3. references/failure_signatures.md: Authentic log/metric signatures.
4. scripts/validate_queries.sh: Automatic syntax validator for all queries.
5. TEST.md: Manual verification plan for humans.
6. EVAL.textproto: Evaluation suite for performance tracking.

Optional Components