yaml-config-helper

Validate, format, and troubleshoot YAML configuration files against common schemas.

Updated May 22, 2026
One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill yaml-config-helper-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yaml-config-helper
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/yaml-config-helper
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill yaml-config-helper-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? YAML configuration files fail silently due to indentation errors, tabs, missing colons, and unquoted special characters, causing broken deployments and hard-to-diagnose pipeline failures. ## Core Features & Use Cases - Syntax Validation: Check indentation, colons, quotes, and list formatting in YAML files. - Schema-Aware Review: Validate against Docker Compose, Kubernetes, GitHub Actions, and Ansible conventions. - Best-Practice Formatting: Apply 2-space indentation, explicit typing, anchors, aliases, and comments for maintainable configs. - Use Case: A GitHub Actions workflow fails to run. Paste the YAML file and get the indentation error identified, a corrected version, and an explanation of the validation error. ## Quick Start Ask the assistant to validate and fix the attached YAML configuration file and explain any errors found.

Frequently Asked Questions about yaml-config-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a YAML file for syntax errors?

Check indentation consistency, colons after keys, and quoting of special characters, then run yamllint for automated validation. Common failures come from tabs instead of spaces and incorrect indentation levels.

How to fix YAML indentation errors in Kubernetes manifests?

Use 2-space indentation consistently and ensure nested keys align under their parent keys. Kubernetes manifests fail when list items or nested mappings are misaligned, so compare against the schema structure and correct each level.

Why does my YAML file fail with tabs instead of spaces?

YAML specification requires spaces for indentation and rejects tab characters entirely. Replace all tabs with spaces, typically 2 spaces per level, to resolve the parse error.

Can I validate YAML against Docker Compose or GitHub Actions schemas?

Yes, YAML files can be checked against Docker Compose, Kubernetes, GitHub Actions, and Ansible conventions. Schema-aware validation catches missing required keys and incorrect value types beyond basic syntax checks.

When should I use anchors and aliases in YAML?

Use anchors and aliases when the same configuration block repeats across a file, such as shared environment variables in Docker Compose. They reduce duplication but should be avoided when they hurt readability for other maintainers.