skills.rest
Semprini
SempriniCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/Semprini/md-ddl --skill preflight-semprini
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
HeXiao-55HeXiao-55
1

mermaid-diagram

Create Mermaid diagrams from requirements and validate syntax.

Community
Advanced
SempriniSemprini
1

knowledge-graph

Generate Neo4j Cypher DDL schemas from MD-DDL domain models.

Community
Advanced
mgajewskikmgajewskik
6

mermaid-diagrams

Render Mermaid syntax into SVG, PNG, or PDF outputs.

Community
Intermediate
CyranoBCyranoB
1

code-quality

Detect and run project-native linters and type checkers to fix code issues.

Community
Advanced