add-flux-app

Scaffold Flux app workflows generating ks.yaml, ocirepository.yaml, and helmrelease.yaml artifacts.

3|Updated May 13, 2025
One-click install
npx skills add https://github.com/wcygan/anton --skill add-flux-app
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-flux-app
Source: https://github.com/wcygan/anton/tree/main/.claude/skills/add-flux-app
Command: npx skills add https://github.com/wcygan/anton --skill add-flux-app

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffolds a Flux-based app workflow for Anton projects, enabling rapid creation of Flux-driven Kubernetes deployments using the 3-file pattern and postBuild substitutions.

Core Features & Use Cases

  • Generates the core Flux workflow artifacts: ks.yaml, app/helmrelease.yaml, and ocirepository.yaml for a new app under kubernetes/apps/<ns>/<app>.
  • Supports both existing namespaces and the creation of a new namespace with a dedicated kustomization; includes optional ExternalSecret support and postBuild substitutions from cluster secrets.
  • Provides workflows to add apps to an existing namespace or create the initial namespace and first app, streamlining Flux reconciliation and deployment.

Quick Start

Create a new app by invoking the skill to scaffold kubernetes/apps/<namespace>/<app> and generate the necessary Flux manifests ready for deployment.

Frequently Asked Questions about add-flux-app

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

FAQPage Schema
How do I scaffold a Flux HelmRelease and Kustomization for a new Kubernetes app?

This Skill scaffolds a Flux app by generating ks.yaml, helmrelease.yaml, and ocirepository.yaml under kubernetes/apps/<namespace>/<app>, automating Flux reconciliation and multi-namespace deployment configuration.

What is the 3-file Flux pattern for GitOps deployments?

The 3-file Flux pattern consists of ks.yaml, helmrelease.yaml, and ocirepository.yaml, which together define the Kustomization, HelmRelease, and OCI repository source needed for a complete Flux-driven GitOps deployment.

Can I use Flux postBuild substitutions to inject cluster secrets into HelmReleases?

Yes, Flux postBuild substitutions are supported, allowing you to inject values from cluster secrets into HelmRelease templates during reconciliation for secure multi-namespace configurations.

Does this workflow support creating a new namespace and ExternalSecrets for Flux?

Yes, the workflow supports creating a new namespace with a dedicated kustomization and includes optional ExternalSecret support alongside the standard Flux app scaffolding artifacts.

How do I add a Flux app to an existing Kubernetes namespace?

You add a Flux app to an existing namespace by invoking the scaffold workflow, which generates the required Flux manifests under kubernetes/apps/<ns>/<app> without needing to create the namespace itself.