k8s-istio-troubleshooting SKILL.md skillA
k8s-istio-troubleshooting from k8s-servant/k8s-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add k8s-servant/k8s-skills/k8s-istio-troubleshooting@git:20261031.7e95e4fPins git:20261031.7e95e4f in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- k8s-servant/k8s-skills
- Path
skills/k8s-istio-troubleshooting/SKILL.md- Versions recorded
- 3
- Latest version
- git:20261031.7e95e4f, committed Oct 31, 2026
- First version recorded
- Oct 24, 2026
- Size
- 9,663 bytes
- Repository stars
- 35
- License
- Apache-2.0
Use when traffic fails in an Istio service mesh on Kubernetes: HTTP 403 "RBAC: access denied" from an AuthorizationPolicy, 503 "no healthy upstream" or "upstream connect error or disconnect/reset before headers", 404 from a route that does not match, "Connection reset by peer" after PeerAuthentication STRICT, sidecars that are not injected, VirtualService, DestinationRule, Gateway or ServiceEntry rules that do not apply, or istiod and proxy problems. Reads Envoy's access log and response flags…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Istio troubleshooting Find out why requests fail or behave unexpectedly in an Istio mesh, and propose a fix. **Read first, ask before changing.** Run the investigation commands freely. Run a command under an "Ask first" line only after the user approves that exact command; if your credentials do not allow it, give it to the user to run. Never run a "Proposed fix"; hand it to the user. In **sidecar mode** every meshed pod has an Envoy container, `istio-proxy`, injected when its namespace has `istio-injection=enabled` (or an `istio.io/rev` label). The client's sidecar routes by **VirtualServices** and **DestinationRules** (subsets, load balancing, TLS); the server's sidecar enforces **PeerAuthentication** (mTLS) and **AuthorizationPolicies**. Each sidecar writes an access log line per request with a **response flag** that says what Envoy did. In **ambient mode** the node's `ztunnel` handles L4 and mTLS and an optional **waypoint** proxy handles L7. The commands use placeholders: `my-namespace`, `my-app` (the server and its Service), `my-web` (the client) and `my-pod`. Replace them with the real names. The built-in …
Read the whole file at its exact version.
How to install
mdr add k8s-servant/k8s-skills/k8s-istio-troubleshooting@sha256:9b9e7f65111adf20The line at the top of this page pins the label git:20261031.7e95e4f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_npsnpv4lrxjqdzes)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Oct 24, 2026 and Oct 31, 2026, about one every 3 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261031.7e95e4f latest | 2026-10-31 | 7e95e4f | 9,663 B | A | view · diff |
| git:20261025.2ed8c84 | 2026-10-25 | 2ed8c84 | 9,660 B | A | view · diff |
| git:20261024.e10d863 | 2026-10-24 | e10d863 | 9,502 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (9663 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
k8s-servant/k8s-skills · 35 stars · license Apache-2.0 · pushed 2026-10-31 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_npsnpv4lrxjqdzes GET https://markdownregistry.com/api/v1/resolve?ref=k8s-servant/k8s-skills/k8s-istio-troubleshooting GET https://markdownregistry.com/api/v1/blob/9b9e7f65111adf20e385b3d8a7e3df112cdf4a277279ecf1ef69c32fbe9155a8
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.