diagram-as-code-validation

Validate Diagram as Code YAML diagrams for structure and link integrity.

1|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/y-miyazaki/arc --skill diagram-as-code-validation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram-as-code-validation
Source: https://github.com/y-miyazaki/arc/tree/main/.github/skills/diagram-as-code-validation
Command: npx skills add https://github.com/y-miyazaki/arc --skill diagram-as-code-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured workflow to validate Diagram as Code YAML diagrams (DAC) for correctness, consistency, and reliable diagram generation.

Core Features & Use Cases

  • YAML syntax validation with yamllint to catch formatting and structural errors before diagram processing.
  • Validation workflow for AWS architecture diagrams, including link integrity and resource references.
  • Diagram generation support via awsdac to produce visual outputs from valid DAC YAML files.
  • Debug-friendly guidance and a documented validation checklist to streamline reviews.

Quick Start

yamllint aws_architecture_diagram.yaml awsdac -d aws_architecture_diagram.yaml -o diagram.png open diagram.png

Frequently Asked Questions about diagram-as-code-validation

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

FAQPage Schema
How do I validate Diagram as Code YAML files for AWS architecture diagrams?

To validate Diagram as Code YAML, run yamllint for syntax checks and awsdac for diagram generation to ensure correct structure, resource linkage, and reliable visual output before deployment.

What is the best way to check AWS diagram YAML syntax and link integrity before rendering?

The best way to check AWS diagram YAML is using a validation workflow that applies yamllint for syntax formatting and awsdac to verify resource link integrity across multiple files and environments.

Does awsdac work with yamllint for AWS architecture diagram validation?

Yes, awsdac works with yamllint for AWS architecture diagram validation by combining yamllint's structural syntax checks with awsdac's diagram generation and resource linkage verification capabilities.

How do I generate a PNG from a Diagram as Code YAML file?

To generate a PNG from Diagram as Code YAML, run the awsdac command with the -d flag for your input file and the -o flag for the output PNG, then open the resulting image.

Why does my AWS diagram generation fail after passing basic YAML syntax checks?

AWS diagram generation can fail after YAML syntax checks due to broken link integrity or invalid resource references, requiring a full validation workflow that verifies cross-file resource linkage.

Can I validate resource references across multiple Diagram as Code files and environments?

Yes, you can validate resource references across multiple Diagram as Code files and environments by applying a structured validation workflow that checks link integrity and resource connections comprehensively.