luau-type-expert — скилл для Claude Code: типы Luau в strict-режиме
Скилл luau-type-expert разбирает ошибки типов Luau и доводит файл до --!strict: генерики, union-типы, сужение через type(), касты ::.
лицензия не указана 308 установок ★ 5 обновлён 2026-10-01
npx skills add dig1t/skills --skill luau-type-expert -a claude-codeЧто делает luau-type-expert
Скилл подключается, когда luau-lsp или luau-analyze ругается на типы, и ведёт от сообщения об ошибке к рабочей аннотации. Внутри — разбор трёх режимов файла (--!nocheck, --!nonstrict, --!strict), синтаксис аннотаций, генерики с ограничениями, union-типы и сужение через type(), typeof() и проверки на истинность. Рядом лежат справочники references/api_reference.md, common-errors.md, performance.md и lint-rules.md: таблица частых ошибок вроде «Type X could not be converted into Y» и 28 правил линтера.
Для кода на метатаблицах скилл показывает, как описать __index, конструктор и методы, чтобы setmetatable не превращал объект в any. Настройка .luaurc тоже разобрана: languageMode, алиасы путей вида @shared и переключатели правил линта.
Каст :: проходит только когда один операнд — подтип другого либо any; иначе ошибка останется на месте. Разбор проекта из консоли идёт через luau-lsp analyze, а в Roblox-проекте нужен --sourcemap=sourcemap.json, без него дерево инстансов не сопоставится.
Какие задачи решает
- Убрать ошибку «Type X could not be converted into Y» в модуле
- Перевести существующий файл на
--!strictбез каскада новых ошибок - Типизировать класс на метатаблицах: конструктор, методы,
__index - Настроить
.luaurc: алиасы путей и правила линта - Подключить
.d.luauс глобалами дляluau-lsp analyze
Примеры запросов агенту
- Почему
luau-lspругается на тип вInventory.luauи как это исправить? - Переведи
PlayerData.luauна--!strictи объясни каждое исправление - Опиши тип класса
Vector2с метатаблицей, чтобыsetmetatableне терял тип
Как установить luau-type-expert
1Через Skills CLI (Vercel)
npx skills add dig1t/skills --skill luau-type-expert -a claude-code2Вручную: положить файлы
~/.claude/skills/luau-type-expert/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/luau-type-expert/
1Через Skills CLI (Vercel)
npx skills add dig1t/skills --skill luau-type-expert -a codex2Вручную: положить файлы
.agents/skills/luau-type-expert/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dig1t/skills --skill luau-type-expert -a cursor2Вручную: положить файлы
.cursor/skills/luau-type-expert/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dig1t/skills luau-type-expert2Вручную: положить файлы
.github/skills/luau-type-expert/SKILL.md1Через Skills CLI (Vercel)
npx skills add dig1t/skills --skill luau-type-expert -a gemini-cli2Командой платформы
gemini skills install https://github.com/dig1t/skills --path luau-type-expertВручную: положить файлы
.devin/skills/luau-type-expert/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dig1t/skills --skill luau-type-expert -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о luau-type-expert
Как установить luau-type-expert в Claude Code?
Выполните npx skills add dig1t/skills --skill luau-type-expert -a claude-code. Файл скилла окажется по пути ~/.claude/skills/luau-type-expert/SKILL.md.
Что делает luau-type-expert?
Помогает писать аннотации типов в Luau и разбирает ошибки проверки: генерики, union-типы, сужение в условиях, касты, типизированные метатаблицы, файлы .d.luau и конфиг .luaurc.
Почему каст :: не убирает ошибку?
Каст принимается, только если один операнд — подтип другого либо any. Если типы не связаны, сообщение останется, и придётся править саму аннотацию.