yaml-master

yaml-master provides proactive YAML intelligence by automatically activating when `.yml` or `.yaml` files are being handled. Its primary purpose is to detect structural and syntax issues early, helping prevent configuration failures in CI pipelines and deployment workflows. By identifying indentation errors, malformed structures, duplicate keys, and other breaking problems at the source, it reduces the risk of runtime failures and tooling errors. The skill focuses on maintaining schema-correct and structurally sound YAML for systems such as Kubernetes, GitHub Actions, Docker Compose, and similar configuration-driven platforms.

The skill parses and validates YAML syntax, identifies the first breaking error and its precise location, and normalizes formatting without altering semantics. It enforces consistent indentation and quoting while preserving meaning. Beyond syntax, it validates structure against the expectations of the intended target system, checking keys, required fields, and type correctness. It also highlights risky patterns such as ambiguous scalars, duplicate keys, and incorrect anchor usage. Output is intentionally minimal and safe: a corrected YAML patch with concise diffs, a categorized list of issues (syntax, schema, best practice), and recommended follow-up validation commands appropriate for the target environment.

yaml-master is designed for developers, DevOps engineers, platform engineers, and teams managing infrastructure-as-code or CI/CD workflows. It is especially useful in environments where configuration errors can block deployments or break automation. The skill supports both direct file correction and patch-based proposals, and it adapts its behavior depending on whether the target system or schema is known. When the schema is unclear, it applies syntax-only fixes and requests clarification to ensure safe and accurate validation.