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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.1 KB |
| examples/Chart.yaml | config | 931 B |
| examples/values-production.yaml | config | 700 B |
| examples/values.yaml | config | 2.6 KB |
| references/helm-best-practices.md | markdown | 2.7 KB |
| scripts/chart_analyzer.py | script | 15.7 KB |
| scripts/values_validator.py | script | 17.9 KB |
references/helm-best-practices.md
View on GitHub# Helm Best Practices Reference
## Chart Structure
### Minimum Required Files
```
my-chart/
Chart.yaml # Required: metadata
values.yaml # Required: defaults
templates/ # Required: manifests
```
### Recommended Structure
```
my-chart/
Chart.yaml
Chart.lock
values.yaml
values-dev.yaml
values-staging.yaml
values-production.yaml
templates/
deployment.yaml
service.yaml
ingress.yaml
serviceaccount.yaml
hpa.yaml
pdb.yaml
configmap.yaml
secret.yaml
_helpers.tpl
NOTES.txt
tests/
test-connection.yaml
charts/ # Subcharts
crds/ # CRDs
README.md
```
## Chart.yaml Best Practices
```yaml
apiVersion: v2
name: my-app
description: A Helm chart for my application
type: application
version: 1.2.3 # Chart version (SemVer)
appVersion: "2.0.0" # Application version
maintainers:
- name: team
email: team@example.com
dependencies:
- name: postgresql
version: "~12.0"
repository: "https://charts.bitnami.com/bitnami"
condition: postgresql.enabled
```
## Values Best Practices
### Security Defaults
```yaml
securityContext:
runAsNonRoot: true
readOnlyRootFilesystem: true
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
podSecurityContext:
fsGroup: 1000
runAsUser: 1000
runAsGroup: 1000
```
### Resource Management
```yaml
resources:
limits:
cpu: 500m
memory: 256Mi
requests:
cpu: 100m
memory: 128Mi
```
### Health Probes
```yaml
livenessProbe:
httpGet:
path: /healthz
port: http
initialDelaySeconds: 30
periodSeconds: 10
readinessProbe:
httpGet:
path: /ready
port: http
initialDelaySeconds: 5
periodSeconds: 5
```
## Template Patterns
### _helpers.tpl Standard Labels
```yaml
{{- define "my-chart.labels" -}}
helm.sh/chart: {{ include "my-chart.chart" . }}
app.kubernetes.io/name: {{ include "my-chart.name" . }}
app.kubernetes.io/instance: {{ .Release.Name }}
app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
app.kubernetes.io/managed-by: {{ .Release.Service }}
{{- end }}
```
### Conditional Resources
```yaml
{{- if .Values.ingress.enabled }}
apiVersion: networking.k8s.io/v1
kind: Ingress
...
{{- end }}
```
## Dependency Management
- Always pin dependency versions with range operators: `~1.2.0` or `>=1.0.0 <2.0.0`
- Use `condition` fields to make dependencies optional
- Run `helm dependency update` after modifying Chart.yaml
- Commit Chart.lock for reproducible builds
## Testing
```bash
# Lint chart
helm lint ./my-chart
# Template rendering
helm template my-release ./my-chart --values values-prod.yaml
# Dry run install
helm install my-release ./my-chart --dry-run --debug
# Run chart tests
helm test my-release
```
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: 472k | 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: 472k | 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: 472k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |