Skip to content

skills: add malloy-materialization-inventory and -design - #945

Open
girishjeswani wants to merge 1 commit into
malloydata:mainfrom
girishjeswani:skills/malloy-materialization-inventory-design
Open

skills: add malloy-materialization-inventory and -design#945
girishjeswani wants to merge 1 commit into
malloydata:mainfrom
girishjeswani:skills/malloy-materialization-inventory-design

Conversation

@girishjeswani

Copy link
Copy Markdown
Collaborator

What

Adds the two sibling shared skills that flank malloy-materialization:

  • malloy-materialization-inventory - profile the warehouse before materializing: where the row volume actually is, how selective each hard-coded filter is, what the workload costs, and which tables to build.
  • malloy-materialization-design - where the #@ persist tags go and how to shape sources around them, anchored on the correctness rule that a narrow table can only back a source that statically pins everything the table narrows on (otherwise a caller-varied filter returns empty, not slow - a silent wrong answer a parity check can't catch).

Together with the existing malloy-materialization (tag syntax + build debugging) and the Publisher-only malloy-materialization-tuning (cost/perf), they form a what → where → how → tune set. Each new skill hands off to the others by skill: reference; nothing is removed.

Verified against the current compiler: persist-inheritance-through-extend (refined-source.ts records the base persistable source's id for dependency tracking), query_source-only serve-time routing, and compose() field-presence routing.

Mechanics

  • Two .claude/skills symlinks, both listed in skills/README.md's shared set, and skills_bundle.json regenerated (30 → 32; the house-style + sync spec passes locally, 5 pass / 0 fail).

Shared-set sync note

Synced from the upstream shared set with the standard shared-skill adaptations applied so it satisfies this repo's contract: em-dashes removed (house-style test), the draft-executor tool named bare (execute_query) with the portability note, and the artifact-design cross-reference neutralized (it's a host-side skill, absent here). The upstream copy needs these identical edits to keep the two byte-identical.

@girishjeswani
girishjeswani force-pushed the skills/malloy-materialization-inventory-design branch from de6dd14 to 812a271 Compare July 31, 2026 19:16
Mirror the two sibling shared skills that flank malloy-materialization:

- malloy-materialization-inventory: profile the warehouse before materializing
  (where the rows are, how selective each filter is, what the workload costs).
- malloy-materialization-design: where the #@ persist tags go and how to shape
  sources around them, including the "narrow table + caller-varied filter =>
  empty, not slow" correctness rule.

Together with the existing malloy-materialization (tag syntax + build debugging)
and Publisher's malloy-materialization-tuning (cost/perf), they form the
what / where / how / tune set.

Adds the two .claude/skills symlinks, lists both in skills/README.md's shared
set, and regenerates skills_bundle.json (30 -> 32). No em-dashes, per the
house-style test.

Kept byte-identical with the upstream shared set (ms2data/agent-skills#69,
tip f7213ea): generic illustrative examples (no client-specific schema/values/
figures), the draft-executor tool named bare (execute_query) with the
portability note, no artifact-design cross-reference, the design frontmatter
description single-quoted so YAML does not truncate it at ` #@`, and the
denormalize example's second join declared.

Signed-off-by: Girish Jeswani <girish@credibledata.com>
@girishjeswani
girishjeswani force-pushed the skills/malloy-materialization-inventory-design branch from 812a271 to 187638b Compare August 3, 2026 18:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant