Як синхронізувати skills агента між репозиторіями
Копії skill у восьми репозиторіях неминуче розходяться. Дізнайтеся, як винести їх у спільний репозиторій, закріпити версію та перевіряти оновлення.
Як спільно використовувати навички агентів у різних репозиторіях
Щоб спільно використовувати навички агентів у різних репозиторіях, припиніть копіювати файл і почніть робити на нього залежність. Зберігайте один репозиторій навичок, створюйте для нього тег, а в кожному проєкті фіксуйте потрібний тег. Потім додайте smoke test для кожної навички й перевіряйте кожне оновлення так само, як оновлення залежності.
Це складається з чотирьох частин: спільного джерела істини, зафіксованої версії для кожного репозиторію, smoke test для кожної навички та процесу перевірки. Нижче пояснюється, навіщо потрібна кожна частина, як інструменти, що випускаються у 2026, працюють із цим і як побудувати всю схему на self-hosted git remote без використання зовнішнього git host або package registry. Smoke tests є єдиним винятком. Вони запускають Claude Code, який надсилає кожен запит до model API, тому цей крок усе ще залишає ваш сервер.
Навичка агента — це папка, що містить файл SKILL.md, а також потрібні їй скрипти та довідкові файли. Якщо цей компонент для вас новий, спочатку прочитайте що таке навичка агента і як працює SKILL.md. Ця сторінка присвячена ланцюжку постачання для цього компонента.
Де зберігається skill і чому ним складно ділитися
Claude Code завантажує skills із наведених нижче та інших розташувань. У документації skills перелічено кожен шлях.
.claude/skills/<skill-name>/SKILL.mdу каталозі керованих налаштувань — це корпоративне розташування. Skill завантажується для кожного користувача на машинах, де його розгортає організація.~/.claude/skills/<skill-name>/SKILL.md— це персональне розташування. Skill завантажується в усіх ваших проєктах і не завантажується в проєктах інших користувачів..claude/skills/<skill-name>/SKILL.md— це рівень проєкту. Skill завантажується для всіх, хто клонує цей репозиторій.<plugin>/skills/<skill-name>/SKILL.mdпостачається всередині plugin. Skill завантажується всюди, де ввімкнено цей plugin.
Claude Code також завантажує skills із вкладених каталогів проєкту, каталогів, переданих через --add-dir, і skills, увімкнених для вашого облікового запису claude.ai.
Розташування на рівні проєкту найзручніше для команди, оскільки його вміст додається до репозиторію, і кожен, хто клонує репозиторій, отримує цей skill. Тут також починаються проблеми. Skill у .claude/skills/ належить одному репозиторію. У вас є вісім репозиторіїв. Отже, skill доводиться копіювати вісім разів.
Frontmatter не допомагає. Специфікація Agent Skills допускає шість ключів, а механізми розповсюдження, які забезпечують цю вимогу, виводять список, якщо використати інший ключ:
Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, nameЗверніть увагу, чого немає: ключа version не передбачено. Версію можна вказати в metadata, але специфікація не визначає механізму фіксації залежностей або оновлення. Це логічно, оскільки skill є документом, а не пакетом. Водночас версіювання має забезпечувати рівень навколо цього файлу, і цей рівень належить налаштувати вам.
Проблема 1: вісім копій, які непомітно розходяться
Копіювання та вставлення працює в перший день. На шістдесятий день воно вже дає збій. Хтось виправляє неправильну інструкцію в репозиторії payments, але не змінює інші сім копій. Хтось інший додає правило щодо пагінації в orders. Тепер одна й та сама назва skill дає різні результати перевірки залежно від того, з якого каталогу запустився агент, і жоден розробник про це не знає.
Збій непомітний, оскільки стану помилки немає. Skill — це текст. Застаріла інструкція призводить до впевненої, але неправильної відповіді, а саме такі помилки обходяться найдорожче. Агент не порівнює вашу копію з копіями в інших репозиторіях, тому єдиний сигнал — людина має помітити, що два репозиторії не узгоджуються.
Проблема 2: версію не зафіксовано
Навіть якщо команда зберігає навички в одному місці, зазвичай їх поширюють через крок копіювання: setup-скрипт, рядок curl у документі з інструкціями для онбордингу або shell-аліас, який синхронізує каталог. Усі ці способи встановлюють поточний стан гілки без фіксації версії.
Через це два розробники можуть працювати з одним і тим самим комітом одного застосунку, але використовувати різні інструкції, якщо вони виконали синхронізацію в різні дні. Також після невдалого запуску агента неможливо відповісти на важливе запитання: яка версія навички це спричинила? Без записаної ревізії запуск неможливо відтворити, тому звіт про помилку не дає змоги виконати діагностику.
Проблема третя: ніхто не знає, чи навичка досі працює
Навичка не має компілятора. Це інструкції для моделі, тому вона може перестати працювати, хоча файл залишиться ідентичним до останнього байта. Оновлення моделі змінює те, наскільки точно вона дотримується довгих інструкцій. Інструмент командного рядка, який викликає навичка, перейменовує прапорець. URL у довідковому файлі починає повертати 404, і агент працює зі сторінкою помилки.
У жодному з цих випадків не виникає явної помилки. Агент і далі відповідає. Просто відповідь стає гіршою, ніж минулого місяця, а це важко помітити, якщо перевіряти зміни по одному pull request.
Що вирішують інструменти, випущені у 2026 році
Зараз з’являється кілька варіантів, і вони по-різному визначають, де має зберігатися версія.
Lockfiles. Інструмент командного рядка skills від Vercel Labs (vercel-labs/skills, ліцензія MIT, версія v1.7.2 станом на 9 October 2026) встановлює skills із git-репозиторію в каталог, якого очікує ваш агент, і знає структуру понад сімдесяти агентів. npx skills add <repo> встановлює, npx skills update оновлює, а npx skills list показує встановлені компоненти. Інструмент підтримує два lock-файли. Глобальний файл у ~/.agents/.skill-lock.json містить відомості про те, що встановив конкретний користувач. Починаючи з v1.4.1 (20 February 2026), встановлення в scope проєкту також записує skills-lock.json у корені проєкту, і у вихідному коді інструмента зазначено, що цей файл потрібно додавати до системи контролю версій. npx skills experimental_install відновлює skills проєкту з цього файлу. Issue 283 із запитом на команду skills install для відновлення глобального lock-файлу на іншій машині було закрито зі статусом not planned 5 November 2026; мейнтейнер визначає його як той самий запит, що й issue 549. Обидва issue слід розглядати як звіт про поточний статус. Lockfile для окремого проєкту існує. У випущеній версії v1.8.1 команда відновлення все ще позначена в довідці як експериментальна, але npx skills install без source також відновлює lockfile проєкту.
Specs і тести. SkillSpec використовує інший підхід. Він розглядає SKILL.md як контракт, який потрібно перевіряти, а не як текст, якому слід довіряти; заявлена мета — зробити skills «придатними для виконання, тестування та доведення». skillspec doctor <path> показує, де агент, найімовірніше, втратить контекст. skillspec boundary map <path> показує вміст skill, а skillspec boundary assess <path> звітує, до яких ресурсів він може отримати доступ, із ранжуванням за ризиком. Це Rust crate із подвійною ліцензією MIT або Apache 2.0. Версію 0.2.2 опубліковано 29 July 2026; станом на 10 October 2026 вона залишається найновішою версією на crates.io. Встановлюйте зафіксовану версію, а не найновішу:
cargo install skillspec --version 0.2.2 --locked
skillspec --versionПочинаючи з Cargo 1.100, випущеного 12 November 2026, cargo install використовує упакований lockfile за замовчуванням, а --locked нічого не робить. skillspec --version має вивести 0.2.2. Інше значення означає, що раніше у вашому PATH знаходиться старіший binary і саме він має пріоритет.
Практика постачальника. Google описала, як створює skills у google/skills, у публікації як вона створює, тестує та масштабує skills для агентів. Якщо не враховувати масштаб, механізм є звичайною безперервною інтеграцією (CI). Перед злиттям кожен skill проходить linters, які перевіряють frontmatter metadata, кількість рядків, структуру каталогів і правила іменування. Link checker завершує збірку з помилкою для будь-якого URL, що повертає 404; це виявляє правдоподібні посилання, вигадані агентом. Автори мають додавати до skill набір evaluation prompts і scoring rubric. Заплановані evaluation jobs щотижня запускаються для всієї бібліотеки, щоб виявляти регресії, а для кожного skill призначено відповідального власника, який має виправляти проблеми зі зниженням якості.
Шаблон, спільний для всіх трьох відповідей
Вам не обов’язково обирати один із цих варіантів. За ними стоїть одна структура, і звичайний git дає змогу реалізувати її повністю.
- Єдине джерело істини. Skill має рівно одне місце зберігання, а кожен репозиторій посилається на це джерело, не зберігаючи власну копію.
- Зафіксована версія для кожного репозиторію. Кожен проєкт записує точну ревізію, яку він використовує. Тому оновлення є commit у цьому проєкті із зазначеними автором і датою.
- Smoke test для кожного skill. Один виконуваний тест підтверджує, що skill і надалі дає обіцяний результат.
- Процес перевірки змін. Зміна спільного skill проходить review, а кожен споживач бачить diff перед її застосуванням.
Це і є структура залежності. Skills стали спільним артефактом швидше, ніж навколо них з’явилися відповідні інструменти, тому найнадійніше використовувати інструменти, яким ви вже довіряєте.
Структура для невеликої команди на self-hosted git remote
Один репозиторій містить інструкції. Більше в ньому нічого немає, тому його історія виглядає як журнал змін інструкцій.
agent-skills/
skills/
api-review/
SKILL.md
release-notes/
SKILL.md
tests/
api-review.sh
release-notes.sh
CHANGELOG.mdРелізи — це теги. Використовуйте анотовані теги, оскільки вони містять повідомлення та дату. У повідомленні зазначайте причину, через яку користувачеві потрібне оновлення:
git tag -a v1.4.0 -m "api-review: require pagination on list endpoints"
git push origin v1.4.0Якщо ваш remote — це Gitea, Forgejo, GitLab або bare repository через SSH на власному VPS, далі нічого не змінюється. Усе зводиться до git і symlink.
Фіксація версії за допомогою git submodule
Submodule записує один точний commit іншого репозиторію у вашому репозиторії. Цей запис і є зафіксованою версією. У кожному проєкті, який його використовує:
git submodule add https://git.example.com/team/agent-skills.git vendor/agent-skills
git -C vendor/agent-skills fetch --tags
git -C vendor/agent-skills checkout v1.4.0
mkdir -p .claude/skills
ln -s ../../vendor/agent-skills/skills/api-review .claude/skills/api-review
git add .gitmodules vendor/agent-skills .claude/skills/api-review
git commit -m "Pin shared agent skills to v1.4.0"Саме symlink забезпечує цю схему. Запис skill на рівні проєкту може бути symlink на каталог в іншому місці диска, а Claude Code переходить за ним і читає SKILL.md із цільового каталогу. Тому skill завантажується як звичайний skill проєкту, а його файли зберігаються в submodule на вибраному вами commit.
Перевірте зафіксовану версію:
git submodule statusКоректний рядок починається з пробілу, далі містить commit, шлях і найближчий tag:
4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602 vendor/agent-skills (v1.4.0)Початковий - означає, що submodule ще не ініціалізовано, тому .claude/skills/api-review ні на що не вказує, а skill непомітно не завантажується. Виправте це за допомогою git submodule update --init. Початковий + означає, що checkout-нутий commit відрізняється від записаного, тому цей розробник працює з інструкціями, яких немає в інших. Для нових clone потрібна команда git clone --recurse-submodules. Її слід додати до README, оскільки звичайний clone залишає vendor/agent-skills порожнім і не виводить помилки.
Оновлення виконується свідомо, і саме в цьому полягає перевага такої схеми:
git -C vendor/agent-skills fetch --tags
git -C vendor/agent-skills diff v1.4.0 v1.5.0 -- skills/
git -C vendor/agent-skills checkout v1.5.0
git add vendor/agent-skills
git commit -m "Bump shared agent skills to v1.5.0"Рядок diff є способом перевірки змін. Він показує ті самі зміни, які побачить кожен інший проєкт, що використовує цей submodule, і добре підходить для pull request.
Замість pinning через marketplace плагінів
Якщо ви не хочете, щоб кожен розробник вивчав submodules, система плагінів Claude Code виконає розповсюдження за вас і працює із self-hosted remote. Додайте каталог у .claude-plugin/marketplace.json у skills repository:
{
"name": "acme-agents",
"owner": { "name": "Platform team", "email": "platform@example.com" },
"plugins": [
{
"name": "team-skills",
"description": "Shared review and release skills",
"version": "1.4.0",
"source": {
"source": "url",
"url": "https://git.example.com/team/agent-skills.git",
"ref": "v1.4.0",
"sha": "4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602"
}
}
]
}Тут використовуються два різні джерела, і саме їх плутання є типовою помилкою. Джерело marketplace, тобто місце, звідки завантажується сам каталог, приймає ref для branch або tag, а в Claude Code v2.1.324 або пізнішої версії — повний lowercase commit SHA; окреме поле sha не підтримується. Джерело плагіна всередині каталогу приймає обидва поля. Якщо задано обидва, ефективним pin є sha. Зафіксуйте каталог через ref у джерелі marketplace, а плагін — через sha в елементі каталогу. Назви типів також відрізняються. У каталозі url означає git repository, який потрібно клонувати. У джерелі marketplace url означає пряме посилання на файл marketplace.json, а git repository позначається як git.
Далі кожен repository, який використовує плагін, оголошує marketplace у своєму закоміченому .claude/settings.json:
{
"extraKnownMarketplaces": {
"acme-agents": {
"source": {
"source": "git",
"url": "https://git.example.com/team/agent-skills.git",
"ref": "v1.4.0"
}
}
},
"enabledPlugins": {
"team-skills@acme-agents": true
}
}Claude Code реєструє marketplace для учасника команди після того, як він приймає діалог довіри до workspace для папки проєкту. Окрема wiki-сторінка з інструкціями для цього не потрібна. Запис каталогу містить git URL, а не відносний шлях, тому сам плагін не встановлюється лише з налаштувань repository. Кожен учасник команди один раз виконує claude plugin install team-skills@acme-agents --scope project. До цього Claude Code повідомляє, що плагін увімкнено в налаштуваннях проєкту, але його не встановлено. Після цього skills доступні за адресою /team-skills:api-review, оскільки skills плагіна мають namespace за назвою плагіна й не можуть конфліктувати з project skill з такою самою назвою. Після push нового tag і оновлення pin у каталозі та repository, які його використовують, споживачі оновлюють дані за допомогою /plugin marketplace update acme-agents, а потім виконують /reload-plugins, якщо цього вимагає підсумок встановлення.
Написання smoke-тесту для одного скіла
Smoke-тест — це скриптовий запуск агента проти фікстури з відомою помилкою та однією перевіркою (assertion). Claude Code працює в неінтерактивному режимі з -p, і викликаний користувачем скіл працює в ньому: додайте /skill-name у рядок запиту, і він буде розгорнутий перед початком виконання.
#!/usr/bin/env bash
set -euo pipefail
claude -p "/api-review Read fixtures/orders-api.md and list the rule ids it breaks." \
--allowedTools "Read" \
--output-format json \
--json-schema '{"type":"object","properties":{"rule_ids":{"type":"array","items":{"type":"string"}}},"required":["rule_ids"]}' \
| jq -e '.structured_output.rule_ids | index("pagination-required")' > /dev/nullfixtures/orders-api.md — це короткий файл з однією навмисною помилкою. Перевірка полягає в тому, що скіл має вказати на неї. jq -e завершується з ненульовим кодом, коли його фільтр видає null, тому скіл, який перестає виявляти закладену помилку, призводить до провалу скрипта. Сам claude завершується з ненульовим кодом, якщо запуск не вдався, а set -euo pipefail перетворює будь-яку з цих помилок на невдалий тест.
Модель перефразує свої відповіді між запусками, тому ніколи не робіть перевірку на ціле речення. Перевіряйте ідентифікатор, який має видати скіл, або поле схеми, яку ви запитували, і тримайте фікстуру невеликою, щоб запуск залишався дешевим.
У CI додайте --bare. Без нього claude -p завантажує той самий контекст, що й інтерактивна сесія, включаючи хуки, плагіни та CLAUDE.md з машини, на якій він виконується, тому персональна конфігурація колеги може змінити результат. Bare mode пропускає автовиявлення, за винятком скілів у .claude/skills/ у директорії, явно вказаній через --add-dir; він пропускає скіл проєкту, який ви тестуєте тут, тому завантажуйте його явно. Bare mode також не зчитує ваш логін підписки, тому спочатку встановіть ANTHROPIC_API_KEY у середовищі:
claude --bare -p "/team-skills:api-review Read fixtures/orders-api.md and list the rule ids it breaks." \
--plugin-dir vendor/agent-skills \
--allowedTools "Read" \
--output-format jsonПлагін, завантажений через --plugin-dir, бере свою назву з .claude-plugin/plugin.json, а без цього маніфесту він називається за назвою своєї директорії. Додайте plugin.json з "name": "team-skills" поруч із каталогом у репозиторії скілів, інакше наведена вище команда має викликати /agent-skills:api-review.
З --output-format stream-json подія system/init повідомляє, які плагіни завантажилися, і містить масив plugin_errors для тих, що не завантажилися. Вона відкриває потік, якщо події запуску не надходять першими. Завершуйте CI-завдання з помилкою, якщо plugin_errors не порожній. Це дозволяє виявити закріплення (pin) на ревізію, яка більше не існує, що інакше виглядало б як агент, який мовчки ігнорує ваші внутрішні правила.
Спільний скіл — це виконувана інструкція
Дві функції роблять це твердження буквальним, і обидві мають значення, коли файл надходить від іншої команди.
По-перше, SKILL.md може виконувати shell-команди до того, як модель прочитає будь-що. Рядок на кшталт цього в тілі файлу є попередньою обробкою:
- Current branch: !`git rev-parse --abbrev-ref HEAD`Команда виконується на машині, що завантажує скіл, а її вивід замінює плейсхолдер у тексті, який отримує модель. Блок, відкритий трьома зворотними лапками з !, виконує кілька команд у такий самий спосіб. Під час виконання запит на дозвіл для цих дій не надсилається. Claude Code перевіряє кожну команду відповідно до ваших правил дозволів. Поза режимом auto команда, яку не дозволяють ці правила, перериває виконання скіла, якщо тільки скіл не схвалює її заздалегідь за допомогою другої функції, описаної нижче. Правила заборони (deny) та запиту (ask) все одно мають пріоритет над таким попереднім схваленням. Читання спільного скіла означає читання його підстановок команд.
По-друге, frontmatter може попередньо схвалювати інструменти. allowed-tools надає доступ до перелічених інструментів без запиту на дозвіл для того кроку (turn), який викликав скіл. Довіра до робочої області (workspace trust) не обмежує цей дозвіл: Claude Code застосовує allowed-tools скіла проєкту навіть під час виконання -p у папці, якій ніхто не надав довіри. Документація Claude Code чітко вказує на наслідки: скіл може надати собі широкий доступ до інструментів, тому перевіряйте allowed-tools скілів, доданих до репозиторію, перш ніж запускати там Claude Code. Організація може заборонити використання цього поля в проєктних і персональних скілах, встановивши allowManagedPermissionRulesOnly у керованих налаштуваннях, що потребує Claude Code версії 2.1.282 або новішої.
Тому ставтеся до оновлення скіла так само, як до оновлення залежностей. Фіксуйте версію за конкретним commit, де це дозволяє механізм, оскільки тег можна перемістити, а гілка змінюється за визначенням. На захищеній машині "disableSkillShellExecution": true у налаштуваннях замінює кожну підстановку команди на буквальний текст [shell command execution disabled by policy] замість її виконання; якщо це застосовано через керовані налаштування, користувач не може це скасувати. Вбудовані та керовані скіли звільнені від дії цього налаштування.
Така сама обережність потрібна щодо того, що читає скіл. Скіл, який запускає env або відкриває файл конфігурації, завантажує все знайдене в контекст моделі, що є помилкою, описаною в як не допустити потрапляння секретів до агентів, які ви запускаєте. Скіл, який отримує сторінку або виконує запит, є таким самим ризиком, спрямованим назовні, оскільки отриманий текст потрапляє в контекст і виглядає точно так само, як інструкції, які ви написали. Це межа, про яку варто прочитати, перш ніж спрямувати агента на власний екземпляр SearXNG для вебпошуку.
Що читати під час оновлення версії
- Diff кожного тіла
SKILL.md, оскільки цей текст містить інструкції, яких дотримуватиметься ваш агент. - Кожну підстановку команди, оскільки вона виконується на вашій машині під час завантаження skill.
- Будь-яку зміну в
allowed-tools, оскільки цей рядок надає інструменти без запиту. - Результат тестового запуску, пов’язаного з tag. Якщо спільний репозиторій запускає власні smoke-тести в CI, tag, на який ви закріплюєте версію, має мати прикріплений успішний запуск.
Якщо reviewer не може прочитати весь diff за десять хвилин, skill став надто великим. Розділіть його. Те саме стосується документів репозиторію, які читають ваші агенти: зберігайте незмінні правила у файлах, описаних у розподілі між AGENTS.md і HUMAN.md, а архітектурні обґрунтування — у DESIGN.md, написаному для агентів, і залишайте skills вузькоспеціалізованими процедурами.
Коли зміна моделі або інструмента порушує роботу skill
Під час роботи skill може змінитися багато компонентів, навіть якщо ніхто не редагує сам skill. Оновлення моделі змінює надійність виконання довгих інструкцій. Через це skill, який залежав від досягнення моделлю кроку дев’ять, може перестати до нього доходити. Утиліта командного рядка може перейменувати flag. Тоді agent запускає старий flag, читає помилку та імпровізує. URL, на який є посилання, може почати повертати 404. Agent harness може змінити спосіб вибору skill. Через це description, який раніше перемагав під час зіставлення, більше не відповідає потрібному критерію. Якщо процедура через це починає завершуватися достроково, збільшення версії не усуває проблему. Самі інструкції потрібно структурувати так, щоб вони змушували виконувати останні кроки. Саме на цьому ґрунтується skill unlazy та його метод Depth Tree.
Тому в цій схемі smoke test має вирішальне значення. Запускайте тест кожного skill за розкладом, а також після push. Google щотижня запускає свої evaluation jobs для всієї бібліотеки саме з цієї причини. Для команди з десятьма skill достатньо щотижневого cron job на невеликому VPS. Це єдиний спосіб дізнатися про проблему раніше, ніж її виявить розробник.
Переносимість також допомагає. Специфікація Agent Skills обмежує frontmatter шістьма ключами. Тому skill, написаний відповідно до цієї специфікації, завантажується в різних інструментах, а не лише в тому, для якого його створили. Кожен ключ, специфічний для певного harness, є ставкою на одного vendor. Створення skill, які працюють після заміни моделі, є окремою дисципліною. Вона розглядається в матеріалі як забезпечити роботу skill на будь-якій моделі.
FAQ
Як надати одну навичку агента доступною в кількох репозиторіях?
Розмістіть навичку в окремому git-репозиторії, створюйте в ньому теги релізів, а в кожному проєкті, який її використовує, посилайтеся на тег замість копіювання файлу. Є два робочі механізми. git submodule фіксує точний коміт, а symlink із .claude/skills/<name> у submodule дає змогу завантажувати навичку як звичайну навичку проєкту. Plugin marketplace виконує те саме завдання через /plugin, а pin оголошується у .claude/settings.json репозиторію, який її використовує. В обох випадках версія зберігається в історії git, тому можна визначити, які інструкції сформували конкретний запуск агента.
Чи можна прив’язати навичку агента до певної версії?
Не всередині SKILL.md, оскільки цей frontmatter не має ключа version. Pin має задаватися на рівні, що обгортає файл. git submodule за своєю конструкцією фіксує точний коміт. У Claude Code plugin marketplace джерело плагіна приймає ref для гілки або тега та sha для точного коміту; якщо вказано обидва параметри, пріоритет має sha. Саме джерело marketplace приймає ref для гілки, тега або, у Claude Code v2.1.324 чи новішої версії, повного SHA коміту в нижньому регістрі. Перевагу надавайте pin коміту, оскільки тег можна перемістити після перевірки.
Що має перевіряти smoke test навички?
Перевіряйте стабільний результат. Запустіть навичку в неінтерактивному режимі на fixture, що містить відому несправність, а потім перевірте, чи з’являється у виводі конкретний ідентифікатор, наприклад ідентифікатор правила, який навичка має повідомити. Запит структурованого виводу за допомогою --output-format json і --json-schema робить перевірку точною, а jq -e завершує виконання скрипту з помилкою, якщо значення відсутнє. Не перевіряйте повне речення, оскільки модель може по-різному формулювати відповіді під час різних запусків.
Чи безпечно встановлювати спільну навичку з репозиторію іншої команди?
Ставтеся до неї як до програмної залежності, оскільки вона містить виконувані інструкції. SKILL.md може виконувати shell-команди під час завантаження через форму підстановки команд !, а поле frontmatter allowed-tools може попередньо дозволяти використання інструментів без запиту. Переглядайте diff під час кожного оновлення, фіксуйте точний коміт замість гілки та віддавайте перевагу джерелу, яким керує ваша команда. На керованих машинах параметр "disableSkillShellExecution": true у налаштуваннях забороняє виконання підстановок команд у навичках користувача, проєкту, плагіна та додаткових каталогів; bundled і managed навички є винятком.
Чи працюватиме спільна навичка в агентах, відмінних від Claude Code?
Це залежить від того, які поля frontmatter ви використовуєте. Специфікація Agent Skills визначає шість ключів: name, description, license, compatibility, metadata і allowed-tools. Навичка, обмежена цими ключами, завантажується в інструментах, які реалізують специфікацію, а також завантажується в Claude Code без змін. Ключі та функції body, специфічні для певного harness і не передбачені специфікацією, в інших системах ігноруються або відхиляються, тому не використовуйте їх у навичках, якими плануєте широко ділитися.