Execute proactive YAML intelligence: automatically activates when working with YAML files. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.
Proactive YAML intelligence: validate syntax, enforce consistent formatting, and keep configuration files schema-correct (Kubernetes, GitHub Actions, Docker Compose, and similar).
Overview
This skill activates when working with .yml/.yaml files to detect structural issues early (indentation, anchors, type mismatches), and to produce safe, minimal edits that keep CI/config tooling happy.
Prerequisites
The YAML file(s) to inspect and their intended target (e.g., Kubernetes, GitHub Actions, Compose)
Any relevant schema or constraints (when available)
Permission to edit the file(s) (or to propose a patch)
Instructions
Parse and validate YAML syntax (identify the first breaking error and its location).
Normalize formatting (indentation, quoting) without changing semantics.
Validate structure against the target system’s expectations (keys, types, required fields).
Identify risky patterns (duplicate keys, ambiguous scalars, anchors used incorrectly).
Output a minimal patch plus a short validation checklist (what to run next).
Output
Corrected YAML with minimal diffs
A concise list of issues found (syntax vs schema vs best practice)
Follow-up validation commands appropriate for the target (e.g., kubectl apply --dry-run=client, CI lint)
Error Handling
If the schema/target is unknown, ask for the target system and apply syntax-only fixes first.
If the YAML is valid but tooling still fails, surface the exact downstream error and reconcile expectations.
Examples
Example: Fix an indentation/syntax error
Input: a workflow with a mis-indented steps: block.
Output: corrected indentation and a note on which job/step was affected.
Example: Convert JSON to YAML safely
Input: a JSON config blob.
Output: YAML with explicit quoting where necessary to avoid type surprises.
Resources
Full detailed guide (kept for reference): {baseDir}/references/SKILL.full.md
1---2name: yaml-master-23description: Execute proactive YAML intelligence: automatically activates when working with YAML files. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.4license: MIT5---6# YAML Master
78Proactive YAML intelligence: validate syntax, enforce consistent formatting, and keep configuration files schema-correct (Kubernetes, GitHub Actions, Docker Compose, and similar).
910## Overview
1112This skill activates when working with `.yml`/`.yaml` files to detect structural issues early (indentation, anchors, type mismatches), and to produce safe, minimal edits that keep CI/config tooling happy.
1314## Prerequisites
1516- The YAML file(s) to inspect and their intended target (e.g., Kubernetes, GitHub Actions, Compose)
17- Any relevant schema or constraints (when available)
18- Permission to edit the file(s) (or to propose a patch)
1920## Instructions
21221. Parse and validate YAML syntax (identify the first breaking error and its location).
232. Normalize formatting (indentation, quoting) without changing semantics.
243. Validate structure against the target system’s expectations (keys, types, required fields).
254. Identify risky patterns (duplicate keys, ambiguous scalars, anchors used incorrectly).
265. Output a minimal patch plus a short validation checklist (what to run next).
2728## Output
2930- Corrected YAML with minimal diffs
31- A concise list of issues found (syntax vs schema vs best practice)
32- Follow-up validation commands appropriate for the target (e.g., `kubectl apply --dry-run=client`, CI lint)
3334## Error Handling
3536- If the schema/target is unknown, ask for the target system and apply syntax-only fixes first.
37- If the YAML is valid but tooling still fails, surface the exact downstream error and reconcile expectations.
3839## Examples
4041**Example: Fix an indentation/syntax error**
42- Input: a workflow with a mis-indented `steps:` block.
43- Output: corrected indentation and a note on which job/step was affected.
4445**Example: Convert JSON to YAML safely**
46- Input: a JSON config blob.
47- Output: YAML with explicit quoting where necessary to avoid type surprises.
4849## Resources
5051- Full detailed guide (kept for reference): `{baseDir}/references/SKILL.full.md`
52- YAML spec: https://yaml.org/spec/
53- GitHub Actions workflow syntax: https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions
Run npx skillmds add tools-only/yaml-master-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Execute proactive YAML intelligence: automatically activates when working with YAML files. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.
tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tools-only