makepad-2.0-troubleshooting — скилл для Claude Code
Скилл для разбора типичных ошибок Makepad 2.0 и языка Splash: невидимый интерфейс, пропавший текст, сломанный горячий перезапуск. Пригодится, когда UI собрался, но выглядит не так, как ждёшь.
npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-troubleshooting -a claude-codeЧто делает makepad-2.0-troubleshooting
Скилл разбирает повторяющиеся грабли Makepad 2.0. Для каждой ошибки даётся три части: что видно на экране, почему так вышло и как переписать код. Список открывают нулевая высота контейнера (интерфейс просто не появляется) и текст, который прячется за фоном.
Внутри разобраны свойства Splash, на которых легко обжечься: := для именованных детей против : для статических, префикс #x для hex-цветов с буквой e, border_radius, которому нужен f32. Отдельно сказано, что именованный ребёнок недостижим, если хоть один контейнер на пути к нему остался безымянным. Именно на этом ломается переопределение свойств в шаблоне: строка Card{title.text: …} молча игнорируется, и остаётся значение по умолчанию.
Скилл опирается на справочники AGENTS.md и splash.md. Правило про height: Fit работает иначе внутри родителя с фиксированной высотой: там height: Fill корректен, потому что высота уже задана.
Какие задачи решает
- найти, почему контейнер схлопнулся в нулевую высоту
- вернуть текст, пропавший на цветном фоне
- починить переопределение свойств у именованного ребёнка
- разобрать ошибку парсинга hex-цвета с буквой
e - понять, какого типа
border_radiusждёт от тебя
Примеры запросов агенту
- Интерфейс на Makepad не показывается совсем — разбери, где высота ушла в ноль
- Текст на
RoundedViewне виден, хотяdraw_text.colorзадан — что не так с батчингом? - Переопределяю
title.textу шаблонаCard, а показывается дефолт. Почему?
Как установить makepad-2.0-troubleshooting
1Через Skills CLI (Vercel)
npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-troubleshooting -a claude-code2Вручную: положить файлы
~/.claude/skills/makepad-2.0-troubleshooting/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/makepad-2.0-troubleshooting/
1Через Skills CLI (Vercel)
npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-troubleshooting -a codex2Вручную: положить файлы
.agents/skills/makepad-2.0-troubleshooting/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-troubleshooting -a cursor2Вручную: положить файлы
.cursor/skills/makepad-2.0-troubleshooting/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ZhangHanDong/makepad-skills makepad-2.0-troubleshooting2Вручную: положить файлы
.github/skills/makepad-2.0-troubleshooting/SKILL.md1Через Skills CLI (Vercel)
npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-troubleshooting -a gemini-cli2Командой платформы
gemini skills install https://github.com/ZhangHanDong/makepad-skills --path skills/makepad-2.0-troubleshootingВручную: положить файлы
.devin/skills/makepad-2.0-troubleshooting/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-troubleshooting -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о makepad-2.0-troubleshooting
Как установить makepad-2.0-troubleshooting в Claude Code?
Выполните npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-troubleshooting -a claude-code. Файл скилла окажется в ~/.claude/skills/makepad-2.0-troubleshooting/SKILL.md.
Что делает makepad-2.0-troubleshooting?
Собирает частые ошибки Makepad 2.0 и Splash в разборы по схеме «симптом, причина, исправление», чтобы агент сразу предлагал рабочую правку вместо догадок.
Почему переопределение свойства дочернего виджета не срабатывает?
Скорее всего ребёнок объявлен через :, а не :=. Второй вариант делает его именованным и доступным по пути, но все контейнеры на этом пути тоже должны быть именованными.