⚡ Automatic Activation (Proactive Skill)

The YAML Master Agent activates automatically when Claude detects:

• Reading/writing .yaml or .yml files
• Working with Kubernetes, Docker Compose, CI/CD configs
• Mentions of "yaml", "validate", "convert", "lint"

No user action required!

🔍 Intelligent Validation

• Detects syntax errors with line numbers
• Validates against YAML 1.2 specification
• Identifies anti-patterns (tabs vs spaces, duplicate keys)
• Provides detailed fix suggestions

Example:

services:
  web:
	image: nginx  # Tab indentation ERROR!

Agent fixes:

services:
  web:
    image: nginx  # Consistent spaces

🎯 Schema Inference & Generation

• Infers JSON Schema from YAML structure
• Generates TypeScript/Python types from configs
• Validates instances against schemas
• Creates OpenAPI specs from YAML

Example:

user:
  name: Jeremy
  age: 35

Agent generates schema:

{
  "type": "object",
  "properties": {
    "user": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "age": { "type": "integer" }
      }
    }
  }
}

🔄 Format Conversion

Seamless conversion between:

• YAML ↔ JSON
• YAML ↔ TOML
• YAML ↔ XML

Preserves comments and maintains semantic equivalence.

☸️ Kubernetes Manifest Expertise

• Validates manifests against K8s API versions
• Suggests best practices (resource limits, health checks)
• Detects security issues (privileged containers, root users)
• Generates complete manifests from minimal specs

Example - Minimal to Production-Ready:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx

Agent expands with best practices:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
  labels:
    app: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    spec:
      containers:
      - name: nginx
        image: nginx:1.25-alpine
        resources:
          requests:
            memory: "64Mi"
            cpu: "250m"
          limits:
            memory: "128Mi"
            cpu: "500m"
        livenessProbe:
          httpGet:
            path: /
            port: 80
        securityContext:
          runAsNonRoot: true
          runAsUser: 1000

🐳 Docker Compose Optimization

• Validates Docker Compose syntax (v2.x, v3.x)
• ...