vibe-coding-yaml

What problem does it solve?

This Skill provides a highly auditable and deterministic code generation workflow by having AI output YAML descriptors instead of direct code. This eliminates "slop" (unintended variations), simplifies code review, and ensures 100% reproducible and auditable behavior.

Core Features & Use Cases

• Auditable Generation: AI generates human-readable YAML descriptors, which are easier to review and version control than raw code.
• Deterministic Execution: A CLI tool executes the YAML descriptors to generate code, guaranteeing the same YAML always produces the exact same output.
• Zero Slop: Eliminates inconsistencies and unexpected variations in generated code, crucial for compliance and critical systems.
• Use Case: For generating UI components or infrastructure as code, the AI outputs a YAML descriptor for a "Button" component. This YAML is then deterministically converted into Button.tsx by a CLI tool, allowing developers to review the high-level YAML specification rather than the generated code.

Quick Start

1. AI outputs a YAML descriptor

(This YAML would be generated by the AI based on your request)

component: type: Button props: text: "Submit" variant: "primary" onClick: "handleSubmit" styles: padding: "12px 24px" borderRadius: "8px" backgroundColor: "#007bff"

2. CLI executes deterministically to generate code

generate-component component.yaml > Button.tsx