cub-mutate

Mutate ConfigHub Units via function-based edits with preflight checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mutating ConfigHub Units safely and deterministically often requires disciplined workflows to avoid hand-edits, ensure proper revision history, and enforce validation through functions.

Core Features & Use Cases

  • Prefer function-based mutations (set-container-image, set-replicas, set-env-var, set-annotation, set-label, etc.) over ad-hoc YAML edits.
  • Support single-unit updates and bulk changes via ChangeSets, with filters and traceable change descriptions.
  • Enforce preflight checks, changelog accuracy, and preserve YAML provenance while recording revisions.

Quick Start

Update a single field using a function like set-container-image and include a concise change description.

Frequently Asked Questions about cub-mutate

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

FAQPage Schema
How do I safely mutate Kubernetes YAML configs in ConfigHub without hand-edits?

To safely mutate Kubernetes YAML configs in ConfigHub, use disciplined, function-based edits via cub instead of hand-edits. This approach enforces preflight checks, preserves YAML provenance, and records proper revision history using a clear change description.

What is the best way to bulk update ConfigHub Units across multiple Spaces?

The best way to bulk update ConfigHub Units across multiple Spaces is by using ChangeSets. This method applies filtered changes, enforces preflight checks, and ensures every mutation is traceable through proper revision history and change descriptions.

Does ConfigHub support function-based mutations for Kubernetes resources like setting container images or replicas?

Yes, ConfigHub supports function-based mutations for Kubernetes resources. You can use dedicated functions like set-container-image, set-replicas, and set-env-var through cub to apply deterministic, validated edits rather than manual YAML modifications.

How do I ensure proper revision history when updating a single ConfigHub Unit?

To ensure proper revision history when updating a single ConfigHub Unit, use cub unit update or cub function set with a clear --change-desc parameter. This records a concise changelog description for every applied mutation.

Can I use cub to apply change descriptions and preflight checks for YAML mutations?

Yes, you can use cub to apply change descriptions and preflight checks for YAML mutations. The tool enforces validation workflows before applying changes and requires a descriptive changelog entry to maintain accurate revision history.

Why should I avoid ad-hoc YAML edits when managing ConfigHub Units?

You should avoid ad-hoc YAML edits when managing ConfigHub Units because they bypass preflight checks and break revision history. Function-based mutations using cub ensure deterministic changes, preserve YAML provenance, and enforce traceable change descriptions.