add-malli-schemas — скилл для Claude Code: Malli-схемы
Скилл добавляет Malli-схемы к API-эндпоинтам Metabase: для параметров маршрута, query, тела запроса и ответа. Пригодится при изменении Clojure API.
npx skills add metabase/metabase --skill add-malli-schemas -a claude-codeЧто делает add-malli-schemas
Скилл подсказывает, как описывать входы и ответы API-эндпоинтов в кодовой базе Metabase. Он охватывает параметры маршрута, query-параметры с :optional true и :default, тело для POST/PUT и схему ответа после строки маршрута. Для повторного использования предлагает именованные схемы и типы из metabase.util.malli.schema, подключённые как ms.
Внутри есть чек-лист и примеры для src/metabase/warehouses_rest/api.clj, src/metabase/api_keys/api.clj, src/metabase/collections_rest/api.clj и src/metabase/timeline/api/timeline.clj. Скилл также разбирает контекстные сообщения об ошибках и советует не брать raw request без необходимости.
У временных полей есть важное различие: в схемах запроса подходит ms/TemporalString, а в схемах ответа нужен :any, потому что ответ проверяется до JSON-сериализации и содержит объекты Java Time. Это ограничение влияет на выбор схемы для response.
Какие задачи решает
- описать параметры маршрута API-эндпоинта
- задать необязательные query-параметры и значения по умолчанию
- проверить тело POST/PUT-запроса схемой Malli
- определить схему ответа эндпоинта
- добавить сообщения об ошибках валидации
Примеры запросов агенту
- Добавь Malli-схемы к изменяемому API-эндпоинту в Metabase и проверь параметры маршрута, query, тело запроса и ответ.
- Подбери подходящие типы из
msдля этого эндпоинта и создай именованную схему, если структура ответа повторяется. - Проверь временные поля: используй
ms/TemporalStringдля запроса и:anyдля ответа до JSON-сериализации.
Как установить add-malli-schemas
1Через Skills CLI (Vercel)
npx skills add metabase/metabase --skill add-malli-schemas -a claude-code2Вручную: положить файлы
~/.claude/skills/add-malli-schemas/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/add-malli-schemas/
1Через Skills CLI (Vercel)
npx skills add metabase/metabase --skill add-malli-schemas -a codex2Вручную: положить файлы
.agents/skills/add-malli-schemas/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add metabase/metabase --skill add-malli-schemas -a cursor2Вручную: положить файлы
.cursor/skills/add-malli-schemas/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install metabase/metabase add-malli-schemas2Вручную: положить файлы
.github/skills/add-malli-schemas/SKILL.md1Через Skills CLI (Vercel)
npx skills add metabase/metabase --skill add-malli-schemas -a gemini-cli2Командой платформы
gemini skills install https://github.com/metabase/metabase --path .claude/skills/add-malli-schemasВручную: положить файлы
.devin/skills/add-malli-schemas/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add metabase/metabase --skill add-malli-schemas -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о add-malli-schemas
Как установить add-malli-schemas в Claude Code?
Выполните npx skills add metabase/metabase --skill add-malli-schemas -a claude-code, затем используйте файл ~/.claude/skills/add-malli-schemas/SKILL.md.
Что делает add-malli-schemas?
Скилл помогает добавлять Malli-схемы к API-эндпоинтам Metabase. Он охватывает параметры маршрута, query, тело запроса, ответы и обработку ошибок валидации.
Как описывать временные поля в Malli-схемах?
Для параметров запроса используется ms/TemporalString. В схеме ответа нужен :any, потому что проверка происходит до JSON-сериализации Java Time объектов.
