helm-chart-scaffolding
Design, organize, and manage Helm charts for templating and packaging Kubernetes applications with reusable configurations. Use when creating Helm charts, packaging Kubernetes applications, or implementing templated deployments.
- License 许可
- MIT
- 最近更新
- 2026-11-10
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- helm-chart-scaffolding
- description
- Design, organize, and manage Helm charts for templating and packaging Kubernetes applications with reusable configurations. Use when creating Helm charts, packaging Kubernetes applications, or implementing templated deployments.
- last_verified
- 1793059200000
02 资源文件 5
- 资产文件assets/Chart.yaml.template801 B
- 资产文件assets/values.yaml.template3.1 KB
- 参考文档references/chart-structure.md11.2 KB
- 参考文档references/details.md9.8 KB
- 脚本scripts/validate-chart.sh6.7 KB
03 SKILL.md 正文
Helm Chart Scaffolding
Comprehensive guidance for creating, organizing, and managing Helm charts for packaging and deploying Kubernetes applications.
Purpose
This skill provides step-by-step instructions for building production-ready Helm charts, including chart structure, templating patterns, values management, and validation strategies.
When to Use This Skill
Use this skill when you need to:
- Create new Helm charts from scratch
- Package Kubernetes applications for distribution
- Manage multi-environment deployments with Helm
- Implement templating for reusable Kubernetes manifests
- Set up Helm chart repositories
- Follow Helm best practices and conventions
Procedure
-
Scaffold:
helm create my-app, then delete the templates the app does not need. FillChart.yamlfromassets/Chart.yaml.templatewithapiVersion: v2, a SemVerversion(the chart) andappVersion(the image). -
Design
values.yamlfromassets/values.yaml.template: every value commented, safe defaults (non-root security context, resource requests, probes), and a pinned image tag. Addvalues.schema.jsonso bad values fail at install time instead of rendering broken manifests. -
Template: put names, labels and selectors in
_helpers.tpland include them everywhere; gate optional resources (Ingress, HPA) behindenabledflags; quote strings and userequiredfor values with no safe default. -
Pin dependencies in
Chart.yamlwith exact or tightly bounded versions, thenhelm dependency updateand commitChart.lock. -
Validate offline, with no cluster needed:
helm lint ./my-app helm template my-app ./my-app | kubeconform -strict -summary -kubernetes-version 1.37.0 helm template my-app ./my-app -f values-prod.yaml | kubeconform -strict -summary -kubernetes-version 1.37.0or run
scripts/validate-chart.sh ./my-app, which also checks structure, security context, resources and probes. -
Validate against a cluster when one is available:
helm install my-app ./my-app --dry-run=server. On Helm 3, everyhelm install --dry-runcontacts the cluster, so usehelm templatefor offline checks. -
Package and publish:
helm package, thenhelm pushto an OCI registry.
References
references/details.md: full workflow with worked examples, multi-environment values, hooks and tests, common template patternsreferences/chart-structure.md: directory layout,Chart.yamlfields, dependencies, CRDs, versioning
Best Practices
- Use semantic versioning for chart and app versions
- Document all values in values.yaml with comments
- Use template helpers for repeated logic
- Validate charts before packaging
- Pin dependency versions explicitly
- Use conditions for optional resources
- Follow naming conventions (lowercase, hyphens)
- Include NOTES.txt with usage instructions
- Add labels consistently using helpers
- Test installations in all environments
Troubleshooting
Template rendering errors:
helm template my-app ./my-app --debug
Dependency issues:
helm dependency update
helm dependency list
Installation failures:
helm install my-app ./my-app --dry-run=server --debug
kubectl get events --sort-by='.lastTimestamp'
Related Skills
k8s-manifest-generator- For creating base Kubernetes manifestsgitops-workflow- For automated Helm chart deployments
04 同仓库更多 Skills
no-description
暂无简介
good-skill
Fixture skill that satisfies every rule.
broken-link
Links to a reference file that does not exist.
Bad_Name
Name violates the kebab-case rule and does not match the directory.
skill-authoring
Write, review, and validate portable agent skills in SKILL.md format. Use when creating a new skill, editing an existing one, or asked whether a skill follows the Agent Skills spec.
weigh-bags
Record scale readings for each bag — empty (tare), outbound, current, final — and reconcile them against the itemised inventory to find unaccounted weight. Use when the user gives a bag weight, says how heavy something is, weighs their luggage, or asks how close to the limit they are. Appends to bags.yaml and runs scripts/reconcile.py.