002-jeremy-yaml-master-agent
Intelligent YAML validation, generation, and transformation agent with schema inference, linting, and format conversion capabilities
Installation
Open Claude Code and run this command:
/plugin install 002-jeremy-yaml-master-agent@claude-code-plugins-plus
Use --global to install for all projects, or --project for current project only.
What It Does
Intelligent YAML validation, generation, and transformation with schema inference and format conversion.
Features
⚡ Automatic Activation (Proactive Skill)
The YAML Master Agent activates automatically when Claude detects:
- Reading/writing
.yamlor.ymlfiles - 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:
...Skills (1)
'Execute proactive YAML intelligence: automatically activates when working.
How It Works
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!
FAQ
Diagnosis:
- Check indentation (tabs vs spaces)
- Verify key-value separator (
:with space) - Look for duplicate keys
Diagnosis:
- Validate API version matches cluster version
- Check required fields are present
- Verify resource names are DNS-compliant
Diagnosis:
- Check version compatibility
- Validate service dependencies
- Verify volume mount paths exist