AGENTS.mdA

AGENTS.md from k8s-servant/k8s-skills is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add k8s-servant/k8s-skills/AGENTS.md@git:20261031.5a211a5

Pins git:20261031.5a211a5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
k8s-servant/k8s-skills
Path
AGENTS.md
Versions recorded
5
Latest version
git:20261031.5a211a5, committed Oct 31, 2026
First version recorded
Oct 25, 2026
Size
4,469 bytes
Repository stars
35
License
Apache-2.0

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

# AGENTS.md

Guidance for AI coding assistants working in this repository. Humans: see
[CONTRIBUTING.md](CONTRIBUTING.md). `CLAUDE.md` only imports this file.

## Project

k8s-skills is a set of Kubernetes troubleshooting skills (`skills/<name>/SKILL.md`) for
any AI agent, which read first and ask before changing anything, plus the tooling that
checks them (`tools/skillcheck`) and a kind-based test kit (`tests/`).

## Commands

```bash
python3 -m venv .venv && .venv/bin/pip install --require-hashes -r requirements-dev.txt   # setup
.venv/bin/pytest                                         # tests
.venv/bin/ruff check . && .venv/bin/ruff format --check .   # lint
.venv/bin/python -m tools.skillcheck check               # check every skill
.venv/bin/python -m tools.skillcheck manifests --write   # regenerate install manifests
.venv/bin/python -m tools.skillcheck manifests --check   # fail if manifests are stale
.venv/bin/python -m tools.skillcheck package --out dist  # release zips
tests/cluster.sh up [--cni calico|cilium] | down          # throwaway kind cluster
tests/addon.sh <name>                                    # install a pinned add-on (names: see the script)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add k8s-servant/k8s-skills/AGENTS.md@sha256:f1d5cd64eba9756b

The line at the top of this page pins the label git:20261031.5a211a5, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_xk4yzdvdxzktpsra.svg)](https://markdownregistry.com/a/art_xk4yzdvdxzktpsra)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 25, 2026 and Oct 31, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261031.5a211a5 latest2026-10-31 5a211a5 4,469 BA view · diff
git:20261031.fd967232026-10-31 fd96723 4,452 BA view · diff
git:20261029.82fb6ff2026-10-29 82fb6ff 4,358 BA view · diff
git:20261025.6c26baa2026-10-25 6c26baa 4,316 BA view · diff
git:20261025.304d6762026-10-25 304d676 4,108 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (4469 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

GitHub

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_xk4yzdvdxzktpsra
GET https://markdownregistry.com/api/v1/resolve?ref=k8s-servant/k8s-skills/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/f1d5cd64eba9756b32345d7acbe98899fab9fabbd0aa2c1460834965b7e393a7

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from k8s-servant/k8s-skills

CLAUDE.md CLAUDE.md file
k8s-servant/k8s-skills · CLAUDE.md
git:20261023.5a5bb12 · audit B · 35 stars
k8s-aks-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-aks-troubleshooting/SKILL.md · Use when a problem is specific to Azure Kubernetes Service (AKS): a cluster or node pool in "Failed" state, an upgrade…
git:20261031.8d9def9 · audit A · 35 stars
k8s-api-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-api-troubleshooting/SKILL.md · Use when the Kubernetes API server itself refuses or fails a request, before any controller acts on it: "failed calling…
git:20261025.b852b9e · audit A · 35 stars
k8s-argocd-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-argocd-troubleshooting/SKILL.md · Use when Argo CD does not deploy or update an application in Kubernetes: an Application that is OutOfSync, Unknown…
git:20261024.1d1d765 · audit A · 35 stars
k8s-autoscaling-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-autoscaling-troubleshooting/SKILL.md · Use when Kubernetes autoscaling does not scale as expected: a HorizontalPodAutoscaler whose TARGETS show "<unknown>"…
git:20261025.f355dae · audit A · 35 stars
k8s-cert-manager-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-cert-manager-troubleshooting/SKILL.md · Use when cert-manager does not issue or renew a certificate in Kubernetes: a Certificate that stays READY False, a…
git:20261024.482781a · audit A · 35 stars
k8s-cilium-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-cilium-troubleshooting/SKILL.md · Use when networking fails on a Kubernetes cluster that runs Cilium as its CNI: traffic between pods dropped or timing…
git:20261031.7e95e4f · audit A · 35 stars
k8s-cloudnative-pg-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-cloudnative-pg-troubleshooting/SKILL.md · Use when a CloudNativePG (CNPG) PostgreSQL Cluster in Kubernetes is not healthy: a Cluster stuck in "Setting up…
git:20261031.a5d0ab1 · audit A · 35 stars
k8s-coredns-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-coredns-troubleshooting/SKILL.md · Use when cluster DNS itself misbehaves on Kubernetes: CoreDNS pods in CrashLoopBackOff ("Error during parsing: Unknown…
git:20261025.6531d71 · audit A · 35 stars
k8s-envoy-gateway-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-envoy-gateway-troubleshooting/SKILL.md · Use when Envoy Gateway (the Gateway API implementation by the Envoy project) does not route traffic in Kubernetes: a…
git:20261031.7e95e4f · audit A · 35 stars
k8s-envoy-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-envoy-troubleshooting/SKILL.md · Use when an Envoy proxy on Kubernetes fails requests: clients get 503 "no healthy upstream", 503 "upstream connect…
git:20261025.2ed8c84 · audit A · 35 stars
k8s-external-secrets-troubleshooting SKILL.md skill
k8s-servant/k8s-skills · skills/k8s-external-secrets-troubleshooting/SKILL.md · Use when External Secrets Operator does not create or update a Kubernetes Secret: an ExternalSecret with…
git:20261024.6050d36 · audit A · 35 stars

Every file in k8s-servant/k8s-skills

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade A, or by owner.