Claude Skills vs OpenAI Skills: переносимість, API та governance

Claude Skills і OpenAI Skills реалізують ту саму базову ідею: reusable workflow пакує інструкції, приклади, scripts і supporting resources, а agent підвантажує його, коли задача збігається з description. Для нового vendor-neutral workflow починайте з мінімального Agent Skills core — SKILL.md, вузької місії, portable references і deterministic fixtures. Не вписуйте product-specific identity, secret або deployment assumption у спільне ядро.

Обирайте продукт за місцем виконання і governance, а не лише за Markdown. Claude документує Skills у claude.ai, Claude Code та Claude API; OpenAI документує Skills у eligible ChatGPT workspaces, Codex та Skills API. Availability, sharing, upload, execution і permission boundaries залежать від конкретної surface. Тому однакова папка не означає однаковий rollout, а підтримка двох vendor wrappers часто безпечніша за обіцянку zero-change portability.

• Один SKILL.md core → спільна процедура й acceptance criteria.
• Claude wrapper → surface, container, workspace та code-execution contract.
• OpenAI wrapper → ChatGPT/Codex/API installation, sharing і version contract.
• Authority → server-side policy та target system, а не vendor label skill.

Для interactive knowledge work перевіряйте, де користувач створює, встановлює й ділиться skill. Claude.ai підтримує pre-built і custom Skills, тоді як Claude Code знаходить filesystem-based custom Skills у personal або project paths. ChatGPT показує Skills через Plugin Directory для eligible Business, Enterprise, Healthcare та Edu workspaces; sharing може бути адресним або workspace-wide, а OpenAI окремо застерігає, що Codex governance може відрізнятися.

Для API workload порівнюйте не marketing name, а request contract. Claude Messages використовує skill reference всередині container разом із code execution; custom API Skills належать workspace і мають version resources. OpenAI Skills API також має CRUD, content і version endpoints, але конкретний спосіб прикріплення skill до виконання треба звіряти з чинною guide для обраного runtime. Якщо документація не підтверджує потрібний execution path, позначте його unsupported замість моделювати сумісність за аналогією.

Portable subset містить валідні name і description, Markdown procedure, relative references, assets без прихованого executable behavior та scripts із явними dependencies. Description має одночасно пояснювати capability і trigger. Keep core free від абсолютних home paths, vendor-only tool names, undocumented frontmatter і припущення, що shell, network або package install завжди доступні.

Створіть compatibility manifest поруч із release artifact: core digest, format version, tested vendor surfaces, model/client version, supported metadata, filesystem root, bundled runtimes, network policy, maximum package size, available tools, data-retention class і known degradations. Vendor extension зберігайте у wrapper або generated overlay. Якщо overlay змінює місію чи acceptance criteria, це вже окремий variant, а не та сама переносима версія.

• Core → mission, instructions, fixtures, references та output schema.
• Adapter → path, upload shape, product metadata і tool aliases.
• Environment → runtime packages, network, storage, timeout і retention.
• Evidence → digest плюс результати на кожній заявленій surface.

Anthropic API розрізняє pre-built і custom sources, дозволяє посилатися на specific version або latest і документує workspace-wide доступ до custom Skills. Поточна guide також попереджає, що видалення Skill прибирає всі його versions. OpenAI reference окремо надає Skill, content і Skill Version resources та операцію зміни default version. Обидві моделі дають lifecycle primitives, але їхні identifiers, default semantics і deletion consequences не є взаємозамінними.

Production manifest повинен pin exact vendor skill/version і core digest. `latest` зручний для authoring, але створює рухому залежність у regulated або side-effecting flow. Promotion робіть через immutable candidate, replay suite і explicit default switch. Rollback повертає попередню vendor version; якщо skill уже виконав зовнішню дію, rollback content не скасовує effect — action ledger і reconciler мають перевірити authoritative state.

У Claude API custom Skills доступні всьому workspace, а документація радить окремий workspace як isolation boundary для multi-tenant platform. У claude.ai personal custom Skills і organization-provisioned Skills мають інші distribution contours. У ChatGPT workspace skill можна поширити конкретним людям, групам або workspace library, але entitlement і admin settings визначають фактичний доступ. Не переносіть ACL із одного продукту в таблицю іншого один-до-одного.

Ведіть distribution ledger: business owner, package digest, vendor object ID, version, audience, installer, approver, allowed data classes, expiry та revoke receipt. Перевіряйте доступ двома негативними identities — користувачем поза групою і tenant з іншого workspace. Shared package не повинен містити credentials, customer data або implicit authority. Видалення зі списку discovery треба окремо перевірити проти cached sessions, local copies і вже відкритих conversations.

OpenAI повідомляє, що uploaded ChatGPT skills скануються й можуть отримати Needs Review або Blocked, але прямо не вважає scan заміною власних policies та judgment. Anthropic також радить використовувати Skills лише з trusted sources, бо instructions і code можуть спрямувати agent до небажаного tool use. Claude API currently описує sandboxed container без network і runtime package installation, проте цей contour не можна переносити на Claude Code, ChatGPT, Codex або іншу surface.

Review package як software dependency: provenance, license, maintainer, pinned digest, diff, scripts, nested references, encoded content, requested tools, egress destinations і secret paths. Запускайте untrusted candidate у disposable environment без production credentials. Model instruction не є security boundary: allowlist, filesystem scope, network policy, authorization, approval і idempotency мають діяти поза skill та повторно перевірятися target adapter.

Однаковий eval corpus запустіть на кожній заявленій Claude й OpenAI surface. Activation slice містить positive, near-negative, ambiguous і collision prompts. Artifact slice перевіряє schema, required fields, citations і deterministic checks. Trajectory slice фіксує прочитані references, tool selection, arguments та stop conditions. Denial slice перевіряє missing file, forbidden path, unavailable tool, prompt injection і revoked user.

Порівнюйте contract outcomes, а не однаковість формулювань. Визначте blocking classes до тесту: unauthorized effect, cross-tenant disclosure, пропущений mandatory check, unsupported claim або malformed terminal artifact. Для non-critical differences запишіть vendor-specific baseline і reviewer rationale. Не публікуйте відсоток parity без versioned fixtures, denominator і receipts; цей guide не стверджує, що один provider виконує Skills точніше.

• Discover → правильний skill активовано, чужий не активовано.
• Load → прочитано лише потрібні files без path escape.
• Execute → дозволені tools, valid arguments і bounded retries.
• Verify → artifact та system-of-record postcondition.
• Deny → unauthorized або unsupported path fail-closed.

Release pipeline збирає canonical core, валідовує spec, генерує vendor adapters, обчислює digest, завантажує candidate versions і запускає surface-specific tests. Reviewer приймає один evidence pack із core diff та окремими receipts. Canary починається з read-only задач і малої audience; write capability додається лише через незалежну policy. Telemetry розрізняє vendor, product surface, skill ID/version, core digest, activation result, tool verdict і accepted outcome без збереження зайвих prompt data.

Exit drill має відтворити core з canonical repository, розгорнути його на другій surface, замінити vendor-only dependencies і пройти critical fixtures. Якщо portable subset виявився фікцією, команда повинна отримати точний gap list, а не терміновий rewrite. Rollback вимикає candidate discovery, повертає pinned version, revokes obsolete shares і reconciles in-flight effects. Product availability та limits є mutable: повторно звіряйте official docs перед procurement і кожним promotion gate.