Skip to content

AI Skills

llms.txt lists every page for an agent

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.

A skill is a markdown file shipped with a lexicon. An AI agent working in a chant project finds and loads the relevant skills itself, so it knows the build, lint and apply steps without being told.

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:

  • Build — chant build src/ --output manifests.yaml
  • Lint — chant lint src/ + post-synth checks (20 rules)
  • Apply — kubectl apply -f manifests.yaml
  • Status — kubectl get pods,svc,deploy
  • Rollback — kubectl 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

chant