002 Jeremy Yaml Master Agent

Intelligent YAML validation, generation, and transformation with schema inference and format conversion.

[ ]

Problem This Solves

Before: Working with YAML files is error-prone. Syntax errors from indentation, duplicate keys, and format inconsistencies cause pipeline failures. Manual validation and conversion between formats is tedious.

After: The YAML Master Agent automatically detects YAML work and provides intelligent validation, schema inference, linting, and seamless format conversion. Never struggle with YAML syntax again.

Quick Start

Installation

/plugin install 002-jeremy-yaml-master-agent@claude-code-plugins-plus

Basic Usage

The skill activates automatically when working with YAML files. No commands needed!

Example 1: Validate YAML

User: Check this kubernetes manifest for errors
*Opens deployment.yaml*

Agent: 🔍 YAML Master Agent activated
Found 3 issues:
1. Line 12: Mixed indentation (tabs and spaces)
2. Line 24: Duplicate key "metadata"
3. Line 31: Missing required field "selector"

Here's the corrected version...

Example 2: Convert JSON to YAML

User: Convert this JSON config to YAML

Agent: 📋 Converting JSON to idiomatic YAML...
✅ Conversion complete! Added comments and optimized structure.

Example 3: Generate Docker Compose

User: Create docker-compose.yaml for nginx, postgres, redis

Agent: 🐳 Generating optimized Docker Compose configuration...
✅ Complete with healthchecks, volumes, and networks!

Features

⚡ 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:

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

Agent fixes:

# ✅ VALID
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:

# Input
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:

# You provide
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:
…

🐳 Docker Compose Optimization

• Validates Docker Compose syntax (v2.x, v3.x)
• Suggests networking and security best practices
• Optimizes volume mounts and environment variables
• Detects misconfigurations (hardcoded secrets, missing healthchecks)

⚙️ CI/CD Pipeline Intelligence

Optimizes workflows for:

• GitHub Actions
• GitLab CI
• CircleCI
• Azure Pipelines
• Travis CI

Suggests caching, parallelization, and matrix builds for faster pipelines.

📏 Linting & Style Enforcement

• Enforces consistent indentation (2/4 spaces)
• Validates key ordering
• Detects trailing whitespace
• Suggests canonical YAML representations

Linting Rules:

1. Consistent 2-space indentation
2. No duplicate keys
3. Quoted strings for special characters