helm-chart-patterns — Claude Code skill: what it does, how to install
helm-chart-patterns is a Claude Code skill for developing Kubernetes Helm charts, covering template structure, values.schema.json validation, lifecycle hooks, and multi-environment setups.
MIT 179 installs ★ 71 updated 2026-06-29
npx skills add NickCrew/Claude-Cortex --skill helm-chart-patterns -a claude-codeWhat helm-chart-patterns does
This skill instructs agents on assembling production-ready Helm charts. It covers standard chart directory structures, separating metadata into Chart.yaml, handling defaults in values.yaml, and abstracting helpers inside templates/_helpers.tpl. Configurations target environments from local staging to production clusters.
Guidance includes subchart dependency tracking, multi-chart workflows with Helmfile, and input validation via values.schema.json. The rules emphasize quoting template strings, applying nindent for clean indentation, and configuring container security contexts.
Testing manifests locally with helm lint or helm template requires the helm binary installed in your environment.
What it helps with
- scaffold Kubernetes Helm charts with clean template helpers
- configure multi-environment releases across staging and production
- validate configuration inputs using
values.schema.json - manage lifecycle jobs using chart hooks
Example prompts for the agent
- Set up a Helm chart directory with Chart.yaml and values.schema.json validation
- Write helper templates in _helpers.tpl using proper nindent formatting
- Add a pre-upgrade hook to run database migrations before deploying
How to install helm-chart-patterns
1Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill helm-chart-patterns -a claude-code2Manually: put the files in place
~/.claude/skills/helm-chart-patterns/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/helm-chart-patterns/
1Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill helm-chart-patterns -a codex2Manually: put the files in place
.agents/skills/helm-chart-patterns/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill helm-chart-patterns -a cursor2Manually: put the files in place
.cursor/skills/helm-chart-patterns/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NickCrew/Claude-Cortex skills/helm-chart-patterns2Manually: put the files in place
.github/skills/helm-chart-patterns/SKILL.md1Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill helm-chart-patterns -a gemini-cli2Platform CLI
gemini skills install https://github.com/NickCrew/Claude-Cortex --path skills/helm-chart-patternsManually: put the files in place
.devin/skills/helm-chart-patterns/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill helm-chart-patterns -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about helm-chart-patterns
How do I install helm-chart-patterns in Claude Code?
Run npx skills add NickCrew/Claude-Cortex --skill helm-chart-patterns -a claude-code.
What does the helm-chart-patterns skill do?
It guides coding agents through authoring, linting, and packaging Kubernetes Helm charts using proven architectural patterns.
What files does this skill configure?
It standardizes Chart.yaml, values.yaml, values.schema.json, templates inside templates/, and multi-chart Helmfile setups.
Source text
SKILL.md · MIT
---
name: helm-chart-patterns
description: Helm chart development patterns for packaging and deploying Kubernetes applications. Use when creating reusable Helm charts, managing multi-environment deployments, or building application catalogs for Kubernetes.
keywords:
- Helm
- Helm chart
- Helm deployment
- Helm release
- Helm upgrade
- chart hooks
- chart packaging
- chart repository
- chart template
- values.yaml
file_patterns:
- '**/*deployment*.yaml'
- '**/charts/**'
- '**/helm/**'
- '**/k8s/**'
- '**/kubernetes/**'
confidence: 0.86
---
# Helm Chart Patterns
Expert guidance for developing production-grade Helm charts covering chart structure, templating patterns, multi-environment configuration, dependency management, testing strategies, and distribution workflows for Kubernetes application packaging.
## When to Use This Skill
- Creating reusable Helm charts for applications and services
- Building application catalogs and chart repositories
- Managing multi-environment deployments (dev, staging, production)
- Implementing advanced templating with conditionals and loops
- Managing chart dependencies and subcharts
- Implementing chart hooks for lifecycle management
- Testing and validating chart templates
- Packaging and distributing charts via repositories
- Using Helmfile for multi-chart orchestration
## Core Concepts
### Chart Types
- **Application charts**: Standard deployable charts for your services
- **Library charts**: Reusable template helpers (not directly installable)
### Key Files
| File | Purpose |
|------|---------|
| `Chart.yaml` | Metadata, version, dependencies |
| `values.yaml` | Default configuration |
| `values.schema.json` | Input validation |
| `templates/_helpers.tpl` | Reusable template functions |
| `templates/*.yaml` | Kubernetes manifests |
### Template Essentials
- **Quote strings**: `{{ .Values.name | quote }}`
- **Indent properly**: `{{- toYaml . | nindent 4 }}`
- **Use helpers**: `{{ include "my-app.fullname" . }}`
- **Check nil**: `{{- if .Values.optional }}`
## Quick Reference
| Task | Load reference |
| --- | --- |
| Chart structure & Chart.yaml | `skills/helm-chart-patterns/references/chart-structure.md` |
| Values file patterns | `skills/helm-chart-patterns/references/values-patterns.md` |
| Template patterns & functions | `skills/helm-chart-patterns/references/template-patterns.md` |
| Dependencies & subcharts | `skills/helm-chart-patterns/references/dependencies.md` |
| Hooks & lifecycle | `skills/helm-chart-patterns/references/hooks.md` |
| Testing patterns | `skills/helm-chart-patterns/references/testing.md` |
| Packaging & distribution | `skills/helm-chart-patterns/references/packaging.md` |
| Helmfile multi-chart | `skills/helm-chart-patterns/references/helmfile.md` |
| Best practices checklist | `skills/helm-chart-patterns/references/best-practices.md` |
## Workflow
1. **Structure** - Set up chart directory with Chart.yaml and values.yaml
2. **Template** - Create Kubernetes manifests with Go templating
3. **Helpers** - Extract common patterns into _helpers.tpl
4. **Validate** - Use values.schema.json for input validation
5. **Test** - Lint, template, and run chart tests
6. **Package** - Create .tgz and publish to repository
## Essential Commands
```bash
# Development
helm create my-app # Scaffold new chart
helm lint ./my-app # Validate chart
helm template my-app ./my-app # Render templates
# Dependencies
helm dependency update # Download dependencies
helm dependency list # Show dependencies
# Testing
helm install my-app ./my-app --dry-run --debug
helm test my-app
# Distribution
helm package ./my-app
helm repo index . --url https://charts.example.com
helm push my-app-1.0.0.tgz oci://registry.example.com/charts
```
## Common Mistakes
- Forgetting to quote strings in templates
- Not using `nindent` for proper YAML formatting
- Committing secrets to values files
- Missing security contexts (runAsNonRoot, drop capabilities)
- Not pinning dependency versions
- Skipping values.schema.json validation
- Not testing upgrades from previous versions
## Resources
- **Helm Documentation**: https://helm.sh/docs/
- **Chart Template Guide**: https://helm.sh/docs/chart_template_guide/
- **Best Practices**: https://helm.sh/docs/chart_best_practices/
- **Helmfile**: https://github.com/helmfile/helmfile
- **Chart Testing**: https://github.com/helm/chart-testing
© NickCrew · MIT · NickCrew/Claude-Cortex