Malloy Notebooks

Files: .malloynb

Scope: when to use this skill vs skill:malloy-analysis-report

This skill is for curated .malloynb notebooks. Interactive filter widgets render automatically from #(filter) annotations on the model's source. The notebook itself never declares filters.

For ad-hoc reports generated by an analysis agent, combining queries into a quick narrative artifact, use skill:malloy-analysis-report instead. Ad-hoc reports also inherit whatever #(filter) annotations are on the source.

Important Limitations

Compile errors in .malloynb files are NOT shown in the IDE linter. You will only see errors when cells are executed. Be extra careful with syntax and test queries in the model first if unsure.

Multiple Models & Cross-Model Joins

A published .malloynb runs each run: cell against the whole notebook, which compiles with all its imports in scope. So a notebook can import several .malloy models, and a single cell can reference, and join, sources from different imported files. Import each model you need in a setup cell at the top; no "re-export" wrapper model is required.