mz-sql-navigation — скилл для Claude Code: SQL-навигация
Скилл mz-sql-navigation для Claude Code разбирает и меняет Materialize SQL через LSP. Перед правками находит связи объектов между файлами проекта mz-deploy.
Apache-2.0 131 установок ★ 3 обновлён 2026-10-25
npx skills add MaterializeInc/agent-skills --skill mz-sql-navigation -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/mz-sql-navigation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mz-sql-navigation/
1Через Skills CLI (Vercel)
npx skills add MaterializeInc/agent-skills --skill mz-sql-navigation -a codex2Вручную: положить файлы
.agents/skills/mz-sql-navigation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add MaterializeInc/agent-skills --skill mz-sql-navigation -a cursor2Вручную: положить файлы
.cursor/skills/mz-sql-navigation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install MaterializeInc/agent-skills plugins/mz-sql-lsp/skills/mz-sql-navigation2Вручную: положить файлы
.github/skills/mz-sql-navigation/SKILL.md1Через Skills CLI (Vercel)
npx skills add MaterializeInc/agent-skills --skill mz-sql-navigation -a gemini-cli2Командой платформы
gemini skills install https://github.com/MaterializeInc/agent-skills --path plugins/mz-sql-lsp/skills/mz-sql-navigationВручную: положить файлы
.devin/skills/mz-sql-navigation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add MaterializeInc/agent-skills --skill mz-sql-navigation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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