AI Agents

SKILL.md Portability Checker

Найти в SKILL.md Claude-специфичные поля, которые молча игнорируются другими агентами.

Как это работает

Базовое ядро формата SKILL.md — name, description, markdown-тело — работает во всех поддерживающих инструментах: Claude Code, Codex CLI, Cursor, Gemini CLI, GitHub Copilot. Но Claude Code добавляет собственные поля вроде context: fork, hooks и allowed-tools, которые официально безопасно игнорируются другими агентами — они не вызывают ошибку, но и не делают ничего. SKILL.md Portability Checker online проверяет, полагается ли ваша skill на такие поля, прежде чем публиковать её как универсальную для всей команды с разными инструментами.

Риск здесь не технический сбой, а тихая деградация: skill, написанная с расчётом на allowed-tools, ограничивающий доступные инструменты внутри Claude Code, в Codex CLI просто выполнится без этого ограничения — молча, без предупреждения, потому что поле формально валидно, просто не имеет смысла вне контекста Claude Code.

Инструмент разбирает frontmatter SKILL.md, ищет известные Claude-специфичные поля, и для каждого найденного объясняет конкретно, что произойдёт при использовании этой же skill в инструменте, который его не поддерживает — не как ошибка, а как явное предупреждение о разнице в реальном поведении между агентами.

Частые вопросы

Что означает "безопасно игнорируется" применительно к Claude-специфичным полям?

Это значит, что парсер другого агента не упадёт с ошибкой при встрече незнакомого поля во frontmatter, но и не выполнит связанную с ним логику — поле просто останется без эффекта, а не вызовет сбой обработки всей skill.

Какие поля считаются Claude-специфичными на середину 2026 года?

Наиболее частые примеры — context: fork (управление форком контекста выполнения), hooks (привязка к событиям жизненного цикла) и allowed-tools (ограничение доступных инструментов), список может расширяться по мере развития самого Claude Code.

Стоит ли вообще избегать Claude-специфичных полей ради максимальной переносимости?

Не обязательно — если skill предназначена только для команды, использующей исключительно Claude Code, эти поля дают реальную дополнительную функциональность, вопрос переносимости актуален именно для skills, которые команда планирует делиться между разными инструментами.

Проверяет ли инструмент работоспособность skill в конкретном другом агенте?

Нет, это статический анализ frontmatter на предмет известных несовместимых полей, а не реальный запуск skill в другом инструменте — окончательная проверка совместимости требует реального теста в целевом агенте.