Tilt Config Skill

Install: npx skills add diskd-ai/tilt-config | skills.sh

Skill for creating, updating, and troubleshooting Tilt development environments (Tiltfile authoring, resource modeling, and debugging).

---

Scope & Purpose

This skill provides guidance and utilities for working with Tilt, covering:

• Authoring and evolving Tiltfile setup for a repo (Kubernetes/Helm/Kustomize/Docker Compose/local processes)
• Common Tiltfile patterns: docker_build, custom_build, live_update, k8s_yaml, k8s_resource, local_resource
• Diagnosing Tiltfile evaluation and runtime issues using first-party tooling (tilt doctor, tilt get ... -o json, logs)
• Using a local Tilt docs source checkout (when available) for exact API details and snippets

---

When to Use This Skill

Triggers:

• Mentions of Tilt, Tiltfile, tilt up, tilt ci, live_update, k8s_resource, local_resource
• Requests to “add Tilt to this repo”, “make Tilt faster”, “wire these services”, or “debug Tilt not updating”
• You want exact Tiltfile API signatures without web browsing by using /Users/alexeus/src/tilt.build/docs

Use cases:

• Bootstrap a minimal working Tiltfile, then iterate to match the repo’s real workflow
• Switch a repo between Kubernetes vs Compose vs local-process orchestration (or mix them cleanly)
• Debug why builds/updates aren’t triggering, why resources are unhealthy, or why a Tiltfile fails to load

---

Quick Reference

Local docs helper

This skill includes a helper to query a local Tilt docs checkout:

python3 scripts/tilt_docs.py paths
python3 scripts/tilt_docs.py rg "live_update"
python3 scripts/tilt_docs.py api docker_build
python3 scripts/tilt_docs.py snippet docker_build_simple

Override paths (optional):

export TILT_DOCS_ROOT=/Users/alexeus/src/tilt.build/docs
export TILT_SRC_ROOT=/Users/alexeus/src/tilt.build/src

Diagnostics

tilt doctor
tilt get uiresources -o json
tilt get uiresource/<name> -o json

---

Skill Structure

tilt-config/
  SKILL.md                      # Entry point (workflow + local docs pointers)
  README.md                     # This file (overview)
  scripts/
    tilt_docs.py                # Local docs search/extract helper
  references/
    tilt-docs-local.md          # Local docs checkout notes + usage
  agents/
    openai.yaml                 # OpenAI agent configuration

---

Resources

• Full skill reference: SKILL.md
• Local docs notes: references/tilt-docs-local.md

---

License

MIT