Orkas Orkas
Главная Блог Скиллы в Codex и OpenCode
Продукт

Как использовать один набор скиллов в Claude Code, Codex и OpenCode

Все три загружают один и тот же формат SKILL.md, но ищут его в разных папках. Здесь — где ищет каждый инструмент, как держать одну копию, которую загружают все три, что не переносится из Claude Code и как Orkas даёт одни и те же скиллы каждому CLI, который запускает.

Claude Code, Codex и OpenCode загружают скиллы в одном и том же формате: папка, внутри которой лежит файл SKILL.md. Этот формат — открытый стандарт Agent Skills, который создала Anthropic и который 4 ноября 2026 года стал проектом Linux Foundation. Значит, один скилл может работать во всех трёх инструментах. Подвох в том, что каждый инструмент ищет скиллы в своих папках, а некоторые поля понимает только Claude Code. В этом руководстве — где ищет каждый инструмент, как держать одну копию, которую загружают все три, что не переносится и как Orkas даёт одни и те же скиллы каждому агенту для программирования, который он запускает.

Коротко: храните каждую папку скилла в ~/.agents/skills. Codex и OpenCode уже читают эту папку. Claude Code — нет, поэтому добавьте ссылку на каждый скилл в ~/.claude/skills. Оставьте во frontmatter только name и description и называйте каждый скилл так же, как его папку. Проверено 8 ноября 2026 года на Claude Code 2.1.319, Codex 0.167.0 и OpenCode 2.2.6.

Где Claude Code, Codex и OpenCode ищут скиллы

ПапкаClaude CodeCodexOpenCode
~/.agents/skillsНетДаДа
.agents/skills в проектеНетДаДа
~/.claude/skillsДаНетДа
.claude/skills в проектеДаНетДа
~/.codex/skillsНетДа, но устарелаНет
~/.config/opencode/skills, .opencode/skillsНетНетДа
Как вызвать скилл/skill-name$skill-name или /skills@skill-name

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

  • Claude Code — единственный, кто не найдёт .agents/skills. В его документации по скиллам перечислены только папки .claude, а в документации по памяти сказано, что он не читает «ничего внутри каталога .agents/». Запрос на изменение, issue #31005, всё ещё открыт и набрал больше 450 голосов.
  • Codex перешёл на .agents/skills. В его документации указаны .agents/skills в проекте, ~/.agents/skills для вас и /etc/codex/skills для администраторов. Старая папка ~/.codex/skills помечена в исходном коде как устаревшая, но по-прежнему загружается. Ни одну папку .claude Codex не читает.
  • OpenCode читает всё. В его документации перечислены собственные папки, а также .claude/skills и .agents/skills на обоих уровнях. Это верно и для ветки 2.2, и для ветки 1.19, у которой всё ещё выходят релизы.

Настройте одну общую папку

Сделайте ~/.agents/skills единственной настоящей копией. Codex и OpenCode читают её без всякой настройки, а npx skills и импортёр Codex пишут именно туда. Claude Code затем получает ссылку на каждый скилл.

  1. Перенесите скиллы в ~/.agents/skills. Перенесите папку каждого скилла, который вы написали в ~/.claude/skills или ~/.codex/skills, например mv ~/.claude/skills/release-notes ~/.agents/skills/. Не трогайте ~/.claude/skills/synced: там Claude Code хранит скиллы из вашего аккаунта claude.ai.
  2. Сделайте ссылку на каждый скилл в папке Claude Code. На macOS или Linux выполните этот скрипт. Он пропускает скиллы, для которых там уже есть папка или ссылка.
mkdir -p ~/.agents/skills ~/.claude/skills
for d in ~/.agents/skills/*/; do
  n=$(basename "$d")
  [ -e ~/.claude/skills/"$n" ] || ln -s ~/.agents/skills/"$n" ~/.claude/skills/"$n"
done
  1. В Windows используйте junction-ссылки. Для них не нужны права администратора. В PowerShell:
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Get-ChildItem "$HOME\.agents\skills" -Directory | ForEach-Object {
  $link = "$HOME\.claude\skills\$($_.Name)"
  if (-not (Test-Path $link)) { New-Item -ItemType Junction -Path $link -Target $_.FullName | Out-Null }
}
  1. Проверьте каждый инструмент. Откройте новую сессию. В Claude Code введите / и найдите скилл. В Codex выполните /skills. В OpenCode введите @.

Для проекта, общего для команды, сделайте то же самое внутри репозитория: храните скиллы в .agents/skills и сделайте ссылку на каждый из .claude/skills с относительным путём, например ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.

На что обратить внимание:

  • Делайте ссылку на каждый скилл, а не на всю папку. Если сама ~/.claude/skills указывает на ~/.agents/skills, папки Claude Code synced и .trash окажутся в общей папке, и Codex с OpenCode могут загрузить ещё и синхронизированные скиллы. Цена такого подхода: после добавления скилла цикл нужно запускать снова.
  • Делайте ссылки на папки, а не на файлы SKILL.md. Codex переходит по ссылке на папку скилла, но игнорирует SKILL.md, который сам является ссылкой. OpenAI закрыла этот запрос со статусом «не планируется».
  • Не коммитьте ссылки, если в команде есть пользователи Windows. Git for Windows по умолчанию извлекает ссылки как маленькие текстовые файлы. Создавайте ссылки скриптом настройки или коммитьте настоящие копии.
  • OpenCode видит каждый скилл дважды и оставляет один. Он читает и ссылку в ~/.claude/skills, и папку в ~/.agents/skills. Версия 2.2 молча объединяет их. Версия 1.19 пишет в лог предупреждение о дубликате; задайте OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1, чтобы OpenCode перестал читать папки Claude.

Как написать скилл, который загрузят все три

Этот SKILL.md одинаково загружается в Claude Code, Codex и OpenCode. Он лежит в ~/.agents/skills/release-notes/SKILL.md, а рядом — папки references и scripts.

---
name: release-notes
description: "Drafts release notes from git commits since the last tag. Use when the user asks for a changelog, release notes, or what changed since the last release."
license: MIT
---

# Заметки о выпуске

1. Найти последний тег: git describe --tags --abbrev=0
2. Вывести коммиты после него: git log <tag>..HEAD --oneline --no-merges
3. Разбить коммиты на Added, Changed и Fixed по references/format.md из папки этого скилла.
4. Чтобы сохранить файл, запустить scripts/write_notes.sh из папки этого скилла.
  • Называйте скилл так же, как его папку. Используйте строчные буквы, цифры и дефисы, не больше 64 символов. Codex ориентируется на name, OpenCode 2.2 — на имя папки, а Claude Code принимает и то и другое. Если они различаются, один и тот же скилл в разных инструментах вызывается под разными именами. Codex пропускает скилл, имя которого длиннее 64 символов.
  • Держите описание короче 1024 символов и ставьте в начало слова, которыми будут пользоваться люди. Это ограничение стандарта, и Codex обрезает более длинные описания до этой длины в своём списке скиллов.
  • Берите в кавычки любое значение, в котором есть двоеточие с пробелом после него. Иначе frontmatter может не разобраться. Codex исправляет большинство таких случаев, Claude Code загружает скилл так, будто frontmatter нет, а OpenCode может пропустить скилл без ошибки.
  • Пусть скрипты сами находят свою папку. Инструменты выполняют команды из папки вашего проекта, а не из папки скилла. Скрипт, который начинается с cd "$(dirname "$0")", работает откуда угодно.
  • Не используйте «claude» в имени, если, возможно, будете загружать скилл в claude.ai или Claude API. Оба отклоняют имена, содержащие «claude» или «anthropic».

Что не переносится из Claude Code

Codex читает только name, description и короткое описание в metadata. OpenCode 2.2 также читает metadata и disable-model-invocation. Все остальные поля оба игнорируют без ошибки, поэтому скилл из Claude Code загружается, но ведёт себя иначе.

В скилле Claude CodeClaude CodeCodexOpenCode 2.2
allowed-toolsРаботаетИгнорируетсяИгнорируется
disable-model-invocation: trueРаботаетИгнорируется; используйте agents/openai.yamlРаботает
context: fork, agent, model, hooks, argument-hintРаботаютИгнорируютсяИгнорируются
$ARGUMENTS и $1 в текстеЗаменяются вашими аргументамиОстаются текстомОстаются текстом
!`command` в текстеВыполняется до того, как Claude прочтёт скиллОстаётся текстомОстаётся текстом
${CLAUDE_SKILL_DIR}Заменяется папкой скиллаОстаётся текстомОстаётся текстом
  • Пишите шаги, которые работают без этих возможностей. Пишите «запусти scripts/check.sh из папки этого скилла» вместо ${CLAUDE_SKILL_DIR} и просите недостающие данные простыми словами вместо $ARGUMENTS. Claude Code так же хорошо выполняет эти инструкции.
  • Чтобы Codex не вызывал скилл сам, добавьте в папку скилла agents/openai.yaml с allow_implicit_invocation: false в разделе policy. Вызвать его через $skill-name по-прежнему можно.
  • allowed-tools не ограничивает то, что могут делать Codex и OpenCode. В таблице совместимости npx skills это поле указано как поддерживаемое в обоих, но загрузчик скиллов ни одного из них его не читает. Задавайте ограничения в собственных настройках разрешений каждого инструмента.

Инструменты, которые ставят скиллы сразу в несколько агентов

ИнструментКак он делится скилламиНа что смотреть
npx skills (Vercel, 38 500 звёзд)Копирует скилл в .agents/skills и ссылками подключает к нему папку каждого агента. В Windows использует junction. --copy создаёт отдельные копии.Та же схема, что в этом руководстве. Выполните npx skills add owner/repo, а с -g — для папки пользователя.
skillshare (2 900 звёзд)Хранит одну исходную папку и ссылками подключает её в папку каждого инструмента; в Windows — через junction.Обновлён 6 ноября 2026 года. Устанавливается через Homebrew или shell-скрипт.
Codex /importКопирует скиллы из .claude/skills в .agents/skills.Копии со временем расходятся с оригиналами. Кроме того, он меняет «claude» на «Codex» в тексте, в том числе внутри путей к файлам (открытый issue #40147).
openskills (10 800 звёзд)Копирует скиллы в .claude/skills и перечисляет их в AGENTS.md.Нет релизов с января 2026 года. Опция --universal пишет в .agent/skills, который не читает ни один из трёх инструментов.

А что с CLAUDE.md и AGENTS.md?

Codex и OpenCode читают AGENTS.md, а OpenCode переходит на CLAUDE.md, если в проекте нет AGENTS.md. Начиная с версии 2.1.277 Claude Code тоже читает AGENTS.md, но только в проекте, где нет CLAUDE.md или CLAUDE.local.md. Если вы держите оба файла, откройте /config в Claude Code и настройте Project instructions так, чтобы загружались оба. Правила, которым должен следовать каждый агент, кладите в AGENTS.md, а CLAUDE.md оставьте для того, что нужно только Claude Code.

Те же скиллы в Orkas

Orkas — десктопное приложение, которое запускает Claude Code, Codex, OpenCode, OpenClaw и Hermes как агентов в одном чате. Оно использует копии, установленные на вашем компьютере, и ваши собственные входы в аккаунты. Вот как ваши скиллы попадают к этим агентам.

  • Общая папка продолжает работать. Каждый CLI по-прежнему читает свои папки скиллов, когда его запускает Orkas, поэтому описанная выше схема работает без изменений. Orkas добавляет свой MCP-сервер рядом с вашими, а не заменяет их.
  • Скиллы, добавленные в Orkas, доступны каждому CLI. Каждый CLI, который запускает Orkas, получает MCP-сервер с именем orkas. Он выдаёт список ваших скиллов Orkas, загружает нужный, когда он подходит к задаче, и запускает скрипты, которые идут со скиллом. Попросите Claude Code использовать скилл по имени или дайте ему самому найти подходящий.
  • Orkas читает и ваши скиллы Claude Code и Codex. Скиллы из ~/.claude/skills и ~/.codex/skills появляются в разделе Навыки ▸ Общие папки, и Командир может использовать их в своих задачах. Orkas только читает эти папки и никогда их не меняет. Папку ~/.agents/skills он напрямую не читает, поэтому при описанной выше схеме находит ваши скиллы через ссылки в ~/.claude/skills.

Чтобы добавить пакет скиллов с GitHub, вставьте ссылку на репозиторий в чат с Командиром и попросите его установить пакет. Если пакету нужно установить зависимости, Orkas сначала спросит вас. Скиллы появятся в разделе Навыки ▸ Внешние пакеты. После этого Claude Code, Codex и OpenCode смогут их использовать, когда вы запускаете их из Orkas, и ничего не придётся копировать в три папки. Для начала выберите Подключить агентов на боковой панели и отметьте установленные у вас CLI. Подробно о том, как запускать два из них рядом, — в статье Как запускать Claude Code и Codex вместе.

Запускайте из Orkas Дайте Claude Code, Codex и OpenCode одни и те же скиллы из одного приложения. Orkas бесплатен для macOS и Windows. Он запускает CLI, которые у вас уже есть, с вашими собственными входами в аккаунты.
Скачать Orkas — бесплатно

Какую схему выбрать?

Ваша ситуацияЧто делать
Вы пользуетесь двумя или тремя из этих инструментов на одном компьютереХраните скиллы в ~/.agents/skills и сделайте ссылку на каждый в ~/.claude/skills
Команда делится скиллами в репозиторииЗакоммитьте .agents/skills; создавайте ссылки в .claude/skills скриптом настройки
Вы часто ставите скиллы с GitHubnpx skills add — он создаёт те же ссылки за вас
Вы пользуетесь только Claude Code и OpenCodeПродолжайте использовать ~/.claude/skills; OpenCode уже читает эту папку
Вы запускаете CLI из OrkasУстановите пакеты скиллов один раз в Orkas; их сможет использовать каждый CLI, который он запускает

Вопросы

Можно ли использовать скиллы Claude в Codex?

Да. Codex читает тот же формат SKILL.md, но ищет в ~/.agents/skills и .agents/skills, а не в ~/.claude/skills. Перенесите туда папки скиллов и сделайте на них обратные ссылки для Claude Code или выполните /import в Codex, чтобы их скопировать. Поля вроде allowed-tools и возможности вроде $ARGUMENTS работают только в Claude Code.

Читает ли OpenCode скиллы Claude Code?

Да. OpenCode читает ~/.claude/skills и .claude/skills, а также ~/.agents/skills и свои папки, поэтому скиллы Claude Code появляются без всякой настройки. Чтобы это отключить, задайте OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.

Читает ли Claude Code .agents/skills?

Нет. На ноябрь 2026 года Claude Code читает скиллы только из папок .claude, а в его документации сказано, что он игнорирует всё внутри каталога .agents. Запрос на добавление, issue #31005, всё ещё открыт. А пока делайте ссылку на каждый скилл из ~/.claude/skills.

Почему Codex не видит мой скилл по ссылке?

Codex переходит по ссылке на папку скилла, но игнорирует файл SKILL.md, который сам является ссылкой. Вместо этого сделайте ссылку на всю папку. Относительная ссылка разрешается от папки, в которой она лежит, поэтому проверьте, что путь верен именно оттуда.

Почему скилл показывается дважды?

Обычно потому, что две копии лежат в папках, которые читает инструмент. Codex по-прежнему читает старую папку ~/.codex/skills вместе с ~/.agents/skills и показывает обе копии скилла с одинаковым именем. Оставьте одну копию в ~/.agents/skills, а другую удалите.

Сравнение трёх инструментов не только по скиллам — в статье Claude Code, Codex и OpenCode.