scout-ingest

Generate read-only ConfigHub adoption proposals from Kubernetes clusters or local repositories.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts existing Kubernetes and GitOps workload structure into a read-only ConfigHub adoption proposal, so you can review what will land before any mutation.

Core Features & Use Cases

  • Generate an import proposal from a live cluster: Produces proposed ConfigHub units, spaces, and targets by reading Kubernetes and GitOps controller state.
  • Generate an import proposal from a local repo: Parses repo layout and classifies workload structure to propose the corresponding ConfigHub hierarchy.
  • Handle GitOps structure as hierarchy: Preserves origin structure (e.g., Argo ApplicationSet generators) and surfaces conflicts in connected mode.

Quick Start

Run a dry-run import proposal for your current cluster and get structured output you can review before applying it: cub-scout import --dry-run --json.

Frequently Asked Questions about scout-ingest

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

FAQPage Schema
How do I preview a GitOps adoption import for Kubernetes without applying changes?

To preview a GitOps adoption import without applying changes, run a dry-run import proposal that reads your cluster or repository state. This generates a read-only ConfigHub adoption proposal with proposed units, spaces, and targets for review.

Can I mirror Argo CD ApplicationSet and Flux Kustomization structures into ConfigHub?

Yes, you can mirror Argo CD ApplicationSet and Flux Kustomization structures. The adoption proposal preserves your origin GitOps hierarchy and surfaces conflicts in connected mode for review before applying.

How to generate a ConfigHub import proposal from a local repository?

To generate a ConfigHub import proposal from a local repository, parse the repository layout to classify workload structure. This produces a proposed ConfigHub hierarchy of units and targets for review.

Does the ConfigHub import preview support read-only dry-run mode?

The ConfigHub import preview operates in deterministic read-only dry-run mode. It explicitly avoids mutating operations like import apply, ensuring you only review proposed units and targets safely.

What is the best way to review Kubernetes workload adoption before migrating to ConfigHub?

The best way to review Kubernetes workload adoption is generating a read-only import proposal. It reads live cluster or GitOps controller state to produce structured output for review before any mutation occurs.

Why does the ConfigHub scout-ingest skill avoid executing import apply operations?

The scout-ingest skill avoids import apply operations to enforce review-before-apply behavior. It operates strictly in read-only mode via dry-run and parsing verbs to prevent accidental mutations during adoption proposals.