malloy-document
Installation
SKILL.md
Documenting a Malloy Model
Add #(doc) tags to describe sources and fields in plain language so they are easy to find and understand:
| Tag | Purpose | Goes on |
|---|---|---|
#(doc) |
Plain-language description for natural-language search | source, dimension, measure, view, join |
#(filter) |
Declare a parameterizable filter (runtime/modeling concern, see malloy-model) |
source |
#(doc) is a standard Malloy annotation. It documents a field or source with a human-readable description that downstream tools can surface and search against.
#(doc) Tag
Add before any source, dimension, measure, view, or join. When multiple fields share a keyword, use it once as a block header. Tags and field names are indented under the keyword; tags go on the line(s) directly above the field they annotate.
Tag ordering (when a field has multiple tags): #(doc) → render tags (# currency, # label, etc.) → field name. Separate each field group with a blank line: