malloy-gotchas-rendering

Documents common Malloy renderer annotation mistakes for charts, dashboards, and theming.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/credibledata/credible-plugin --skill malloy-gotchas-rendering-credibledata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: malloy-gotchas-rendering
Source: https://github.com/credibledata/credible-plugin/tree/main/codex/skills/malloy-gotchas-rendering
Command: npx skills add https://github.com/credibledata/credible-plugin --skill malloy-gotchas-rendering-credibledata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Malloy renderer annotations fail silently or produce broken output when tags are combined on one line, scales are fixed on measures, or sparklines and dashboards are misconfigured. This Skill catalogs those recurring mistakes so chart annotations, formatting tags, and dashboards render correctly the first time. ## Core Features & Use Cases - Tag Syntax Rules: Enforces one # annotation per line directly above the field, and explains why combined tags fail. - Measure Formatting Guidance: Covers # currency without fixed scale on measure definitions, # big_value cards requiring # label, and comparison deltas with down_is_good. - Sparkline & Dashboard Setup: Details the two-part sparkline requirement (# hidden nested view plus .sparkline= reference) and # dashboard layout rules including columns mode, # colspan, # break, and gap. - Theming Reference: Explains nested palette.* / font.* theme keys, light/dark variants, annotation precedence over instance themes, and which settings are instance-only. - Use Case: Before adding a # bar_chart tile to a Malloy dashboard view, consult this Skill to place each tag on its own line and confirm columns=N is set so # colspan takes effect. ## Quick Start Review the Malloy rendering gotchas before adding chart annotations or building a dashboard in my semantic model.

Frequently Asked Questions about malloy-gotchas-rendering

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

FAQPage Schema
Why is my Malloy chart annotation not rendering?

Malloy renderer annotations fail when multiple `#` tags are combined on one line. Each annotation must sit on its own line directly above the field, otherwise the tags are ignored and the chart renders without them.

How do I add a sparkline to a Malloy big_value card?

A sparkline in `# big_value` requires two things: a nested view tagged with `# hidden` and `# line_chart { size=spark }`, plus a `.sparkline=` reference in the big_value tag matching that view's name. Missing either piece leaves the sparkline blank.

Should I set a currency scale on a Malloy measure definition?

No, use `# currency` without a scale on measure definitions because the same measure renders at many granularities. Add a scale like `# currency=usd0m` only in views after confirming value ranges with queries.

Why is colspan ignored in my Malloy dashboard?

`# colspan` only works in columns mode, so you must set `# dashboard { columns=N }` first. In flex mode colspan is silently ignored, while `# break` for new rows works in both modes.

Does a per-chart theme annotation override the instance theme in Malloy?

Yes, a `# theme.*` view annotation overrides both `## theme.*` model defaults and the instance theme for the keys it sets. However, only nested `palette.*` and `font.*` keys work; flat theme key names are silently dropped.