Otdano · Документация
На этой странице

Навыки

Навык — способ работы с файлами, который можно дать нескольким агентам вместо того, чтобы копировать его в каждую инструкцию.

Навык хранит, как делать одну повторяющуюся работу. Его главный файл — SKILL.md, рядом могут лежать шаблоны, справочные материалы и скрипты.

Навык добавляют агенту, и агент пользуется им, когда берется за подходящую работу. Один и тот же способ больше не нужно переписывать в инструкцию каждого агента, а правка в навыке доходит до всех сразу.

Навык или инструкция

Инструкция агентаНавык
Для чегоЧем занимается этот агент, его границы и форма сдачи.Шаги, материалы и инструменты для одного вида работы.
У когоУ одного агента, в каждом запуске.У любого числа агентов, у каждого включается и выключается отдельно.
Пример«Проверяй статьи блога, текст сам не правь».Список проверки статьи и шаблон отчета.

Создать или импортировать навык

Откройте Навыки и нажмите Новый навык. Есть четыре способа:

СпособКогда подходит
Создать вручнуюНачать с пустого SKILL.md.
Импорт с компьютераВыбрать папку с SKILL.md или архив .skill / .zip.
Импорт по ссылкеЗагрузить опубликованный навык с GitHub, ClawHub или Skills.sh.
Копия из рантаймаПеренести навык, установленный на вашем компьютере в Claude Code или Codex.

Копия из рантайма переносит файлы такими, какие они в момент копирования. Если потом поменять навык на компьютере, навык в рабочей области сам не обновится. При копировании пропускаются символические ссылки, нечитаемые и слишком большие файлы.

Название навыка в рабочей области должно быть свободным. Если навык с таким названием уже есть, импорт остановится: удалите существующий навык и повторите импорт. При копии одного навыка из рантайма его можно сразу переименовать в поле Название навыка в пространстве.

Обновить навык из источника

Навык, загруженный по ссылке с GitHub, ClawHub или Skills.sh, помнит, откуда он взят. Чтобы получить свежую версию, нажмите Обновить на странице навыка или выберите Обновить из источника в меню навыка в списке.

Что происходит при обновлении:

  • Сохраняются агенты, которым навык добавлен, метки и автор. Добавлять навык агентам заново не нужно.
  • Заменяются название, описание, SKILL.md и все файлы навыка. Правки, сделанные в Otdano, пропадут.

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

Чтобы обновить несколько навыков сразу, отметьте их в списке и нажмите Обновить на панели выбора. Навыки без ссылки на источник будут пропущены.

Что внутри навыка

Главный файл навыка — SKILL.md. Напишите в нем:

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

Рядом можно положить вспомогательные файлы, например:

SKILL.md
references/style-guide.md
templates/report.md
scripts/check.sh

Файлы добавляют на вкладке Файлы кнопкой Добавить файл. SKILL.md — основной файл: второй файл с таким именем завести нельзя, а сам SKILL.md нельзя переименовать или удалить. Агент получает вспомогательные файлы вместе с основным.

Добавить навык агенту

Созданный навык еще ни у кого не работает. Добавить его агенту можно тремя путями:

  • в меню навыка в списке выбрать Добавить агенту и отметить агентов;
  • на странице навыка отметить агентов в списке Агенты с этим навыком;
  • на странице агента открыть Возможности → Навыки и нажать Добавить навык.

У одного агента может быть несколько навыков, а один навык может работать у многих агентов. Если навык пока не нужен агенту, выключите его переключателем в разделе Назначены агенту: навык останется в списке, но в запуски идти не будет. Изменения действуют со следующего запуска агента, идущие запуски они не меняют.

На странице агента добавлять, выключать и убирать навыки могут владелец агента, владелец и администраторы области.

Навыки с компьютера

Если агент работает на вашем компьютере, на вкладке Возможности → Навыки есть раздел Унаследованы от рантайма. Там навыки, которые уже установлены в Claude Code или Codex на этом компьютере. Агент пользуется ими, когда работает там. Выключить такой навык для одного агента нельзя. Чтобы управлять им из Otdano, перенесите его в рабочую область способом Копия из рантайма.

Кто может менять навык

Создать или импортировать навык может любой участник рабочей области. Менять и удалять навык могут его автор, владелец и администраторы области. Остальные видят навык с пометкой Только чтение и могут добавлять его агентам, которыми управляют.

Удаление навсегда: навык пропадает у всех агентов сразу, восстановить его нельзя. Выполненные задачи не меняются.

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

Связанные страницы