К основному содержанию
скилл CX Codex

mz-sql-navigation — скилл для Claude Code: SQL-навигация

Скилл mz-sql-navigation для Claude Code разбирает и меняет Materialize SQL через LSP. Перед правками находит связи объектов между файлами проекта mz-deploy.

Apache-2.0 131 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add MaterializeInc/agent-skills --skill mz-sql-navigation -a claude-code
Открыть на GitHub

Что делает mz-sql-navigation

Скилл направляет агента к LSP mz-deploy вместо поиска строк через grep. Он умеет переходить к определению view, table, source или index, показывать колонки и типы при наведении, а также выводить символы текущего файла или всего workspace.

Перед изменением объекта агент может найти его зависимости: из-за связей Materialize правка, корректная сама по себе, способна сломать downstream-объекты. После каждого изменения парсер автоматически сообщает об ошибках синтаксиса. mz-deploy должен быть в PATH, иначе language server не запустится; его проектная директория должна указывать на каталог с project.toml.

Какие задачи решает

  • найти определение Materialize-объекта в другом SQL-файле
  • проверить колонки и типы через LSP
  • вывести объекты, объявленные в текущем файле
  • отыскать объект по имени во всём workspace
  • проверить зависимости перед изменением view

Примеры запросов агенту

  • Разбери этот .sql-файл и найди определения всех используемых объектов через LSP, без grep.
  • Покажи колонки и типы объекта, на который ссылается этот запрос, используя наведение LSP.
  • Перед изменением этого view найди его downstream-зависимости и проверь ошибки синтаксиса после правки.

Как установить mz-sql-navigation

1Через Skills CLI (Vercel)

npx skills add MaterializeInc/agent-skills --skill mz-sql-navigation -a claude-code

2Вручную: положить файлы

~/.claude/skills/mz-sql-navigation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/mz-sql-navigation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о mz-sql-navigation

Как установить mz-sql-navigation в Claude Code?

Выполните npx skills add MaterializeInc/agent-skills --skill mz-sql-navigation -a claude-code, затем проверьте файл ~/.claude/skills/mz-sql-navigation/SKILL.md.

Что делает mz-sql-navigation?

Скилл использует LSP mz-deploy для перехода к определениям, просмотра колонок и типов, а также поиска символов в SQL-файле или workspace.

Что нужно для работы скилла?

mz-deploy должен находиться в PATH. Проектная директория language server должна вести к каталогу с project.toml, иначе навигационные запросы могут возвращать пустой результат.

Исходный текст

SKILL.md · Apache-2.0
---
name: mz-sql-navigation
description: Use when reading or editing .sql files in an mz-deploy project (a directory with project.toml) — resolve object references, columns, and types with the LSP tool instead of grepping. Covers go-to-definition, hover, and document/workspace symbols for Materialize SQL.
---

# Navigating Materialize SQL

The `mz-deploy` language server answers questions about an mz-deploy project's object
graph. Use the LSP tool for these instead of text search — grep finds strings that look
like an object name, the language server finds the object.

## What to use it for

- **Go to definition** — resolve where a referenced view, table, source, or index is
  defined, including across schemas.
- **Hover** — inspect an object's columns and their types without opening its definition.
- **Document symbols** — list the objects a single `.sql` file defines.
- **Workspace symbols** — locate an object by name when you don't know its file.

Before changing an object, use these to find what depends on it. In Materialize a view's
definition constrains everything downstream of it, so an edit that type-checks in
isolation can still break dependents.

## Diagnostics

Parse errors surface automatically after each edit. Treat them as authoritative for
syntax; they come from the same parser `mz-deploy` uses to build the project.

## Requirements

`mz-deploy` must be on `PATH` (`which mz-deploy`). If every navigation request comes back
empty while the server looks healthy, the plugin's **mz-deploy project directory**
setting is pointing somewhere other than the directory holding `project.toml`. The
server takes that directory as its project root, and a project nested in a subdirectory
needs the setting to name that subdirectory. Report this rather than falling back to
grep — a stale setting is worth fixing once.

© MaterializeInc · Apache-2.0 · MaterializeInc/agent-skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
chdb-sql chdb-io Скилл chdb-sql для Claude Code, Codex, Cursor и других агентов — запускает встроенный ClickHouse SQL через Python на локальных файлах, S3, Postgres, MySQL, Iceberg и Delta Lake. Работает без установки сервера: достаточно pip install chdb. CX Codex +1 10 300установок sql-jdbc-access-design Samuel Berthe Скилл sql-jdbc-access-design проектирует, как продукт отдаёт клиентам свои данные по SQL: JDBC/ODBC-эндпоинт, шару в хранилище или хостед-запросы. Пригодится до того, как подключится первый клиент. CX Codex +1 10 100установок sql-optimization-patterns Seth Hobson Скилл sql-optimization-patterns разбирает медленные SQL-запросы, планы EXPLAIN и стратегию индексов. Нужен при поиске Seq Scan, проблемах с JOIN и N+1. CX Codex +1 19 717установок sql-optimization официальный github Скилл sql-optimization помогает разбирать SQL-запросы, выбирать индексы и находить причины медленной работы. Подходит при тюнинге запросов в MySQL, PostgreSQL, SQL Server и Oracle. CX Codex +1 15 701установок sql-code-review официальный github Скилл sql-code-review проверяет SQL-код на проблемы безопасности, производительности и поддержки. Пригодится перед ревью запросов или схемы базы данных. CX Codex +1 14 060установок sql-query-optimizer Jeremy Longshore Скилл подсказывает, как оптимизировать SQL-запросы. Активируется сам, когда в запросе встречается «sql query optimizer», «sql optimizer» или просто «sql». CX Codex +1 1установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой