skill-host-compat
Проверяет фронтматтер ECC-навыков на совместимость с Codex/Cursor и корректность подстановок для Claude перед отправкой PR. Полезно для валидации изменений в репозитории affaan-m/ecc.
Что делает навык
Skill проверяет фронтматтер и содержимое ECC-навыков на совместимость с Codex и Cursor, выявляя несанкционированные подстановки переменных Claude перед отправкой PR. Он обеспечивает корректность копирования навыков в директории .agents/skills/ и .cursor/skills/, исключая использование специфичных для Claude переменных в проекциях для других хостов.
Когда применять
- Проверка совместимости нового или измененного навыка в директории skills/ перед созданием Pull Request.
- Валидация копий навыков, скопированных в .agents/skills/ для Codex или .cursor/skills/ для Cursor.
- Ответ на вопросы ревьюера о безопасности установки навыка в Codex или Cursor.
- Исследование результатов проверки CI validate-skill-host-compat.js для устранения предупреждений.
Как работает
- Запустить скрипт validate-skill-host-compat.js из корня репозитория для проверки всех навыков.
- Использовать флаг --inventory для вывода статистики предупреждений без прерывания работы.
- Применить флаг --strict-checklist для повышения уровня предупреждений чеклиста CONTRIBUTING до ошибок.
- Проверить, что в исполняемых блоках bash/sh/zsh для Codex/Cursor отсутствуют переменные ${CLAUDE_SESSION_ID}, ${CLAUDE_SKILL_DIR}, ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PROJECT_DIR} и $ARGUMENTS.
- Убедиться, что в копиях для Codex (в .agents/skills/) удалены поля origin, version и argument-hint, а переменная ${CLAUDE_PROJECT_DIR} заменена на $(pwd) или явный путь.
- Сверить, что имя навыка в agents/openai.yaml совпадает с именем директории в .agents/skills/.
Примеры запросов агенту
Что понадобится
- Node.js (для запуска скриптов node scripts/ci/validate-skill-host-compat.js)
- Репозиторий affaan-m/ecc с доступом к директориям skills/, .agents/skills/, .cursor/skills/ и скриптам CI
Описание составлено по SKILL.md навыка, сверено 19.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.