AIKraft/Skills/add-malli-schemas

add-malli-schemas

Добавляет схемы Malli в API-эндпоинты кодовой базы Metabase с соблюдением паттернов, таймингов валидации и обработки ошибок. Полезно при расширении функциональности API.

MEMetabase official Разработка ★ 49.6k

Что делает навык

Навык помогает эффективно и единообразно добавлять схемы Malli в API-эндпоинты кодовой базы Metabase, обеспечивая корректную валидацию параметров и обработку ошибок. Он решает задачу стандартизации описания входных и выходных данных для расширения функциональности API.

Когда применять

  • Добавление схем валидации для новых или существующих API-эндпоинтов в Metabase.
  • Определение структур запросов (route, query, body params) с использованием типов из namespace ms.
  • Создание именованных схем ответов (response schemas) для переиспользования и документирования.
  • Исправление ошибок валидации, связанных с неправильным типизацией полей или временных меток.

Как работает

  1. Проанализировать эндпоинт, определив параметры маршрута, запроса и тела, а также тип возвращаемого значения.
  2. Добавить схемы для параметров маршрута, запроса и тела, используя типы из metabase.util.malli.schema (ms) и свойства :optional/:default.
  3. Определить схему ответа: использовать inline-схему или создать именованную схему через mr/def для сложных или переиспользуемых структур.
  4. Убедиться, что для полей с временными метками в ответах используется :any (так как валидация происходит до сериализации в JSON), а не ms/TemporalString.
  5. Проверить корректность работы эндпоинта на валидных и невалидных запросах, убедившись в понятных сообщениях об ошибках.

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

Добавь схему 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 и совместимые) подхватывает его по описанию и следует шагам.