public_git
/
helmfile
mirror of https://github.com/helmfile/helmfile.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
helmfile/skills/helmfile
History
yxxhero 41d815aa5b
docs: update helmfile skill to reflect v1.1 documentation (#2577) 
docs: update helmfile skill to reflect v1.1 documentation (#2576)

- Add Helmfile v1.0/v1.1 status and Helm 4 support
- Expand release configuration fields with tracking, templating, and ownership options
- Add new CLI commands: fetch, unittest, show-dag, write-values, build, cache, create
- Add values merging and data flow precedence documentation
- Expand hooks with preapply, preuninstall, postuninstall events and kubectlApply
- Add kubedog resource tracking (helm/helm-legacy/kubedog modes)
- Add JSON patches and template partials documentation
- Complete remote secrets (vals) with fetchSecretValue and expandSecretRefs
- Add comprehensive repository configuration (OCI, TLS, GPG verify)
- Update metadata version to 1.1.0

Signed-off-by: yxxhero <aiopsclub@163.com>
 		2026-05-04 14:20:17 +08:00
..
README.md docs: update helmfile skill to reflect v1.1 documentation (#2577) 2026-05-04 14:20:17 +08:00
SKILL.md docs: update helmfile skill to reflect v1.1 documentation (#2577) 2026-05-04 14:20:17 +08:00
metadata.json docs: update helmfile skill to reflect v1.1 documentation (#2577) 2026-05-04 14:20:17 +08:00

README.md

Helmfile Agent Skill

Expert guidance for Helmfile v1.1, a declarative spec for deploying Helm charts to Kubernetes.

Installation

Using skills.sh CLI

npx skills add helmfile/helmfile --skill helmfile

Manual Installation

For Claude Code

mkdir -p ~/.claude/skills
cp -r skills/helmfile ~/.claude/skills/

For Cursor

mkdir -p ~/.cursor/skills
cp -r skills/helmfile ~/.cursor/skills/

For OpenCode

mkdir -p ~/.agents/skills
cp -r skills/helmfile ~/.agents/skills/

What This Skill Covers

  • Status: Helmfile v1.0/v1.1 released, supports Helm 3.x and Helm 4.x
  • Configuration Structure: Full helmfile.yaml reference with all release fields
  • CLI Commands: sync, apply, diff, destroy, template, fetch, unittest, show-dag, write-values, and more
  • Templating: Built-in objects, template functions (env, exec, readFile, fetchSecretValue, expandSecretRefs), partials
  • Environments: Multi-environment setup, HCL values, conditional releases
  • Values Merging: Data flow and precedence (bases -> root values -> env values -> HCL -> secrets -> CLI overrides)
  • Layering: Bases, release templates, nested helmfiles
  • Hooks: Lifecycle hooks (prepare, preapply, presync, preuninstall, postuninstall, postsync, cleanup) with kubectlApply
  • Advanced Features: Kubedog resource tracking, Kustomize integration, strategic merge patches, JSON patches, transformers, chart dependencies, remote secrets (vals)
  • Best Practices: Directory structure, DRY configuration, labels filtering, missing keys handling
  • Troubleshooting: Common issues and solutions, Helm 4 compatibility

Usage

Once installed, simply ask your AI agent questions about Helmfile:

  • "Create a helmfile.yaml for deploying Prometheus"
  • "How do I set up multi-environment deployments?"
  • "Explain release templates and layering"
  • "Help me troubleshoot a Helmfile sync issue"
  • "How do I use kubedog for resource tracking?"
  • "Set up hooks for CRD installation before sync"
  • "How do I use vals for remote secrets?"

References