Один skill для Codex, ChatGPT, Claude, Qwen и других ИИ

Короткий ответ

Переносите ядро процедуры: SKILL.md, справки, шаблоны, тесты и стоп-условия. Codex, Claude и Qwen имеют документированные каталоги. ChatGPT desktop поддерживает standalone skills, но прямой импорт готовой папки не описан.

В Gemini, GigaChat, Yandex AI Studio и DeepSeek используйте ручной адаптер. Проверяйте обязательные свойства результата, а не одинаковые слова.

Что значит «один skill работает везде»

У честной переносимости три уровня:

1. Смысловое ядро — цель, входы, шаги, проверки, запрещённые действия и формат результата.
2. Адаптер среды — куда положить папку или куда вставить инструкцию.
3. Тест контракта — что обязательно должно произойти независимо от модели и формулировок.

Если смешать эти уровни, возникает опасное обещание: «загрузите ZIP в любой ИИ — всё заработает одинаково».

На 2026-08-30 официальные документы этого не подтверждают. Поддержка Skills, пути, доступ к файлам и возможность запускать скрипты различаются.

Переносимо правило: «при несовпадающих периодах остановиться». Кнопка загрузки, путь каталога и формат вызова зависят от среды.

Один агент напишет «STOP», другой — «проверьте период». Инвариант соблюдён, если оба отказались строить вывод.

Архитектура переносимого ядра

Открытая Agent Skills Specification, проверенная 2026-08-30, требует только папку и SKILL.md. Для межагентной работы добавьте ручной адаптер и тесты:

weekly-marketing-review/
├── SKILL.md
├── UNIVERSAL_AGENT_PROMPT.md
├── references/
│   └── required-inputs.md
├── assets/
│   └── report-template.md
└── tests/
    └── contract.md

• SKILL.md — каноническая процедура для среды с нативной поддержкой skills.
• UNIVERSAL_AGENT_PROMPT.md — мост для продукта без подтверждённого загрузчика skill.
• references/ — определения входов и правила, которые нужны не всегда.
• assets/ — шаблон результата, который нужно копировать, а не пересказывать.
• tests/contract.md — одинаковые входы и ожидаемые свойства результата.

Не кладите в переносимый ZIP пароли, токены, клиентские выгрузки и внутренние URL с доступом. Пакет описывает способ работы; реальные данные и права подключаются отдельно в разрешённой среде.

Нативные маршруты, подтверждённые документацией

Нативный маршрут означает, что продукт распознаёт структуру skill и умеет подгружать её части. Простая загрузка текста как справки — это ручной адаптер.

Матрица описывает официальные способы на 2026-08-31. Это снимок, а не гарантия будущих версий.

Источники: OpenAI Build skills, Claude Platform Docs и Qwen Code Docs. OpenAI повторно проверен 2026-08-31.

Даже здесь «нативно» не означает «одинаково». Claude Code и claude.ai — разные поверхности. ChatGPT desktop и ChatGPT web тоже нельзя смешивать.

Область действия, инструменты и разрешения определяет среда, а не ZIP.

Ручной запасной способ (fallback)

Для Gemini, GigaChat, Yandex AI Studio и DeepSeek подтверждены инструкции, файлы или роли сообщений. Единая нативная установка папки SKILL.md в этих источниках не описана.

Если ChatGPT desktop Skills недоступны, Projects дают совместимый ручной режим через project instructions и reference files.

Официальные источники ручных адаптеров проверены 2026-08-30:

• ChatGPT Projects
• Gemini Gems
• GigaChat Playground
• Chat Completions — Yandex AI Studio
• DeepSeek Chat Completions

Конкретные лимиты и доступность функций зависят от продукта, аккаунта, региона и плана. Передавать можно только разрешённые компанией данные.

Универсальный prompt для ручного режима

Сохраните этот текст как UNIVERSAL_AGENT_PROMPT.md внутри skill:

## Ручной запуск skill-процедуры

В этой среде не предполагается нативный загрузчик Agent Skills.
Используй приложенный SKILL.md как каноническую рабочую процедуру.

Правила:
1. Сначала перечисли, какие файлы и инструкции ты прочитал.
2. Не заменяй отсутствующие входы догадками.
3. Выполняй шаги и стоп-условия из SKILL.md.
4. Если скрипт недоступен, не имитируй его результат: назови
   ограничение и предложи ручную проверку.
5. Не выполняй внешние действия без отдельного разрешения.
6. Используй шаблон из assets, если он передан.
7. В конце покажи: результат, пройденные проверки,
   незакрытые вопросы и действия, требующие человека.

Сначала кратко перескажи контракт результата и дождись моего
подтверждения. Затем выполни задачу.

Ручной маршрут состоит из четырёх действий:

1. Вставьте универсальный prompt в инструкции продукта или начало нового чата.
2. Передайте SKILL.md как файл. Если загрузки нет, вставьте его текст под отдельным заголовком.
3. Добавьте только нужные справки и шаблон. Скрипты не выдавайте за выполненные.
4. Попросите агента пересказать контракт и дождитесь подтверждения перед рабочим запросом.

Если интерфейс не принимает несколько файлов, объедините их в одно сообщение с явными заголовками.

Скрипты вручную не «переносятся»: их либо запускает разрешённая среда, либо заменяет отдельная проверка человеком.

Пример

Возьмём вымышленный российский интернет-магазин «Тёплый дом» и skill проверки недельного маркетингового отчёта. Это учебный сценарий, не реальный кейс.

В Codex, Claude и Qwen команда подключает одно ядро по документированному каталогу. В ChatGPT она использует доступный skill либо ручной маршрут Projects, не выдавая его за импорт папки.

В Gemini Gem, GigaChat, Yandex AI Studio или DeepSeek она передаёт universal prompt, SKILL.md, справку по колонкам и шаблон через доступные инструкции и контекст.

Тестовый вход одинаков: CRM и Метрика содержат период 17–23 августа, выгрузка расходов — 17–22 августа. Формулировки ответов могут различаться. Контракт успеха одинаков:

• обнаружено несовпадение периода;
• отчёт и объяснение динамики не построены;
• назван отсутствующий день или предложен общий период;
• не придуманы расходы;
• решение передано человеку.

Если четыре продукта выполняют эти условия, а пятый пишет более красивый, но выдуманный отчёт, пятый тест не прошёл. Сравнение длины, тона или «умности» ответа здесь не имеет значения.

Практика: проверьте переносимость

Создайте tests/contract.md с тремя сценариями:

Для каждого прогона запишите дату, продукт, способ подключения, инструменты, результат и ручные исправления.

Не называйте один запуск рейтингом модели. Цель теста — проверить перенос процедуры, а не выбрать «победителя».

Ограничения

• Native skill может автоматически находить ресурсы; ручной режим требует явно передать их.
• Скрипт, web-доступ или запись файла могут быть недоступны. Не подменяйте действие текстовым обещанием.
• Большой пакет может не поместиться в доступный контекст или лимит файлов. Передавайте только нужные материалы.
• Product instructions могут конфликтовать с ядром или иметь более высокий приоритет. Фиксируйте такие расхождения.
• Разные модели по-разному следуют длинным правилам. Держите критичные стоп-условия короткими и проверяйте их отдельно.
• Переносимость не отменяет политики данных, лицензии материалов и человеческую ответственность.

Что делать

1. Отделите канонический SKILL.md от продуктовых инструкций.
2. Добавьте UNIVERSAL_AGENT_PROMPT.md и три контрактных теста.
3. Установите папку только по официальному маршруту выбранной native-среды.
4. Для остальных продуктов передайте инструкции и нужные файлы вручную.
5. Прогоните один и тот же нормальный, стоп- и нерелевантный сценарий.
6. Исправляйте ядро, если нарушен общий инвариант; адаптер — если ошибка только в одной среде.
7. Запишите дату проверки и назначьте владельца следующего обновления.

FAQ

Можно ли загрузить один ZIP со skill в любой ИИ и получить одинаковый результат?

Нет. На 2026-08-30 официальная документация не подтверждает единый установщик для всех продуктов: поддержка Agent Skills, пути каталогов, доступ к файлам и возможность запускать скрипты различаются. Переносится смысловое ядро процедуры — цель, входы, шаги, проверки, стоп-условия и формат результата. Способ подключения и формат вызова каждый раз определяет среда, а область действия, инструменты и разрешения задаёт продукт, а не ZIP.

Куда класть папку skill в Codex, Claude Code и Qwen Code?

Codex читает каталог .agents/skills в проекте или в домашней папке пользователя; вызов идёт автоматически по description, через /skills или через $. Claude Code использует ~/.claude/skills или .claude/skills, а claude.ai отдельно принимает ZIP в Settings на поддерживаемых планах с code execution. Qwen Code использует ~/.qwen/skills или .qwen/skills и позволяет вызвать skill по имени. Данные официальной документации на 2026-08-31.

Можно ли импортировать готовую папку skill в ChatGPT?

ChatGPT desktop показывает standalone skills, созданные в проектах, и вызывает их через @ или автоматическое совпадение с description. Прямой импорт готовой папки или ZIP в desktop в официальной документации не описан, поэтому обещать его команде нельзя. Если Skills недоступны, работает совместимый ручной режим: универсальный prompt идёт в project instructions ChatGPT Projects, а разрешённые файлы ядра добавляются как reference files.

Что делать, если ИИ-продукт не читает папку skill?

Применяйте ручной адаптер. Ручной адаптер — это передача ядра через обычные инструкции и файлы среды: системную инструкцию, инструкции проекта, Gems или роли system и user в API. Порядок такой: вставьте универсальный prompt в инструкции продукта, передайте SKILL.md файлом или текстом, добавьте только нужные справки и шаблон, попросите агента пересказать контракт результата и дождитесь подтверждения. Подтверждённые блоки для этого есть у Gemini, GigaChat, Yandex AI Studio и DeepSeek.

Как проверить, что один skill одинаково работает в разных агентах?

Сравнивайте контракт результата, а не формулировки. Контракт результата — это набор обязательных свойств ответа, которые должны совпасть при одинаковом входе. Прогоните три сценария: нормальный, стоп-сценарий с файлами за разные периоды и нерелевантный запрос. Инвариант соблюдён, если агент назвал расхождение, не построил отчёт и не придумал недостающие данные, — неважно, каким словом он это оформил. Длина, тон и «умность» ответа в тесте не оцениваются.

Какие данные нельзя класть в переносимый пакет skill?

В переносимый пакет не должны попадать пароли, токены, клиентские выгрузки и внутренние URL с доступом. Пакет описывает только способ работы: процедуру, справки, шаблон результата и тесты. Реальные данные и права подключаются отдельно уже в разрешённой среде. Передавать в сторонний продукт можно лишь те материалы, которые разрешила компания: переносимость skill не отменяет политики данных, лицензии материалов и человеческую ответственность за результат.

Источники

• Agent Skills Specification — открытое ядро формата; проверено 2026-08-30.
• Build skills — OpenAI — ChatGPT/Codex Skills, вызов и текущие каталоги Codex; повторно проверено 2026-08-31.
• Agent Skills — Claude Platform Docs — Claude Code, claude.ai и API; проверено 2026-08-30.
• Agent Skills — Qwen Code Docs — пути и вызов Qwen; обновлено 2026-08-17, проверено 2026-08-30.
• Projects in ChatGPT — ручной fallback через instructions и files; проверено 2026-08-30.
• Gemini Gems — instructions и knowledge files; проверено 2026-08-30.
• GigaChat Playground — system instruction и files; проверено 2026-08-30.
• Chat Completions — Yandex AI Studio — system/developer/user messages; проверено 2026-08-30.
• DeepSeek Chat Completions — system/user messages; проверено 2026-08-30. Поддержка file parts для обычной chat-модели не заявляется.

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

Продолжить

• Раздел «ИИ без магии» — карта учебного маршрута.
• Предыдущий урок: Как создать первый skill.
• Обучение команды работе с ИИ — владелец, практика и общие правила.
• AI Integration Blueprint — внедрение в процесс.
• ИИ-агенты для бизнеса — инструменты, границы и контроль.