preflight

Validate MD-DDL models with five mechanical checks on YAML, Mermaid, links, references, and versioning.

1|Updated Feb 7, 2026

Search Tags:#commit #validation #preflight #domain #model checking #md-ddl

Ready to run

npx skills add https://github.com/Semprini/md-ddl --skill preflight-semprini

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: preflight
Source: https://github.com/Semprini/md-ddl/tree/main/agents/agent-ontology/skills/preflight
Command: npx skills add https://github.com/Semprini/md-ddl --skill preflight-semprini

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

This Skill ensures your MD-DDL models are mechanically sound before committing them, preventing common errors and saving debugging time.

Core Features & Use Cases

Automated Checks: Runs five essential validation checks on your domain folder.
Error Reporting: Clearly identifies issues with YAML syntax, Mermaid diagrams, internal links, entity references, and domain versions.
Use Case: Before pushing your latest changes to the customer domain, you can run this skill to catch any typos in links or missing version information, ensuring a clean commit.

Quick Start

Run the preflight skill to check the domain folder 'domains/customer'.

Frequently Asked Questions about preflight

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

FAQPage Schema

How do I validate MD-DDL models before committing changes?▼

You can validate MD-DDL models before committing by running a preflight check against your specified domain folder to mechanically identify issues in YAML syntax, Mermaid syntax, internal links, entity references, and domain versions.

What does MD-DDL model checking cover for domain versioning and syntax?▼

MD-DDL model checking covers five mechanical validations: YAML syntax, Mermaid syntax, internal link integrity, entity reference consistency, and domain versioning, ensuring your model is structurally sound before publishing.

Can I use pyyaml to check Mermaid syntax and internal link integrity?▼

Yes, the preflight validation requires pyyaml as a dependency to execute its five mechanical checks, which include verifying Mermaid syntax, internal link integrity, and entity reference consistency within your domain folder.

What's the best way to catch entity reference errors in a domain folder?▼

The best way to catch entity reference errors is to run an automated validation script against the domain folder, which checks entity reference consistency alongside YAML syntax and internal link integrity to ensure a clean commit.

Why does my MD-DDL commit fail domain versioning validation?▼

Your MD-DDL commit may fail domain versioning validation if the specified domain folder is missing required version information, which the preflight check identifies alongside internal link and entity reference issues.