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.