malloy-debug

Diagnose and fix Malloy compile errors in .malloy files using IDE diagnostics.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Malloy compile errors often cascade, producing 20+ confusing messages that hide the root cause. This Skill provides a systematic strategy to retrieve diagnostics, fix the first error, and iterate until the file compiles cleanly. ## Core Features & Use Cases - Diagnostics Retrieval: Pull errors via mcp__ide__getDiagnostics in Claude Code, ReadLints in VS Code/Cursor, or manual lint inspection. - Quick-Fix Reference Table: Maps common errors like "Unknown field", "Aggregate not allowed in where", and "Cannot redefine" to concrete fixes. - Gotchas Checklist: Covers reserved-word backticking, NULL checks, date functions, having clauses, type casting, joins, and cross-file import errors. - Use Case: A user sees dozens of cascading errors after editing a .malloy model; the Skill identifies that an unbackticked reserved word like Date is the root cause and resolves the file step by step. ## Quick Start Fix the compile errors in my orders.malloy file by checking the diagnostics and resolving the first error.

Frequently Asked Questions about malloy-debug

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

FAQPage Schema
How do I fix Malloy compile errors in VS Code?▼

Retrieve diagnostics using the ReadLints tool or the Malloy extension's lint output, then fix only the first reported error and re-check. Errors cascade in Malloy, so resolving the earliest one often clears many downstream messages.

Why does my Malloy file show 20 or more errors at once?▼

Mass cascading errors usually come from using a reserved word like Date, Hour, or number as a field name without backticks. Wrap the identifier in backticks, such as `Date`, and most of the errors will disappear.

How do I filter on aggregate values in Malloy?▼

Use the having clause instead of where for aggregate filters, for example having: order_count > 10. The where clause cannot reference aggregates, which triggers the "Aggregate not allowed in where" error.

Why does Malloy say "Unknown field" when the field exists?▼

Unknown field errors come from typos, wrong source ordering, referencing the wrong source, or a missing import statement. Check spelling first, then verify the field's source is defined or imported before use.

Can I import Malloy sources from subdirectories?▼

No, the recommended layout is flat: all .malloy files live in the same package root directory. Use import "orders.malloy" rather than relative paths like "../sources/orders.malloy" to avoid import path errors.