migrate-from-kubectl

Identify and classify Kubernetes resources manually modified via kubectl apply/edit.

14|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/confighub/cub-scout --skill migrate-from-kubectl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-from-kubectl
Source: https://github.com/confighub/cub-scout/tree/main/skills/migrate-from-kubectl
Command: npx skills add https://github.com/confighub/cub-scout --skill migrate-from-kubectl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams migrate from years of ad-hoc kubectl apply/edit activity to GitOps by identifying which Kubernetes resources were manually touched and turning that into a per-resource transition plan.

Core Features & Use Cases

  • Manual-edit attribution: Detects candidate resources whose last writer is a kubectl-* manager and classifies them as human-edited rather than controller-owned.
  • Risk-ranked migration backlog: Uses scanning to prioritize what to migrate first based on severity and operational context (for example, production workloads).
  • Read-only evidence and scaffolding: Produces inventory, decisions (revert / port to git / accept as canonical), and baselines via snapshot/import-preview guidance and receipt verification—without mutating the cluster.

Quick Start

Use the migrate-from-kubectl skill to generate a prioritized list of kubectl-touched resources and recommended actions for moving them into Argo/Flux/ConfigHub.

Frequently Asked Questions about migrate-from-kubectl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find Kubernetes resources that were manually modified with kubectl before moving to GitOps?

To find manually modified Kubernetes resources before moving to GitOps, you need to inspect managedFields for human authorship. This Skill detects candidate resources whose last writer is a kubectl-* manager and classifies them as human-edited rather than controller-owned.

What is the best way to plan a migration from kubectl apply to GitOps without mutating the cluster?

The best way to plan a migration from kubectl apply to GitOps without mutating the cluster is to run read-only scanning workflows. This Skill generates inventory, decisions, and baselines via snapshotting and import-preview guidance without altering live state.

How do I prioritize which Kubernetes workloads to migrate to GitOps first?

To prioritize which Kubernetes workloads to migrate to GitOps first, you need a risk-ranked backlog based on operational context. This Skill uses scanning to prioritize resources by severity, helping you decide whether to revert, port to git, or accept as canonical.

Does GitOps migration require clearing managedFields to track kubectl drift?

GitOps migration does require understanding managedFields to track kubectl drift, as these fields indicate human authorship. This Skill uses managedFields metadata to identify kubectl-touched resources and produce migration evidence via receipt verification for safe cluster-wide adoption.

Can I preview importing existing Kubernetes configurations into a GitOps repository?

You can preview importing existing Kubernetes configurations into a GitOps repository using read-only import-preview paths. This Skill optionally snapshots current state and previews the import-to-repo path to help teams safely port resources to git.

Why are my Kubernetes resources drifting from my GitOps source of truth after legacy operations?

Kubernetes resources drift from your GitOps source of truth after legacy operations because of ad-hoc kubectl apply or edit activity. This Skill identifies those manually touched resources and turns them into a per-resource transition plan to stop drift.