mtv-skills

mtv-skills

AI agent skills for MTV/Forklift migrations on OpenShift and Kubernetes. Works with Claude Code and Cursor.

What Can I Do with These Skills?

Just open a chat and ask. Here's one high-impact example per skill:

Ask the agent to…	Skill used
"Migrate my 20 VMs from vSphere to OpenShift"	kubectl-mtv
"Check why my cluster nodes are NotReady"	check-ocp-health
"My VM won't start — figure out what's wrong"	troubleshoot-virt
"Show me network traffic by namespace for the last hour"	observe-metrics
"Plot the forklift namespace RX/TX for the last 24h in a chart"	observe-metrics
"Create a Fedora VM with 4 GiB RAM and start it"	kubectl-virt
"Is Ceph healthy? Any OSDs near full?"	check-ceph-health
"Install the CLI plugins so I can use these tools"	mcp-setup
"Write a verification script for MTV-4911"	mtv-test

Quick Start

Claude Code (plugin install)

# Add the marketplace and install the plugin
claude plugin marketplace add kubev2v/mtv-skills
claude plugin install mtv-skills@kubev2v

To update later:

claude plugin update mtv-skills@kubev2v

Or test locally from a cloned repo:

claude --plugin-dir ./mtv-skills

Cursor (symlink install)

git clone https://github.com/kubev2v/mtv-skills.git ~/.local/share/mtv-skills

mkdir -p ~/.cursor/skills
for skill in ~/.local/share/mtv-skills/skills/*/; do
  ln -sfn "$skill" ~/.cursor/skills/"$(basename "$skill")"
done

To update later:

git -C ~/.local/share/mtv-skills pull

For Claude Code per-project installs, Cursor per-project installs, and removal see docs/install.md.

Prerequisites

Several skills use CLI plugins that must be installed on your machine. The mcp-setup skill can guide you through installation, or install manually:

# kubectl-mtv (https://github.com/yaacov/kubectl-mtv)
curl -sSL https://raw.githubusercontent.com/yaacov/kubectl-mtv/main/install.sh | bash

# kubectl-metrics (https://github.com/yaacov/kubectl-metrics)
curl -sSL https://raw.githubusercontent.com/yaacov/kubectl-metrics/main/install.sh | bash

# kubectl-debug-queries (https://github.com/yaacov/kubectl-debug-queries)
curl -sSL https://raw.githubusercontent.com/yaacov/kubectl-debug-queries/main/install.sh | bash

Plugin	CLI command
kubectl-mtv	oc mtv
kubectl-debug-queries	oc debug-queries
kubectl-metrics	oc metrics

Skills that do not require these plugins (govc-vsphere, kubectl-virt) use their own CLIs (govc and oc virt/virtctl). The mtv-test skill also uses the Atlassian Rovo MCP for Jira ticket fetching and gh for GitHub PR details.

Included Skills

See docs/skills.md for a full list of skills with descriptions, triggers, and dependencies.

Docs

Path	Description
docs/skills.md	Quick reference for every skill (what / when / trigger)
docs/install.md	Full installation and removal instructions (Claude Code & Cursor)
docs/setup-mtv-agent.md	Setting up the mtv-agent AI assistant
docs/create-providers-cli.md	Creating MTV source providers using oc mtv
examples/mtv-test/create-providers.sh	Script that creates providers from environment variables

License

Apache-2.0