semantic-view-optimization-setup

Download semantic model YAML and create a timestamped optimization directory.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/randoneering/nix-flake-mirror --skill semantic-view-optimization-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: semantic-view-optimization-setup
Source: https://github.com/randoneering/nix-flake-mirror/tree/main/home/programs/opencode/skills/snowflake/semantic-view-optimization/setup
Command: npx skills add https://github.com/randoneering/nix-flake-mirror --skill semantic-view-optimization-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the initial setup for semantic view optimization sessions by downloading the semantic model YAML, extracting verified queries, and preparing a timestamped optimization directory to ensure a reproducible starting point for audits and debugging.

Core Features & Use Cases

  • Download the semantic model YAML to a timestamped directory using the provided semantic view name.
  • Create a dedicated directory named semantic_view_optimization_TIMESTAMP and prepare components for analysis.
  • Use helper scripts such as download_semantic_view_yaml.py and semantic_view_get.py to retrieve tables, verified_queries, custom_instructions, and relationships for downstream workflows.

Quick Start

Create a new semantic view optimization directory with a timestamp and download the YAML using the provided semantic view name.

Frequently Asked Questions about semantic-view-optimization-setup

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

FAQPage Schema
How do I download semantic view YAML from Snowflake for optimization?

Downloading a semantic model YAML for optimization requires a fully-qualified semantic view name, Snowflake access, and a Python environment managed via uv. The process uses helper scripts to retrieve the YAML and extract components into a timestamped directory.

What is a semantic view optimization session in Snowflake?

A semantic view optimization session is a structured workflow for auditing and debugging semantic models. It begins by downloading the YAML and extracting verified queries, custom instructions, and relationships to establish a reproducible starting point for analysis.

How do I set up a reproducible directory for semantic model audits?

You set up a reproducible audit directory by running a setup process that creates a dedicated folder named semantic_view_optimization_TIMESTAMP. This directory stores the downloaded YAML and extracted components, ensuring consistent starting conditions for debugging.

Do I need Python and uv to extract verified queries from a semantic model?

Yes, you need a Python environment managed via uv to run the required helper scripts, download_semantic_view_yaml.py and semantic_view_get.py. These scripts coordinate the extraction of verified queries, tables, and relationships from the semantic model.

Can I retrieve custom instructions and relationships from a Snowflake semantic view?

Yes, you can retrieve custom instructions and relationships by executing the semantic_view_get.py helper script. This script extracts these specific components alongside tables and verified queries from the downloaded semantic model YAML for downstream workflows.

When should I start a new semantic view optimization run?

You should start a new semantic view optimization run when initiating audits, debug workflows, or performance reviews. It prepares a fresh timestamped directory with the current YAML and extracted components to ensure your analysis reflects the latest model state.