borghei/Claude-Skills / engineering/helm-chart-builder
helm-chart-builder
VerifiedReview an existing Helm chart and its values files: metadata, structure, dependency pinning, resources, security context, image tags, probes and plaintext secrets. Use when auditing a chart before release or adding chart checks to CI.
Helm Chart Builder
The agent reviews Helm charts that already exist: is the chart well-formed, are its dependencies pinned, and are its values safe to run in production. Despite the name, the tools analyse rather than generate; when a new chart is needed, start from helm create, then run this review.
When to Use
- Reviewing a chart or its per-environment values files before a release.
- Adding chart checks to CI.
- Auditing third-party charts and values overrides for security defaults.
Clarify First
Before analyzing the chart, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.
- Chart path: which chart directory to analyze (sets
--path/--chart). - Values files: which environment values files to validate (sets
--valuesand what gets checked against best practices). - Strictness: strict/lint mode and JSON for CI (sets
--strict --format jsonand whether findings gate the pipeline).
Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.
Workflow
- Analyse the chart with
chart_analyzer.py --path <chart>: required files,apiVersion: v2, SemVer version, appVersion, dependency pinning andChart.lock, NOTES.txt,_helpers.tpl, README. - Validate every values file with
values_validator.py: resources, security context, image tag, replicas, service type, ingress TLS, probes, autoscaling and plaintext secrets. - Fix critical findings first (missing required files, plaintext secrets), then warnings.
- Render and dry-run with
helm lint,helm templateandhelm install --dry-run(orhelm upgrade --install --dry-run=serveragainst a cluster). The analysers read text; only rendering proves the manifests. - Verify that both tools report no critical findings for every environment's values file and that the rendered manifests pass your policy checks.
Helm 4 (released late 2025) keeps chart apiVersion: v2, so v2 charts work with both Helm 3 and Helm 4. Check the Helm 4 release notes for changed CLI flags and plugin behaviour before upgrading CI.
Quick Start
python3 scripts/chart_analyzer.py --path examples # apiVersion v1, loose dependency range, missing files
python3 scripts/values_validator.py --values examples/values.yaml # latest tag, plaintext passwords, no resources (exit 1)
python3 scripts/values_validator.py --values examples/values-production.yaml # passes (exit 0)
For CI, write one JSON report per tool:
python3 scripts/chart_analyzer.py --path ./charts/my-app --format json --strict > chart-report.json
python3 scripts/values_validator.py --chart ./charts/my-app --values values-dev.yaml values-prod.yaml --format json > values-report.json
Tools Overview
| Tool | What it checks | Key flags | Exit codes |
|---|---|---|---|
chart_analyzer.py | Required files and dirs, Chart.yaml fields, apiVersion: v2, SemVer, appVersion, dependency version ranges and Chart.lock, template helpers, NOTES.txt, README | --path, --strict (warnings fail), `--format text | json` |
values_validator.py | Resources, security context, image tag (latest or empty), pull policy, replicaCount, service type, ingress TLS/class, probes, autoscaling, plaintext passwords/secrets/tokens and credentialed URLs | --values <files...>, --chart (only to locate relative paths), `--format text | json` |
Anti-Patterns
Mistake: Passwords and API keys in values.yaml.
Why it happens: It is the quickest way to make a chart install.
Instead: Values end up in git and in the release history Helm stores in the cluster. Reference an existing Secret (existingSecret), or use External Secrets or SOPS.
Mistake: Broad dependency ranges such as 12.x.x without a committed Chart.lock.
Why it happens: Ranges feel like they keep the chart current.
Instead: Pin dependency versions, commit Chart.lock, and update deliberately.
Mistake: Treating a clean analyser run as a working chart.
Why it happens: No findings looks like a pass.
Instead: Template logic and --set overrides are not evaluated. Render with helm template and dry-run the install.
Files
scripts/chart_analyzer.py,scripts/values_validator.py— the tools above.examples/Chart.yaml,examples/values.yaml— deliberately flawed chart metadata and values;examples/values-production.yaml— values that pass.
Scope & Limitations
In Scope:
- Static review of a Helm chart directory with
chart_analyzer.py: required files, Chart.yaml fields and version format, template file checks, subchart dependency pinning, and NOTES.txt and README presence. - Best-practice checks on one or more values files with
values_validator.py: resource requests and limits, security context, image tags, replica count, service, ingress TLS, probes and autoscaling. - Text or JSON output, with
--stricton the analyzer to treat warnings as errors in CI. - The chart review and pre-release workflows, backed by
references/helm-best-practices.md.
Out of Scope:
- Rendering, linting, installing or upgrading charts. The scripts do not call
helmor a cluster. - Generating new charts or templates. The scripts review existing files.
- Kubernetes operators and custom controllers (see
engineering/kubernetes-operator/). - Building container images (see
engineering/docker-development/) and designing CI pipelines (seeengineering/ci-cd-pipeline-builder/).
Important Caveats:
- Both scripts read YAML with a small stdlib parser and inspect templates with regular expressions. Template logic,
--setoverrides and values merged at install time are not evaluated, so a clean report does not mean the rendered manifests are correct. values_validator.pychecks each values file against fixed best-practice rules. The--chartflag only locates the files; values are not compared with what the chart's templates actually use.- Findings are review prompts, not proof that a chart is secure or production ready. The reference lists
helm lint,helm templateand a dry-run install as the checks that cover rendering.
Reference Documentation
- references/helm-best-practices.md — chart structure, template patterns, security defaults, values design and dependency management. Read when restructuring a chart or writing templates.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |