modscape-modeling

Creates and maintains YAML-defined data models for Modern Data Stack visualization.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/yujikawa/modscape --skill modscape-modeling-yujikawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: modscape-modeling
Source: https://github.com/yujikawa/modscape/tree/main/src/templates/gemini/modscape-modeling
Command: npx skills add https://github.com/yujikawa/modscape --skill modscape-modeling-yujikawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Data teams struggle to keep physical schemas, logical entities, and business metrics consistent in a single version-controllable source of truth. This Skill manages the model.yaml file used by Modscape so tables, relationships, lineage, and metrics stay aligned with project modeling rules. ## Core Features & Use Cases - Rule-Governed Modeling: Reads and enforces .modscape/rules.md (and .modscape/rules.custom.md when present) before making any change, warning users when a request violates project conventions. - CLI-First Mutations: Prefers validated modscape CLI commands (table get/add/update, layout) over direct YAML edits for atomic, safe changes to tables, columns, relationships, and domains. - Metrics & Lineage Generation: Adds business metrics to the top-level metrics: section and derives table-level lineage: entries from metric expressions. - Use Case: An analytics engineer asks to add a new fact_orders table with a revenue metric; the Skill creates the table via CLI, assigns layout coordinates and a fact conceptual kind, then generates lineage connecting source tables to the metric. ## Quick Start Ask the assistant to add a new dimension table with primary keys and relationships to model.yaml following the project rules.

Frequently Asked Questions about modscape-modeling

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

FAQPage Schema
How do I add a new table to a Modscape model.yaml file?▼

Use the modscape CLI mutation commands instead of editing YAML directly: check existence with `modscape table get model.yaml --id <id> --json`, then run `modscape table add` or `modscape table update`, and finish with `modscape layout model.yaml` to assign coordinates.

How do I define business metrics and data lineage in YAML?▼

Add metrics to the top-level `metrics:` section with an id, name, expression, and description. Then analyze the expression to create table-level `lineage:` entries, one per source table referenced in the expression.

Does Modscape support Data Vault and star schema modeling?▼

Yes, the conceptual kind field supports fact, dimension, mart, hub, link, satellite, and table types. Setting the appropriate kind ensures correct visualization of Data Vault or star schema structures on the canvas.

Can I split a large data model into multiple YAML files?▼

Yes, `modscape dev` supports pointing to a directory of YAML files. Splitting large models into domain-specific files improves organization, and the visualizer identifies each model via a slug derived from the filename.

When should I edit model.yaml directly instead of using the CLI?▼

Edit YAML directly only for complex nested fields not covered by CLI flags, such as `physical`, `logical.scd`, `sampleData`, or full `columns` definitions. All other targeted changes should use the validated CLI commands.