Automatically create and fill in descriptive metadata for Hasura DDN models, types, commands, and fields in .hml (Hasura Metadata Language) files. Use when working with Hasura DDN metadata files that need descriptions added or enhanced, when generating new .hml files from data sources, or when improving PromptQL's understanding of data models through better semantic metadata.
This skill enables automatic generation of descriptive metadata for Hasura DDN .hml files. It analyzes the structure of Models, ObjectTypes, Commands, Relationships, and other metadata objects to generate clear, contextual descriptions that help PromptQL better understand and query your data.
Use this skill when:
Use the provided Python script to automatically enrich single files or entire directories:
# Process a single .hml file
python scripts/add_metadata.py path/to/Model.hml
# Process all .hml files in a directory
python scripts/add_metadata.py path/to/metadata/ --recursive
# Preview changes without modifying files
python scripts/add_metadata.py path/to/metadata/ --dry-run --recursive
The script will:
For more control or custom descriptions, read the HML structure reference and manually add descriptions:
references/hml_structure.md for detailed guidance on description formatsGenerates descriptions for Model objects that include:
Example output: