serialization · wshaddix — скилл для Claude Code: что делает и как установить
Скилл учит агента настраивать сериализацию в .NET под Native AOT: от генераторов кода System.Text.Json до Protobuf и MessagePack.
npx skills add wshaddix/dotnet-skills --skill serialization -a claude-codeЧто делает serialization
Скилл добавляет в контекст агента шаблоны и правила работы с текстовой и бинарной сериализацией в современном .NET. Ассистент быстрее подскажет, когда для межсервисного обмена подходит Google.Protobuf, а в каких сценариях выгоднее задействовать MessagePack.
Внутри собраны примеры настройки JsonSerializerContext, регистрации генераторов в Minimal API и контроллерах ASP.NET Core, а также синтаксис схем .proto. Здесь же детально описаны правила эволюции контрактов без нарушения обратной совместимости.
Библиотека Newtonsoft.Json использует рефлексию во время выполнения, поэтому сборка Native AOT с ней сломается. Скилл помогает сразу строить архитектуру на базе статических генераторов исходного кода.
Какие задачи решает
- перевести сериализацию с Newtonsoft.Json на генераторы кода System.Text.Json
- подготовить контракты передачи данных к компиляции в Native AOT
- настроить схемы Google.Protobuf и правила версионирования полей
- подключить сгенерированный JsonSerializerContext в ASP.NET Core
Примеры запросов агенту
- Сгенерируй контекст JsonSerializerContext для модели заказа с поддержкой полиморфизма оплаты
- Напиши proto-файл для сервиса заказов с резервированием удалённых номеров полей
- Настрой сериализацию в Minimal API через System.Text.Json без рантайм-рефлексии
Как установить serialization
1Через Skills CLI (Vercel)
npx skills add wshaddix/dotnet-skills --skill serialization -a claude-code2Вручную: положить файлы
~/.claude/skills/serialization/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/serialization/
1Через Skills CLI (Vercel)
npx skills add wshaddix/dotnet-skills --skill serialization -a codex2Вручную: положить файлы
.agents/skills/serialization/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wshaddix/dotnet-skills --skill serialization -a cursor2Вручную: положить файлы
.cursor/skills/serialization/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wshaddix/dotnet-skills serialization2Вручную: положить файлы
.github/skills/serialization/SKILL.md1Через Skills CLI (Vercel)
npx skills add wshaddix/dotnet-skills --skill serialization -a gemini-cli2Командой платформы
gemini skills install https://github.com/wshaddix/dotnet-skills --path skills/serializationВручную: положить файлы
.devin/skills/serialization/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wshaddix/dotnet-skills --skill serialization -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о serialization
Как установить serialization в Claude Code?
Выполните в терминале команду npx skills add wshaddix/dotnet-skills --skill serialization -a claude-code. Файлы скилла будут сохранены по пути ~/.claude/skills/serialization/SKILL.md.
Зачем нужен этот скилл?
Он помогает ИИ-ассистенту писать производительный код сериализации в .NET, подбирая подходящие форматы данных под требования Native AOT и распределённых систем.
Почему скилл рекомендует отказаться от Newtonsoft.Json?
Пакет Newtonsoft.Json опирается на динамическую рефлексию и не подходит для Native AOT. Внедрение имён типов в полезную нагрузку приводит к ошибкам при рефакторинге.
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — serialization от других авторов.
