name: gastown-operator version: 1.0.0 tier: solo context: repo description: > Kubernetes operator for Gas Town multi-agent orchestration. Triggers on "create polecat", "spawn worker", "kubernetes polecat", "deploy convoy". triggers:

• "create polecat"
• "deploy polecat"
• "spawn polecat"
• "kubernetes polecat"
• "k8s polecat"
• "create convoy"
• "deploy convoy"
• "create witness"
• "create refinery"
• "gastown kubernetes"
• "gastown k8s" allowed-tools:
• Read
• Write
• Bash(kubectl:, helm:, oc:*)
• Grep
• Glob context-budget: skill-md: 3KB references-total: 25KB typical-session: 8KB

Gas Town Operator Skill

Create Gas Town Kubernetes resources quickly and correctly.

Use the kubectl-gt CLI for normal workflows. YAML templates are for GitOps.

Critical Facts

Golden Commands (CLI-First)

Create Rig

kubectl gt rig create {{RIG}} \
  --git-url git@github.com:org/repo.git \
  --prefix {{PREFIX}} \
  -n gastown-system

Dispatch Work (Sling)

# With explicit name
kubectl gt sling {{BEAD_ID}} {{RIG}} --name {{NAME}} -n gastown-system

# With themed name (mad-max, minerals, wasteland)
kubectl gt sling {{BEAD_ID}} {{RIG}} --theme mad-max -n gastown-system

# Wait for pod ready
kubectl gt sling {{BEAD_ID}} {{RIG}} --wait-ready --timeout 5m -n gastown-system

Variables: {{BEAD_ID}} (e.g., at-1234), {{RIG}} (e.g., athena), {{NAME}} (e.g., furiosa)

Convoy (Batch Tracking)

kubectl gt convoy create "Wave 1" {{BEAD1}} {{BEAD2}} {{BEAD3}} -n gastown-system

Monitor

kubectl gt polecat list -n gastown-system
kubectl gt polecat logs {{RIG}}/{{NAME}} -f -n gastown-system
kubectl gt polecat status {{RIG}}/{{NAME}} -n gastown-system

CLI Commands

All commands support -o json and -o yaml output.

Templates (YAML Alternative)

If you need declarative YAML (GitOps), templates are in templates/:

Validate: ./scripts/validate-template.sh <file>

Quick Checks

kubectl gt rig list -n gastown-system          # List rigs
kubectl gt polecat list -n gastown-system      # List polecats
kubectl gt auth status -n gastown-system       # Check creds
kubectl get secrets -n gastown-system          # Check secrets

Common Errors

JIT Load References

Load these when you need deeper context: