flux-kustomize-layout

Scaffolds FluxCD Kustomize repository layouts with shared base and dev/prod overlays.

2|Updated May 14, 2026
One-click install
npx skills add https://github.com/AnthonyPoschen/agent-skills --skill flux-kustomize-layout-anthonyposchen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flux-kustomize-layout
Source: https://github.com/AnthonyPoschen/agent-skills/tree/main/skills/flux-kustomize-layout
Command: npx skills add https://github.com/AnthonyPoschen/agent-skills --skill flux-kustomize-layout-anthonyposchen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a Kubernetes GitOps repository often leads to inconsistent folder structures, duplicated manifests across environments, and confusion between Kustomize files and Flux custom resources. This Skill enforces a predictable base/overlay layout so FluxCD reconciliation and CI validation work reliably. ## Core Features & Use Cases - Standard Layout Scaffolding: Creates the canonical kustomization/base plus overlays/dev and overlays/prod directory structure with valid kustomization.yaml files. - Manifest Organization Rules: Moves shared manifests into the base, keeps environment-specific patches, images, labels, and namespaces in the matching overlay, and keeps base manifests environment-neutral. - Validation Workflow: Inspects existing Kubernetes and Flux files before editing and validates the result with kustomize build or kubectl kustomize when available. - Use Case: When starting a new microservice deployment, ask the agent to scaffold the repo layout and it will produce a base with deployment and service resources plus dev and prod overlays referencing ../../base. ## Quick Start Use the flux-kustomize-layout skill to scaffold a FluxCD Kustomize repository layout with a shared base and dev and prod overlays for my application.

Frequently Asked Questions about flux-kustomize-layout

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

FAQPage Schema
How do I structure a FluxCD Kustomize repository?▼

Use a kustomization directory containing a base folder with shared manifests and an overlays folder with dev and prod subfolders. Each overlay's kustomization.yaml references ../../base, and environment differences live in the overlays as patches or Kustomize fields.

How to set up Kustomize base and overlays for dev and prod?▼

Place shared manifests in kustomization/base and list them in its kustomization.yaml resources. Create overlays/dev and overlays/prod, each with a kustomization.yaml that includes ../../base, then add environment-specific patches, images, labels, or namespace settings there.

What is the difference between a Flux Kustomization and a kustomization.yaml?▼

A Flux Kustomization is a custom resource consumed by the FluxCD controller, while kustomization.yaml is a Kustomize configuration file. This Skill keeps them separate and names the distinction clearly when Flux custom resources are requested.

How do I validate a Kustomize overlay before committing?▼

Run kustomize build or kubectl kustomize against the overlay directory to render the final manifests. If neither tool is available in the environment, the Skill reports that validation was not run.

Should application manifests go in overlay folders?▼

No. Manifests shared across environments belong in kustomization/base and must be listed in the base resources. Overlays should only contain environment-specific patches, generators, images, labels, or namespace settings.