magnus/agent-skills
1
1
Fork 0
Code Issues Pull requests Projects Releases 5 Packages Wiki Activity Actions

feat: add comprehensive Kubernetes agent skill #103

Merged
magnus merged 2 commits from feat/kubernetes-skill into main 2026-07-11 16:41:28 -04:00
Conversation 1 Commits 2 Files changed 33 +1336
jasper commented 2026-07-11 16:27:42 -04:00
Contributor
Copy link

Summary

Adds a broad, version-aware kubernetes Agent Skill with first-class k3s coverage and an agent-first k8s-cli wrapper.

Delivered

  • Agentskills-compliant kubernetes/SKILL.md routing layer and human README
  • Core API, discovery, SSA, CRD, deprecation, workloads, networking, storage, scheduling, scaling, security, policy, troubleshooting, debugging, operations, backup/restore, observability, node reliability, version-skew, and distribution references
  • Distribution/provider overlays for upstream/kubeadm, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, Rancher, kind, Minikube, EKS, AKS, and GKE
  • Dated primary-source index and version reconciliation contract
  • scripts/k8s-cli: stdlib-only, structured, bounded wrapper around native kubectl
  • Diagnostic gather/health-check scripts and refresh-version script
  • Deployment, HPA, PDB, NetworkPolicy, inventory, diagnostic, and upgrade-runbook templates
  • Routing entries in AGENTS.md and the root skill catalog

Safety and scope

The CLI requires explicit --yes for mutations, supports server dry-run, bounds logs/events, redacts sensitive JSON keys, rejects traversal in raw API paths, and returns a structured missing-kubectl error rather than inventing cluster state. Cloud-provider operations remain overlays and are not executed by the wrapper.

Validation

  • python3 -m py_compile kubernetes/scripts/k8s-cli
  • bash -n kubernetes/scripts/*.sh
  • bash kubernetes/scripts/test-k8s-cli.sh
  • ruby scripts/validate-skills.rb kubernetes
  • YAML parsing for all templates
  • git diff --check

Live-cluster integration was not run because this environment has no kubectl or cluster credentials. The missing-prerequisite contract was tested with the actual entrypoint.

Research

Issue #102. Primary documentation was mapped and scraped with GroktoCrawl, specialist research was reconciled against official release APIs and documentation, and current version claims are dated and refreshable.

AI assistance was used to produce this contribution.

## Summary Adds a broad, version-aware `kubernetes` Agent Skill with first-class k3s coverage and an agent-first `k8s-cli` wrapper. ## Delivered - Agentskills-compliant `kubernetes/SKILL.md` routing layer and human README - Core API, discovery, SSA, CRD, deprecation, workloads, networking, storage, scheduling, scaling, security, policy, troubleshooting, debugging, operations, backup/restore, observability, node reliability, version-skew, and distribution references - Distribution/provider overlays for upstream/kubeadm, k3s, RKE2, MicroK8s, k0s, Talos, OpenShift/OKD, Rancher, kind, Minikube, EKS, AKS, and GKE - Dated primary-source index and version reconciliation contract - `scripts/k8s-cli`: stdlib-only, structured, bounded wrapper around native `kubectl` - Diagnostic gather/health-check scripts and refresh-version script - Deployment, HPA, PDB, NetworkPolicy, inventory, diagnostic, and upgrade-runbook templates - Routing entries in `AGENTS.md` and the root skill catalog ## Safety and scope The CLI requires explicit `--yes` for mutations, supports server dry-run, bounds logs/events, redacts sensitive JSON keys, rejects traversal in raw API paths, and returns a structured missing-`kubectl` error rather than inventing cluster state. Cloud-provider operations remain overlays and are not executed by the wrapper. ## Validation - `python3 -m py_compile kubernetes/scripts/k8s-cli` - `bash -n kubernetes/scripts/*.sh` - `bash kubernetes/scripts/test-k8s-cli.sh` - `ruby scripts/validate-skills.rb kubernetes` - YAML parsing for all templates - `git diff --check` Live-cluster integration was not run because this environment has no `kubectl` or cluster credentials. The missing-prerequisite contract was tested with the actual entrypoint. ## Research Issue #102. Primary documentation was mapped and scraped with GroktoCrawl, specialist research was reconciled against official release APIs and documentation, and current version claims are dated and refreshable. AI assistance was used to produce this contribution.
jasper reviewed 2026-07-11 16:29:56 -04:00
jasper left a comment
Copy link
No description provided.
Self-review complete: all planned deliverables are present in the diff. Local validation passes for Python compile, shell syntax, fake-kubectl CLI behavior, YAML parsing, agentskills validation, and diff whitespace. Live-cluster integration remains unrun because this environment has no kubectl or cluster credentials; the CLI reports that prerequisite explicitly.
magnus merged commit 90cca7fe0e into main 2026-07-11 16:41:28 -04:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
community-feedback
Originates from community review

  
enhancement
New feature or request

  
skill-upgrade
Skill enhancement or refactor

No labels
community-feedback
enhancement
skill-upgrade
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
magnus/agent-skills!103
No description provided.