ME
add-malli-schemas
Добавляет схемы Malli в API-эндпоинты кодовой базы Metabase с соблюдением паттернов, таймингов валидации и обработки ошибок. Полезно при расширении функциональности API.
Что делает навык
Навык помогает эффективно и единообразно добавлять схемы Malli в API-эндпоинты кодовой базы Metabase, обеспечивая корректную валидацию параметров и обработку ошибок. Он решает задачу стандартизации описания входных и выходных данных для расширения функциональности API.
Когда применять
- Добавление схем валидации для новых или существующих API-эндпоинтов в Metabase.
- Определение структур запросов (route, query, body params) с использованием типов из namespace ms.
- Создание именованных схем ответов (response schemas) для переиспользования и документирования.
- Исправление ошибок валидации, связанных с неправильным типизацией полей или временных меток.
Как работает
- Проанализировать эндпоинт, определив параметры маршрута, запроса и тела, а также тип возвращаемого значения.
- Добавить схемы для параметров маршрута, запроса и тела, используя типы из metabase.util.malli.schema (ms) и свойства :optional/:default.
- Определить схему ответа: использовать inline-схему или создать именованную схему через mr/def для сложных или переиспользуемых структур.
- Убедиться, что для полей с временными метками в ответах используется :any (так как валидация происходит до сериализации в JSON), а не ms/TemporalString.
- Проверить корректность работы эндпоинта на валидных и невалидных запросах, убедившись в понятных сообщениях об ошибках.
Примеры запросов агенту
Добавь схему Malli для эндпоинта GET /api/field/:id/related, используя именованную схему для возвращаемых сущностей.
Оформи параметры запроса для POST /api/resource так, чтобы поле name было обязательным, а description — опциональным с использованием ms/NonBlankString.
Исправь схему ответа для эндпоинта, где есть поле с датой: замени ms/TemporalString на :any, так как валидация происходит до JSON-сериализации.
Что понадобится
- Доступ к кодовой базе Metabase, в частности к файлам в src/metabase/warehouses/api.clj, src/metabase/api_keys/api.clj и другим референсным файлам.
- Знание структуры namespace metabase.util.malli.schema (ms) и макросов api.macros/defendpoint.
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «add-malli-schemas» из репозитория:
# https://github.com/metabase/metabase
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r add-malli-schemas/ ~/.claude/skills/add-malli-schemas/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.