k8s-backup — Claude Code skill: what it does, how to install
k8s-backup directs Velero backup and restore workflows in Kubernetes using kubectl-mcp-server tools.
MIT-0 1 installs ★ 976 updated 2026-10-22
npx skills add rohitg00/kubectl-mcp-server --skill k8s-backup -a claude-codeWhat k8s-backup does
This skill guides coding agents through disaster recovery and namespace migrations using 10 specialized Velero tools. It enforces execution safeguards: detecting the Velero installation via detect_ecosystem, confirming storage targets with list_backup_locations, and polling backup status with get_backup.
The toolset handles namespace filtering, volume snapshot toggles, and retention periods via ttl. For recovery operations, it supports non-destructive rollouts by allowing persistent volume restoration to be turned off with restore_pvs=False.
Without Velero running in your target cluster and the MCP server started with --toolsets default,backup, these commands will fail.
What it helps with
- back up specific namespaces without persistent volume snapshots
- restore cluster resources into staging environments safely
- apply Velero scheduled backup manifests directly to clusters
- verify disaster recovery readiness across remote clusters
Example prompts for the agent
- Create a backup for the production namespace with 720h retention
- Inspect the status of my-restore using get_restore
- List all existing Velero backup schedules in the cluster
How to install k8s-backup
1Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-backup -a claude-code2Manually: put the files in place
~/.claude/skills/k8s-backup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/k8s-backup/
1Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-backup -a codex2Manually: put the files in place
.agents/skills/k8s-backup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-backup -a cursor2Manually: put the files in place
.cursor/skills/k8s-backup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rohitg00/kubectl-mcp-server kubernetes-skills/claude/k8s-backup2Manually: put the files in place
.github/skills/k8s-backup/SKILL.md1Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-backup -a gemini-cli2Platform CLI
gemini skills install https://github.com/rohitg00/kubectl-mcp-server --path kubernetes-skills/claude/k8s-backupManually: put the files in place
.devin/skills/k8s-backup/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rohitg00/kubectl-mcp-server --skill k8s-backup -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about k8s-backup
How to install k8s-backup in Claude Code?
Run npx skills add rohitg00/kubectl-mcp-server --skill k8s-backup -a claude-code in your terminal.
What prerequisites does this skill require?
A functional Velero deployment in your cluster and kubectl-mcp-server launched with --toolsets default,backup.
Does the skill support scheduled backups?
Yes, it inspects schedules with list_backup_schedules and applies Velero Schedule manifests using kubectl_apply.
Source text
SKILL.md · MIT-0
---
name: k8s-backup
description: Kubernetes backup and restore with Velero. Use when creating backups, restoring applications, managing disaster recovery, or migrating workloads between clusters.
license: MIT-0
metadata:
author: rohitg00
version: "2.0.0"
tools: 10
category: backup
---
# Kubernetes Backup with Velero
Manage backups and restores using kubectl-mcp-server's Velero tools.
> Requires the `backup` toolset: start kubectl-mcp-server with `--toolsets default,backup` (or `MCP_TOOLSETS=default,backup`).
## When to Apply
Use this skill when:
- User mentions: "backup", "restore", "Velero", "disaster recovery", "DR"
- Operations: creating backups, restoring namespaces, migration
- Keywords: "protect", "recover", "migrate", "snapshot"
## Priority Rules
| Priority | Rule | Impact | Tools |
|----------|------|--------|-------|
| 1 | Verify Velero installation first | CRITICAL | `detect_ecosystem` |
| 2 | Check backup location before create | HIGH | `list_backup_locations` |
| 3 | Wait for backup completion | HIGH | `get_backup` |
| 4 | Test restores to non-prod first | MEDIUM | `create_restore` |
## Quick Reference
| Task | Tool | Example |
|------|------|---------|
| Detect Velero | `detect_ecosystem` | `detect_ecosystem()` |
| List backups | `list_backups` | `list_backups()` |
| Create backup | `create_backup` | `create_backup(name, namespaces)` |
| Restore | `create_restore` | `create_restore(name, backup_name)` |
## Check Velero Installation
```python
detect_ecosystem()
list_backup_locations()
```
## Create Backups
```python
create_backup(
name="my-backup",
included_namespaces=["default", "app-namespace"]
)
create_backup(
name="app-backup",
included_namespaces=["default"],
snapshot_volumes=False
)
create_backup(
name="config-backup",
included_namespaces=["default"],
excluded_namespaces=["kube-system"]
)
create_backup(
name="daily-backup",
included_namespaces=["production"],
ttl="720h"
)
```
## List and Describe Backups
```python
list_backups()
get_backup(name="my-backup")
```
## Restore from Backup
```python
create_restore(
name="my-restore",
backup_name="my-backup"
)
create_restore(
name="my-restore",
backup_name="my-backup",
restore_pvs=False
)
create_restore(
name="config-restore",
backup_name="my-backup",
included_namespaces=["default"]
)
create_restore(
name="partial-restore",
backup_name="my-backup",
excluded_namespaces=["kube-system"]
)
```
## List and Monitor Restores
```python
list_restores()
get_restore(name="my-restore")
```
## Scheduled Backups
```python
list_backup_schedules()
list_backup_schedules(namespace="velero")
kubectl_apply(manifest="""
apiVersion: velero.io/v1
kind: Schedule
metadata:
name: daily-backup
namespace: velero
spec:
schedule: "0 2 * * *"
template:
includedNamespaces:
- production
ttl: 720h
""")
```
## Disaster Recovery Workflow
### Create DR Backup
```python
from datetime import datetime
create_backup(
name=f"dr-backup-{datetime.now().strftime('%Y%m%d-%H%M%S')}",
included_namespaces=["production"]
)
get_backup(name="dr-backup-20260130-120000")
```
### Restore to New Cluster
```python
detect_ecosystem()
list_backups()
create_restore(
name="dr-restore",
backup_name="dr-backup-..."
)
get_restore(name="dr-restore")
```
## Prerequisites
- **Velero**: Required for all backup tools
```bash
velero install --provider aws --bucket my-bucket --secret-file ./credentials
```
## Related Skills
- [k8s-multicluster](../k8s-multicluster/SKILL.md) - Multi-cluster operations
- [k8s-incident](../k8s-incident/SKILL.md) - Incident response
© rohitg00 · MIT-0 · rohitg00/kubectl-mcp-server