Azure Helm CLI
Use this skill to turn Helm chart and release requests into ordered CLI workflows, validate charts before deployment, preview rendered manifests, and return release, validation, template, or rollback evidence.
When to invoke
- "Lint or validate a Helm chart."
- "Render Helm templates before deploying."
- "Install, upgrade, or roll back a Helm release."
- "Add, update, or search a Helm repository."
- "Debug chart values or release history."
Prerequisites and context
- Helm 3.x installed.
- Kubernetes context configured.
- Access to chart repositories.
Procedure
- Confirm the chart path, release name, values file, namespace, and Kubernetes context.
- Lint or template the chart before install or upgrade when chart changes are involved.
- Run the narrowest repository or release command that satisfies the request.
- Capture validation, template, release, or rollback output.
- Return the result using the output template.
Chart development
# Lint chart
helm lint ./chart
# Template rendering
helm template release-name ./chart -f values.yaml
# Dry-run install
helm install release-name ./chart -f values.yaml --dry-run
Repository operations
# Add repository
helm repo add <name> <url>
# Update repositories
helm repo update
# Search charts
helm search repo <keyword>
Release management
# List releases
helm list -A
# Install chart
helm install <release> <chart> -f values.yaml -n <namespace>
# Upgrade release
helm upgrade <release> <chart> -f values.yaml -n <namespace>
# Rollback release
helm rollback <release> <revision> -n <namespace>
Best practices
- ALWAYS lint charts before deploying.
- Use --dry-run to preview changes.
- Keep values.yaml files in version control.
- Use semantic versioning for charts.
- Document chart dependencies.
Output template
Return exactly this structure:
**Status:** PASS | FAIL | BLOCKED
**Summary:** One sentence describing the chart validation, template rendering, repository, install, upgrade, or rollback outcome.
### Details
1. Command executed: `<helm command>`
2. Chart or release: `<chart path/name and release name>`
3. Namespace: `<namespace or all namespaces>`
4. Validation results: `<lint, dry-run, template, or not checked>`
5. Template output: `<summary or not applicable>`
6. Next steps: `<install, upgrade, rollback, inspect, or none>`
### Validation
- Chart check: `<helm lint, helm template, dry-run, or reason not checked>`
- Command result: `<exit code or observed helm output>`
Limits
- Do not use this skill for kubectl cluster operations.
- Use
azure-kubectl-cli (skill) instead when the task is direct Kubernetes resource inspection, logs, events, rollout status, or manifest application.
- Do not use this skill for ArgoCD sync and app health.
- Use
azure-argocd-cli (skill) instead when the task is GitOps application sync, health, diff, or drift management.
- Do not use this skill for Terraform IaC.
- Use
azure-terraform-cli (skill) instead when the task is infrastructure provisioning, state, plans, modules, or provider locks.
- Do not use this skill for full platform deployment.
- Use
open-horizons-deploy-orchestration (skill) instead when the task spans prerequisites, Terraform, Kubernetes, and platform-wide validation.
Related primitives
| Name |
Type |
Use it when |
open-horizons-deployment-operator |
agent |
Coordinating approved Helm releases as part of platform deployment. |
open-horizons-backstage-expert |
agent |
Managing Backstage chart values and portal deployment workflows. |
open-horizons-sre-investigator |
agent |
Investigating release or rollout health issues. |
azure-kubectl-cli |
skill |
Inspecting Kubernetes resources created by Helm. |
azure-argocd-cli |
skill |
Managing GitOps applications that apply Helm-rendered workloads. |
Quality gate
1---2name: azure-helm-cli-23description: Helm CLI operations manage Kubernetes packages, charts, releases, repositories, values, upgrades, rollbacks, template rendering, release history, chart debugging, and package validation. Use this skill when working with helm install, helm upgrade, helm rollback, helm repo add, helm template, values.yaml, or chart validation.4---56# Azure Helm CLI78Use this skill to turn Helm chart and release requests into ordered CLI workflows, validate charts before deployment, preview rendered manifests, and return release, validation, template, or rollback evidence.910## When to invoke1112- "Lint or validate a Helm chart."13- "Render Helm templates before deploying."14- "Install, upgrade, or roll back a Helm release."15- "Add, update, or search a Helm repository."16- "Debug chart values or release history."1718## Prerequisites and context1920- Helm 3.x installed.21- Kubernetes context configured.22- Access to chart repositories.2324## Procedure25261. Confirm the chart path, release name, values file, namespace, and Kubernetes context.272. Lint or template the chart before install or upgrade when chart changes are involved.283. Run the narrowest repository or release command that satisfies the request.294. Capture validation, template, release, or rollback output.305. Return the result using the output template.3132### Chart development3334```bash35# Lint chart36helm lint ./chart3738# Template rendering39helm template release-name ./chart -f values.yaml4041# Dry-run install42helm install release-name ./chart -f values.yaml --dry-run43```4445### Repository operations4647```bash48# Add repository49helm repo add <name> <url>5051# Update repositories52helm repo update5354# Search charts55helm search repo <keyword>56```5758### Release management5960```bash61# List releases62helm list -A6364# Install chart65helm install <release> <chart> -f values.yaml -n <namespace>6667# Upgrade release68helm upgrade <release> <chart> -f values.yaml -n <namespace>6970# Rollback release71helm rollback <release> <revision> -n <namespace>72```7374### Best practices75761. ALWAYS lint charts before deploying.772. Use --dry-run to preview changes.783. Keep values.yaml files in version control.794. Use semantic versioning for charts.805. Document chart dependencies.8182## Output template8384Return exactly this structure:8586```markdown87**Status:** PASS | FAIL | BLOCKED88**Summary:** One sentence describing the chart validation, template rendering, repository, install, upgrade, or rollback outcome.8990### Details911. Command executed: `<helm command>`922. Chart or release: `<chart path/name and release name>`933. Namespace: `<namespace or all namespaces>`944. Validation results: `<lint, dry-run, template, or not checked>`955. Template output: `<summary or not applicable>`966. Next steps: `<install, upgrade, rollback, inspect, or none>`9798### Validation99- Chart check: `<helm lint, helm template, dry-run, or reason not checked>`100- Command result: `<exit code or observed helm output>`101```102103## Limits104105- Do not use this skill for kubectl cluster operations.106- Use `azure-kubectl-cli` (`skill`) instead when the task is direct Kubernetes resource inspection, logs, events, rollout status, or manifest application.107- Do not use this skill for ArgoCD sync and app health.108- Use `azure-argocd-cli` (`skill`) instead when the task is GitOps application sync, health, diff, or drift management.109- Do not use this skill for Terraform IaC.110- Use `azure-terraform-cli` (`skill`) instead when the task is infrastructure provisioning, state, plans, modules, or provider locks.111- Do not use this skill for full platform deployment.112- Use `open-horizons-deploy-orchestration` (`skill`) instead when the task spans prerequisites, Terraform, Kubernetes, and platform-wide validation.113114## Related primitives115116| Name | Type | Use it when |117| --- | --- | --- |118| `open-horizons-deployment-operator` | `agent` | Coordinating approved Helm releases as part of platform deployment. |119| `open-horizons-backstage-expert` | `agent` | Managing Backstage chart values and portal deployment workflows. |120| `open-horizons-sre-investigator` | `agent` | Investigating release or rollout health issues. |121| `azure-kubectl-cli` | `skill` | Inspecting Kubernetes resources created by Helm. |122| `azure-argocd-cli` | `skill` | Managing GitOps applications that apply Helm-rendered workloads. |123124## Quality gate125126- [ ] `name` is `azure-helm-cli` and matches the parent directory.127- [ ] `helm lint` is run or explicitly marked not applicable before deployment actions.128- [ ] Dry-run or template output is captured before applying chart changes when possible.129- [ ] Release, chart, namespace, and values file are included in the response when applicable.130- [ ] Rollback responses include the requested revision.131- [ ] Chart dependencies and versioning considerations are noted when they affect the command result.
paulasilvatech