---
title: "service-mesh-debug"
description: "Diagnose and fix flaky e2e tests and connectivity issues in service mesh environments (Kuma, Istio, Linkerd, Consul). Covers 11 root causes: timing races, xDS propagation delays, Gomega misuse, pod availability races, mT"
canonical: https://agentpluginsdirectory.com/plugins/service-mesh-debug
last-updated: 2026-10-10
---

# service-mesh-debug
Diagnose and fix flaky e2e tests and connectivity issues in service mesh environments (Kuma, Istio, Linkerd, Consul). Covers 11 root causes: timing races, xDS propagation delays, Gomega misuse, pod availability races, mTLS/SDS readiness, Envoy circuit breakers, and outlier detection. Includes Python scripts for live Envoy diagnostics.
- Slug: service-mesh-debug
- Publisher: Smykla Skalski Labs
- Repository: https://github.com/smykla-skalski/sai
- Manifest: plugins/service-mesh-debug/plugin.json
- Version: 1.2.3
- License: MIT
- Category (editorial): other
- Skills: 1 (service-mesh-debug)
- MCP servers: 0
- Stars: 5
- Repository created: 2026-02-12
- Repository last pushed: 2026-10-10
- Publisher type: Organization
- Listing: https://agentpluginsdirectory.com/plugins/service-mesh-debug
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What service-mesh-debug does, in the publisher's words

Diagnose and fix flaky e2e tests and connectivity issues in service mesh environments (Kuma, Istio, Linkerd, Consul).

The plugin is a portable Agent Plugin with one Agent Skill, so the same package works in Claude Code, Codex, Copilot CLI and opencode.

- 11-cause taxonomy: sourced from real Kuma PR history (timing, xDS races, Gomega misuse, pod races, mTLS/SDS, circuit breakers, outlier detection)
- Minimal fixes: matches each root cause to a precise code change, never refactors surrounding code
- Kuma-specific timeouts: 30s/60s/2m guidelines matched to operation type (pod, gateway, mTLS/cross-zone)
- Envoy debug reference: admin API cheat sheet, response flags, xDS diagnostic workflow
- Anti-pattern detection: flags FlakeAttempts, bare Expect in Eventually, time.Sleep, missing AfterEachFailure
- Multi-mesh support: Kuma (9901), Istio (15000), Consul (19000), Linkerd

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/smykla-skalski/sai/HEAD/plugins/service-mesh-debug/README.md