# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Ресурсы: [skill_init.py, таблица навыков]

ANTHROPIC / AGENTSKILLS.IO СТАНДАРТЫ НАВЫКОВ
------------------------------------------

По состоянию на 12 марта 2026 г.

Anthropic и Agentskills.io определяют открытый стандарт для
Навыки искусственного интеллекта, предоставляемые Claude Code, Codex CLI, Cursor, ChatGPT и
поддерживаются другие платформы. Этот стандарт позволяет
Распространяйте и внедряйте навыки на разных платформах.

BACH изначально поддерживает этот стандарт и может использовать существующие навыки.
экспорт в формат, совместимый с Anthropic.


СТАНДАРТНАЯ СТРУКТУРА КАТАЛОГ
-----------------------------
Навык, совместимый с Anthropic, представляет собой папку со следующей структурой:

  мой навык/
  +-- SKILL.md # Основное определение (обязательно)
  +-- скрипты/ # Исполняемые скрипты (необязательно)
  |   +-- setup.sh
  |   +-- run.py
  +-- ссылки/ # Справочная документация (необязательно)
  |   +-- core-overview.md
  |   +-- функции-api.md
  |   +-- best-practices-testing.md
  |   +-- Advanced-caching.md
  +-- assets/ # Статические файлы (необязательно)
      +-- логотип.png
      +-- config-template.json


SKILL.MD -- YAML-FRONTMATTER
-----------------------------
Каждый файл SKILL.md начинается с блока YAML-Frontmatter:

  ---
  имя: имя-мого-навыка
  описание: >
    Краткое описание способности, которую дает этот навык.
    Максимум 1024 символа.
  лицензия: С
  совместимость:
    - код Клауды
    - командная строка кодекса
  метаданные:
    автор: Лукиш
    версия: 1.0.0
    теги: [автоматизация, проверка кода]
  разрешенные инструменты:
    - Баш
    - Читать
    - Редактировать
  ---

Обязательные поля:
  имя Макс. 64 символа, регистр «кебаб» (a-z, 0-9, дефис)
  описание Макс. 1024 символа, произвольный текст

Необязательные поля:
  лицензия Идентификатор лицензии (MIT, Apache 2.0 и т. д.)
  совместимость Список совместимых платформ
  метаданные. Бесплатное значение ключа для автора, версии, тегов и т. д.
  разрешенные инструменты Белый список инструментов, которые навыку разрешено использовать

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


ПРОГРЕССИВНОЕ РАСКРЫТИЕ (3 ЭТАПА)
----------------------------------
Стандарт использует трехэтапный процесс загрузки для создания бюджетов токенов
эффективно использовать:

  Уровень 1 – Метаданные (~ 100 токенов)
    Только Frontmatter (название, описание, метаданные).
    Загружается во время просмотра/поиска. Позволяет LLM принимать решение
    актуален ли навык без чтения тела.

  Уровень 2 — Тело SKILL.md (< 5000 токенов)
    Полный текст инструкции SKILL.md.
    Загружается при активации/установке навыка.
    Содержит все правила, рабочие процессы и инструкции.

  Уровень 3 — Ресурсы в комплекте (по запросу)
    Файлы из ссылок/, скриптов/ и ресурсов/.
    Загружаются только в том случае, если навык явно запрашивает их.
    или они нужны LLM для текущей задачи.

Эта процедура позволяет снизить начальное потребление токенов и
масштабируется только при необходимости.


ИМЕНОВАНИЕ СПРАВОЧНЫХ ФАЙЛОВ
--------------------------
Файлы в папке references/ следуют соглашению об именах:

  core-*.md Основные понятия и обзор
  Features-*.md Документация по функциям и справочник по API
  best-practices-*.md Рекомендуемые практики
  Advanced-*.md Дополнительные темы и оптимизация

Примеры:
  ссылки/core-overview.md
  ссылки/функции-запрос-api.md
  ссылки/best-practices-error-handling.md
  references/advanced- Performance-tuning.md

Это соглашение позволяет LLM специально искать правильный вариант.
Глубина поиска.


ПОДДЕРЖКА BACH
--------------------
BACH может напрямую создавать антропосовместимые навыки:

  bach skills create <name> --format anthropic

Эта команда внутренне используетkill_init.py и создает:
- SKILL.md с корректным вступлением
- скрипты/папка (пустая)
- ссылки/папка (пустая)
- папка assets/ (пустая)

Существующие навыки BACH можно экспортировать:

  bach skills export <name> --format anthropic

Экспорт преобразует внутренний заголовок BACH в
Антропно-совместимая передняя часть и реорганизация файлов.


СРАВНЕНИЕ: БАХОВСКИЙ ВНУТРЕННИЙ ПРОТИВ АНТРОПНО-СОВМЕСТИМОГО
------------------------------------------------

Внутренний аспект антропного стандарта BACH
  ----------------- --------------------- ----------------------
  Основной файл SKILL.md SKILL.md
  Заголовок YAML (расширенный) YAML (Frontmatter)
  Имя поля имя (бесплатно) имя (кебаб-кебаб, 64Z)
  Введите тип поля (обязательно) -- (недоступно)
  Версия версия (обязательно) метаданные.версия (опция)
  Зависимости зависимости (обязательные) -- (не формализованы)
  Инструменты В папке навыков/scripts/
  Документация находится в ссылках на папку навыков/
  Статические файлы данных/или активы/активы/
  Рабочие процессы _workflows/ или локально В теле SKILL.md
  Синхронизация БД Да (таблица навыков) Нет
  Экспорт навыков BACH экспортировать Собственный формат

Внутренние навыки BACH имеют больше метаданных (тип, зависимости,
триггер_фразы), которые передаются в поля метаданных при экспорте.
стать. Антропно-совместимые навыки более компактны, но их меньше.
явно.


НАВЫКИ VS. АГЕНТЫ (АНТРОПНЫЕ)
------------------------------
В антропной экосистеме навыки и агенты представляют собой два отдельных понятия:

  Навык: открытый стандарт (agentskills.io), портативный.
          Определено в: .claude/skills/<имя>/SKILL.md
          Цель: инструкции, знания, рабочие процессы

  Агент: Владелец (только Claude Code/Agent SDK)
          Определено в: .claude/agents/<имя>.md
          Цель: изолированное выполнение, собственное контекстное окно.

Агенты НЕ определены в папке навыков. Но ты можешь
работать вместе:

  - Навык может активировать агент: контекст: fork + агент: <имя>
  - Агент может предварительно загружать навыки: навыки: [my-skill]

Только экспорт навыков актуален для LobeHub/Marketplace (открытый,
портативный). Агенты Claude Code являются необязательными и непереносимыми.

При экспорте агентов BACH:
  - Определения субагентов -> ссылки/
  - Код оркестровки -> скрипты/
  - Необязательно: .claude/agents/<name>.md для пользователей Claude Code


СМОТРИ ТАКЖЕ
----------
  bach help skills              Система навыков BACH (архитектура v2.0)
  bach help skill_export        Экспорт существующих навыков
  bach help naming              Соглашения об именах
  bach wiki lobehub             LobeHub Marketplace
  docs/help/skills.txt Подробная документация по навыкам
  wiki/skills_board.txt Графический интерфейс доски навыков
