503-frameworks-micronaut-validation — скилл для Claude Code
Скилл 503-frameworks-micronaut-validation настраивает правила Bean Validation в REST API на Micronaut и маппит ошибки в ответы HTTP 400.
Apache-2.0 280 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 503-frameworks-micronaut-validation -a claude-codeЧто делает 503-frameworks-micronaut-validation
Скилл внедряет практики валидации данных на границах Micronaut-приложений. Он охватывает аннотации Bean Validation для DTO и командных моделей, применение связок @Valid и @Validated в методах @Controller, валидацию параметров пути и query, а также проверку полей @ConfigurationProperties.
В инструкциях заложен жёсткий рабочий процесс с проверкой сборки через Maven. Перед внесением правок агент обязан выполнить ./mvnw compile или mvn compile. Если компиляция падает, процесс немедленно останавливается до устранения ошибок. После применения изменений запускается ./mvnw clean verify для итогового подтверждения сборки.
Работа скилла завязана на справочник references/503-frameworks-micronaut-validation.md, поэтому для полной отдачи эти файлы с примерами должны быть доступны в репозитории проекта.
Какие задачи решает
- настроить Bean Validation для входящих DTO и параметров контроллера
- проверить свойства конфигурации в классах @ConfigurationProperties
- написать кастомные валидаторы и группы валидации для Micronaut
- связать исключения нарушений ограничений с ответами со статусом 400
Примеры запросов агенту
- Проверь правила валидации в контроллерах Micronaut и настрой маппинг ошибок в 400
- Добавь валидацию для класса @ConfigurationProperties в нашем Micronaut-сервисе
- Напиши кастомное ограничение валидации для входящего DTO
Как установить 503-frameworks-micronaut-validation
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 503-frameworks-micronaut-validation -a claude-code2Вручную: положить файлы
~/.claude/skills/503-frameworks-micronaut-validation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/503-frameworks-micronaut-validation/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 503-frameworks-micronaut-validation -a codex2Вручную: положить файлы
.agents/skills/503-frameworks-micronaut-validation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 503-frameworks-micronaut-validation -a cursor2Вручную: положить файлы
.cursor/skills/503-frameworks-micronaut-validation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/503-frameworks-micronaut-validation2Вручную: положить файлы
.github/skills/503-frameworks-micronaut-validation/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 503-frameworks-micronaut-validation -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/503-frameworks-micronaut-validationВручную: положить файлы
.devin/skills/503-frameworks-micronaut-validation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 503-frameworks-micronaut-validation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 503-frameworks-micronaut-validation
Как установить 503-frameworks-micronaut-validation в Claude Code?
Выполните в терминале команду npx skills add jabrena/plinth --skill 503-frameworks-micronaut-validation -a claude-code.
Что делает этот скилл?
Он направляет ИИ-агента при настройке, ревью и улучшении валидации параметров запросов, DTO и конфигурационных свойств в Micronaut.
Какие проверки запускаются при работе скилла?
Обязательным шагом до правок является вызов ./mvnw compile (или mvn compile), а после изменений — ./mvnw clean verify.
Исходный текст
SKILL.md · Apache-2.0
--- name: 503-frameworks-micronaut-validation description: Use when you need to design, review, or improve validation in Micronaut applications — including Bean Validation on @Controller methods, @Body @Valid, query/path parameter validation, @ConfigurationProperties validation, custom constraints, nested DTO validation, and ExceptionHandler mapping for constraint violations. This should trigger for requests such as Add validation support in Micronaut; Review Micronaut validation rules; Improve request validation in Micronaut REST APIs; Add custom validation constraints in Micronaut; Validate Micronaut configuration properties. Part of Plinth Toolkit license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.19.0 --- # Micronaut Validation Guidelines Apply Micronaut validation best practices at HTTP API boundaries. **What is covered in this Skill?** - Bean Validation annotations on DTOs and command models - @Valid / @Validated usage in Micronaut controllers - Validation groups and custom validators - Consistent mapping of validation failures to 400 responses - Safe and predictable validation error payloads **Scope:** Apply recommendations based on the reference rules and good/bad examples. ## Constraints Before applying validation changes, ensure the project compiles. After improvements, run full verification. - **MANDATORY**: Run `./mvnw compile` or `mvn compile` before applying any change - **SAFETY**: If compilation fails, stop immediately - **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements - **BEFORE APPLYING**: Read the reference for detailed rules and examples ## When to use this skill - Add validation support in Micronaut - Review Micronaut validation rules - Improve request validation in Micronaut REST APIs - Add custom validation constraints in Micronaut - Validate Micronaut configuration properties - Improve constraint violation handling in Micronaut ## Workflow 1. **Read reference and assess project context** Read `references/503-frameworks-micronaut-validation.md` and inspect the current project setup before proposing changes. 2. **Gather scope and decide target improvements** Identify requested outcomes, constraints, and the minimum safe set of changes to apply. 3. **Apply framework-aligned changes** Implement or refactor validation-related configuration/code following the reference patterns and project conventions. 4. **Run verification and report results** Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions. ## Reference For detailed guidance, examples, and constraints, see [references/503-frameworks-micronaut-validation.md](references/503-frameworks-micronaut-validation.md).
© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth