Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add NickCrew/Claude-Cortex --skill helm-chart-patterns -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/helm-chart-patterns/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/helm-chart-patterns/

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

Similar skills

All skills for DevOps and infrastructure →

From the same set21

The whole set →
ui-design-aesthetics The ui-design-aesthetics skill feeds the agent rules for typography, color and motion so generated interfaces stop looking like default AI output. Useful when starting a feature or reworking an existing screen. CX Codex +1 362installs threat-modeling-techniques threat-modeling-techniques — a skill for threat modeling: walks the system through STRIDE, builds attack trees and scores risk with DREAD. Best used before the code exists. CX Codex +1 357installs token-efficiency token-efficiency — a Claude Code skill that switches the agent to compact notation — symbols and abbreviations instead of full sentences. Kicks in when the context window is nearly full or a short status line is enough. CX Codex +1 245installs repo-cleanup repo-cleanup — a skill for structured repository cleanup: removes dead code, unused dependencies, outdated docs, and flaky tests with usage checks, archiving, and validation steps built in. CX Codex +1 183installs typescript-advanced-patterns The typescript-advanced-patterns skill helps apply advanced TypeScript types to APIs and domain models. Use it when compile-time rules need to express states, constraints, or distinct identifiers. CX Codex +1 174installs code-explanation The code-explanation skill explains code, architecture, and system behavior at a depth that matches the reader. Use it for walkthroughs, teaching, and knowledge transfer. CX Codex +1 173installs security-testing-patterns security-testing-patterns guides security testing workflows across SAST, SCA, DAST, and OWASP API audits. Use it to build CI/CD scanning pipelines and triage vulnerabilities. CX Codex +1 154installs secure-coding-practices secure-coding-practices is a Claude Code skill for applying defensive coding patterns to authentication, user input, and sensitive data. It also supports security-focused code reviews. CX Codex +1 134installs

Project sponsors

Companies that keep this analytics open