Skip to content

AI Skills

The Kubernetes lexicon ships an AI skill called chant-k8s that teaches AI coding agents how to build, validate, and deploy Kubernetes manifests from a chant project.

Skills are structured markdown documents bundled with a lexicon. When an AI agent works in a chant project, it discovers and loads relevant skills automatically — giving it operational knowledge about the deployment workflow without requiring the user to explain each step.

When you scaffold a new project with chant init --lexicon k8s, the skill is installed to skills/chant-k8s/SKILL.md for automatic discovery by Claude Code.

The chant-k8s skill covers the full deployment lifecycle:

  • Buildchant build src/ --output manifests.yaml
  • Lintchant lint src/ + post-synth checks (20 rules)
  • Applykubectl apply -f manifests.yaml
  • Statuskubectl get pods,svc,deploy
  • Rollbackkubectl rollout undo deployment/my-app
  • Troubleshooting — pod status, logs, events, common error patterns

The skill is invocable as a slash command: /chant-k8s

The full playbook is also available as a documentation page.

The lexicon also provides MCP (Model Context Protocol) tools and resources:

MCP toolDescription
diffCompare current build output against previous
MCP resourceDescription
resource-catalogJSON list of all supported K8s resource types
examples/basic-deploymentExample Deployment + Service code