malloy-notebooks

Create Malloy .malloynb notebooks for interactive dashboards and data stories.

9|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/mathisdrn/orca --skill malloy-notebooks-mathisdrn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: malloy-notebooks
Source: https://github.com/mathisdrn/orca/tree/main/.agents/skills/malloy-notebooks
Command: npx skills add https://github.com/mathisdrn/orca --skill malloy-notebooks-mathisdrn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building interactive, shareable data notebooks in Malloy requires knowing the .malloynb cell syntax, filter annotation rules, and multi-model import behavior, which are easy to get wrong since compile errors only surface at publish time. ## Core Features & Use Cases - Notebook authoring: Compose .malloynb files with markdown and malloy cells following the question-query-drill narrative pattern. - Interactive filters and parameters: Declare #(filter) annotations on model sources or given: runtime parameters so Publisher renders filter widgets automatically. - Multi-model joins: Import several .malloy models in a setup cell and join sources across them in a single query cell. - Use Case: A data analyst wants a filterable dashboard notebook over a sales model; this Skill produces a .malloynb with framing markdown, chart-tagged queries, and source-level filter declarations. ## Quick Start Create a Malloy notebook that explores the orders model with a revenue trend chart and an interactive category filter.

Frequently Asked Questions about malloy-notebooks

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

FAQPage Schema
How do I create a Malloy notebook (.malloynb) file?▼

A .malloynb file alternates cells delimited by >>>markdown and >>>malloy. Put imports in a setup cell at the top, frame questions in markdown, and answer them with one run: query per cell, optionally prefixed with a chart tag like # line_chart.

How do I add interactive filters to a Malloy notebook?▼

Filters are declared on the model's source using #(filter) annotations with name=, dimension=, and type= parameters, not in the notebook itself. Publisher reads these annotations and renders filter widgets automatically, injecting where: clauses server-side.

Can a Malloy notebook join sources from multiple .malloy models?▼

Yes. Import each model in a setup cell at the top of the notebook, and any cell can reference and join sources across all imports. Imports cannot appear inside a run: cell because queries run as restricted queries against the compiled notebook.

Why don't Malloy notebook compile errors show in the IDE linter?▼

Compile errors in .malloynb files are not surfaced by the IDE linter; they only appear when cells are executed or the notebook is published. Verify notebooks by publishing to a scratch environment and testing queries in the model first.

When should I use a .malloynb notebook versus an ad-hoc analysis report?▼

Use a .malloynb notebook for curated, published dashboards and data stories, including cross-model joins. Use an ad-hoc analysis report for quick narrative artifacts from an analysis agent, since report cells render against a single model only.