dirien/yet-another-agent-harness / .claude/skills/flux-cli
flux-cli
FlaggedBootstraps Flux CD on Kubernetes clusters, creates and manages GitOps sources (Git/Helm/OCI/Bucket), configures kustomizations and Helm releases, reconciles resources, sets up image automation and alerting, and pushes OCI artifacts. Use this skill whenever the user mentions the flux CLI, flux bootstrap, flux create source, flux create kustomization, flux create helmrelease, flux reconcile, flux get, Flux CD, GitOps with Flux, or asks about managing Kubernetes deployments via GitOps. Also trigger when users ask about creating Git/Helm/OCI/Bucket sources, building or diffing kustomizations, pushing OCI artifacts, setting up image automation, creating Flux alerts/receivers, or bootstrapping Flux on GitHub/GitLab/Gitea/Bitbucket. Even if the user just says "flux" in a Kubernetes context, this skill applies.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.2 KB |
| references/artifacts-and-images.md | markdown | 6.1 KB |
| references/bootstrap.md | markdown | 5.6 KB |
| references/helmreleases.md | markdown | 4.0 KB |
| references/kustomizations.md | markdown | 5.5 KB |
| references/sources.md | markdown | 6.0 KB |
references/sources.md
View on GitHub# Source Commands
Sources tell Flux where to pull manifests and charts from.
---
## flux create source git
Create or update a GitRepository source.
```bash
flux create source git <name> --url=<repo-url> [flags]
```
### Flags
| Flag | Default | Description |
|------|---------|-------------|
| `--url` | — | Git repository URL (required) |
| `--branch` | — | Git branch to track |
| `--tag` | — | Specific Git tag |
| `--tag-semver` | — | Semver range for tags (e.g. `>=1.0.0`) |
| `--commit` | — | Specific commit SHA |
| `--ref-name` | — | Git reference name |
| `-u, --username` | — | Basic auth username |
| `-p, --password` | — | Basic auth password |
| `--private-key-file` | — | SSH private key file |
| `--ssh-key-algorithm` | `ecdsa` | SSH key algorithm: `rsa`, `ecdsa`, `ed25519` |
| `--ssh-ecdsa-curve` | `p384` | ECDSA curve: `p256`, `p384`, `p521` |
| `--ssh-rsa-bits` | `2048` | RSA key size |
| `--secret-ref` | — | Existing secret with SSH or auth credentials |
| `--provider` | `generic` | Git provider: `generic`, `azure`, `github` |
| `--ca-file` | — | TLS CA file for self-signed certs |
| `--proxy-secret-ref` | — | Existing secret with proxy credentials |
| `--recurse-submodules` | `false` | Initialize and include Git submodules |
| `--ignore-paths` | — | Paths to ignore (comma-separated) |
| `--sparse-checkout-paths` | — | Paths for sparse checkout (comma-separated) |
| `-s, --silent` | `false` | Skip deploy key confirmation |
| `--interval` | `1m` | Sync interval |
| `--export` | — | Output YAML instead of applying |
### Examples
```bash
# Public repo
flux create source git my-app \
--url=https://github.com/org/app \
--branch=main
# Private repo with basic auth
flux create source git my-app \
--url=https://github.com/org/app \
--branch=main \
--username=bot \
--password=ghp_xxxx
# Private repo with SSH
flux create source git my-app \
--url=ssh://git@github.com/org/app \
--branch=main \
--private-key-file=~/.ssh/id_ed25519
# Track semver tags
flux create source git my-app \
--url=https://github.com/org/app \
--tag-semver=">=1.0.0 <2.0.0"
# Export as YAML
flux create source git my-app \
--url=https://github.com/org/app \
--branch=main \
--export > source.yaml
```
---
## flux create source helm
Create or update a HelmRepository source.
```bash
flux create source helm <name> --url=<chart-repo-url> [flags]
```
### Flags
| Flag | Description |
|------|-------------|
| `--url` | Helm repository URL (required) |
| `-u, --username` | Basic auth username |
| `-p, --password` | Basic auth password |
| `--cert-file` | TLS client certificate file |
| `--key-file` | TLS client key file |
| `--ca-file` | TLS CA certificate file |
| `--secret-ref` | Existing secret with credentials |
| `--oci-provider` | OCI auth provider for OCI Helm repos |
| `--pass-credentials` | Pass credentials to all domains |
| `--interval` | Sync interval (default `1m`) |
| `--export` | Output YAML instead of applying |
### Examples
```bash
# Public chart repo
flux create source helm bitnami \
--url=https://charts.bitnami.com/bitnami \
--interval=1h
# With basic auth
flux create source helm private-charts \
--url=https://charts.example.com \
--username=admin \
--password=secret
# OCI-based Helm repo
flux create source helm oci-charts \
--url=oci://ghcr.io/org/charts \
--username=bot \
--password=token
```
---
## flux create source oci
Create or update an OCIRepository source.
```bash
flux create source oci <name> --url=<oci-url> [flags]
```
### Key Flags
| Flag | Description |
|------|-------------|
| `--url` | OCI repository URL (required) |
| `--tag` | OCI tag to track |
| `--tag-semver` | Semver range for tags |
| `--digest` | Specific artifact digest |
| `--secret-ref` | Existing secret with registry credentials |
| `--provider` | OCI auth provider: `generic`, `aws`, `azure`, `gcp` |
| `--insecure` | Allow HTTP registry |
| `--interval` | Sync interval |
| `--export` | Output YAML instead of applying |
### Examples
```bash
# Track an OCI artifact
flux create source oci my-manifests \
--url=oci://ghcr.io/org/manifests \
--tag=latest
# Track with semver
flux create source oci my-manifests \
--url=oci://ghcr.io/org/manifests \
--tag-semver=">=1.0.0"
```
---
## flux create source bucket
Create or update a Bucket source (S3-compatible, GCS, Azure Blob).
```bash
flux create source bucket <name> --bucket-name=<name> --endpoint=<url> [flags]
```
### Key Flags
| Flag | Description |
|------|-------------|
| `--bucket-name` | Bucket name (required) |
| `--endpoint` | Bucket endpoint URL (required) |
| `--provider` | Provider: `generic`, `aws`, `azure`, `gcp` |
| `--region` | Bucket region |
| `--secret-ref` | Existing secret with access credentials |
| `--access-key` | Access key ID |
| `--secret-key` | Secret access key |
| `--insecure` | Allow HTTP |
| `--interval` | Sync interval |
| `--export` | Output YAML instead of applying |
### Examples
```bash
# S3 bucket
flux create source bucket my-bucket \
--bucket-name=my-manifests \
--endpoint=s3.amazonaws.com \
--provider=aws \
--region=us-east-1
# MinIO
flux create source bucket minio \
--bucket-name=flux \
--endpoint=minio.example.com \
--access-key=admin \
--secret-key=password \
--insecure
```
---
## Querying Sources
```bash
# List all sources
flux get sources all [-A]
# List by type
flux get sources git [-A] [-w] [--no-header]
flux get sources helm [-A]
flux get sources oci [-A]
flux get sources bucket [-A]
flux get sources chart [-A]
# Filter by label
flux get sources git -l team=backend
# Filter by status
flux get sources git --status-selector ready=false
```
## Managing Sources
```bash
# Force reconciliation
flux reconcile source git <name>
flux reconcile source helm <name>
flux reconcile source oci <name>
flux reconcile source bucket <name>
flux reconcile source chart <name>
# Suspend/resume
flux suspend source git <name>
flux resume source git <name>
# Export
flux export source git <name>
flux export source git --all > all-git-sources.yaml
# Delete
flux delete source git <name>
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |