108
Скилл
Длинную просьбу, которую вы повторяете агенту из раза в раз, сохраняют файлом. Дальше агент берёт инструкцию из файла, а вы вызываете её по короткому имени. Такую инструкцию называют скиллом.
Скилл это папка с файлом SKILL.md
Файл скилла всегда называется SKILL.md и лежит в папке с именем скилла, например interview-me/SKILL.md. Рядом могут лежать шаблоны и примеры: агент открывает их, только когда они понадобились.
В начале файла стоят имя и описание: что делает скилл и когда его применять. Ниже идут шаги. Так начинается скилл daily:
---
name: daily
description: Дневной фокус штаба — что делать сегодня по открытым задачам всех отделов. Применять по «что сегодня» и в утреннем запуске по расписанию.
---Скилл написан в Markdown, его читают и правят руками, как любой текстовый файл. Слово «скилл» в программе относится только к агенту. Умение человека называют навыком.
Скилл и AGENTS.md
Файл правил AGENTS.md харнес читает сам при каждом запуске агента. Скилл агент читает, когда он нужен задаче. Описания всех скиллов агент видит постоянно, а текст скилла открывает, когда задача совпала с описанием или вы вызвали скилл по имени. Поэтому десяток скиллов не забивает контекст так, как его забивает длинный файл правил.
В AGENTS.md кладут то, что нужно в каждой сессии: кто вы, где что лежит, как с вами общаться. В скилл кладут процедуру из нескольких шагов, которая нужна время от времени. Например, еженедельный отчёт из пяти таблиц со строгим порядком фильтрации. В AGENTS.md такая инструкция тратила бы токены на каждый ваш запрос, а скилл загрузится только в день отчёта.
Отдел больше скилла. Скилл решает одну задачу из нескольких шагов. Отдел это папка рядом со штабом, вашей главной папкой, и в отделе работают несколько ролей: у него свои правила, задачи и скиллы. Подробно отделы разобраны в главе «Отделы».
Где лежат скиллы
Глобальный скилл лежит в общей папке скиллов харнеса, и агент видит его из любой папки на компьютере: поставили один раз, работает везде. Проектный лежит в папке штаба или отдела и работает, только когда агент запущен из неё. Зато, когда вы делитесь отделом с человеком или командой, проектный скилл уезжает вместе с папкой.
| Харнес | Общая папка скиллов | Папка скиллов в проекте | Вызов по имени |
|---|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ | /имя |
| Codex | ~/.agents/skills/ | .agents/skills/ | $имя |
На Windows общие папки лежат внутри %USERPROFILE%. Папки с точкой в начале имени скрытые, поэтому в обычном списке файлов их не видно.
В стартовом шаблоне штаба скиллы лежат в папке .agents/skills/, а .claude/skills ведёт на неё ссылкой. Так один и тот же скилл видят и Claude Code, и Codex.
Глобально ставят то, чем пользуются часто и из разных папок, например grill-me: он расспрашивает вас о задаче до начала работы. Проектно ставят то, что относится к одному отделу или должно уехать вместе с его папкой. Скиллы daily, manager и retro запускают из штаба, поэтому их ставят в штаб.
Как поставить готовый скилл
Готовый скилл ставят по ссылке: агент сам скачает папку и положит её на место.
- Дайте агенту ссылку на один конкретный скилл. Ссылка на целую библиотеку тянет за собой тысячи скиллов.
- Попросите рассказать, что это за скилл. Агент прочитает его и перескажет, и вы будете знать, что ставите. Это и проверка безопасности: чужой скилл это чужая инструкция вашему агенту. Жёстким правилом агента такую проверку лучше не записывать: он начнёт спрашивать разрешения на каждом шаге, а сработает ли правило, не гарантировано. Надёжнее привычка сначала спросить: решение, что ставить, остаётся за вами.
- Ставьте только то, чем будете пользоваться регулярно, словами «Поставь скилл глобально» или «Поставь скилл проектно». Скилл это промпт, поэтому разовую задачу агент выполнит прямо по ссылке, без установки.
Расскажи, что за скилл, как он мне может быть полезен, как мы можем его использовать?Источник: урок 2 программы Personal Corp.
Ссылку на скилл вставьте в то же сообщение. Если ссылки на несколько скиллов пришли сообщением в группу, скопируйте его целиком и попросите агента установить скиллы.
Самый большой каталог скиллов это skills.sh. В нём есть модерация, а популярность считается по числу установок. Самый популярный скилл каталога, find-skills, ищет в нём скиллы под вашу задачу. Поставьте его и попросите: «поищи скиллы, актуальные моим процессам».
Проверка: агент пересказал, что делает скилл, и вы знаете, где он установлен, глобально или в папке отдела.
Скиллы программы
Готовые скиллы программы лежат в открытом репозитории personal-corp-os. Их ставят по ссылке, как любой готовый скилл.
| Скилл | Что делает | Как вызвать |
|---|---|---|
grill-me | Задаёт вам вопросы о задаче по одному, прежде чем агент начнёт работать. interview-me из шаблона штаба это он же, переведённый на русский | по имени или по описанию |
corp-new | Создаёт отдел рядом со штабом: папку, файл правил, папку скиллов, задачи и связь со штабом в обе стороны | только /corp-new |
daily | Утром показывает, что делать сегодня по открытым задачам всех отделов и что просрочено | по имени или фразой «что сегодня» |
manager | После сессии записывает её итог в задачу. В режиме чтения отвечает, что с задачей сейчас | по имени или фразами «синкни сессию», «что по задаче» |
retro | В конце недели разбирает задачи всех отделов: что сделано, что застряло, что повторяется | только /retro |
Как daily, manager и retro держат день и неделю, разобрано в главе «Операционный цикл недели». Как corp-new заводит отдел, разобрано в главе «Отделы».
Когда вызывать и что вернётся
На карточках четыре скилла из того же репозитория: когда вызвать, что вернётся и какой командой позвать.
Шапка harness это четыре строки в начале сообщения: режим, модель, эффорт (глубина работы) и лимит субагентов. Режимов три: исполнитель, оркестратор и критик. gh-issues работает через программу gh, а avatar запускается только по имени.
Поставь скилл: https://github.com/serejaris/personal-corp-os/tree/main/skills/harnessИсточник: README репозитория personal-corp-os.
В конце ссылки замените harness на имя нужного скилла.
Весь набор одной установкой
Плагин ставит сразу все скиллы набора. Если нужны два-три, поставьте их по ссылке. В Claude Code плагин ставят в терминале двумя командами. Первая добавляет каталог, вторая ставит набор:
claude plugin marketplace add serejaris/personal-corp-os
claude plugin install personal-corp-os@personal-corp-osСкиллы из плагина вызывают с именем набора: /personal-corp-os:harness.
В Codex команды свои:
codex plugin marketplace add serejaris/personal-corp-os
codex plugin add personal-corp-os@personal-corp-osКак вызвать скилл
По имени. Скилл вызывают слэш-командой, следом пишут цель:
/interview-me
Цель: хочу в файле me.md собрать информацию о себе и моих текущих проектах.В Codex вместо слэша ставят знак доллара: $interview-me.
По описанию. Агент сам берёт скилл, когда ваша задача совпала с его описанием. Поэтому в описании стоят слова, которыми вы обычно ставите такую задачу. Скилл отдела исследований срабатывает на слово «исследование» примерно в 99% случаев. Надёжнее всего всё равно вызвать скилл явно и сказать, что нужно.
Строка disable-model-invocation: true в начале SKILL.md запрещает агенту вызывать скилл самому. Такой скилл запускается только по имени, так устроены retro и corp-new. Это поле читает Claude Code.
Как сделать свой скилл
Сигнал простой: вы попросили агента сделать одну и ту же работу второй раз. Попросите агента упаковать эту работу в скилл и шлифуйте его по ходу работы. Упаковать можно и после первого прогона, но обычно на втором вылезает то, чего в первый раз не было видно.
Начинать удобно с grill-me: агент сначала задаёт вопросы, вы показываете, что хотите получить, и прикладываете примеры. Эта техника разобрана в главе «Гриллинг».
Я повторяю эту работу руками уже [ВСТАВИТЬ_ЧИСЛО] раз: [ВСТАВИТЬ_ЦЕПОЧКУ_ДЕЙСТВИЙ].
Упакуй её в скилл: папка [ВСТАВИТЬ_ИМЯ], внутри SKILL.md.
За основу возьми мою последнюю сессию: [ВСТАВИТЬ_ФАЙЛ_ИЛИ_ССЫЛКУ].
Требования:
1. description в две строки: что делает, когда применять, ключевые слова задачи.
2. Шаги — из фактических действий моей сессии, без придуманных.
3. Разделы вход, выход и проверка результата.
4. Ни одного шага, которого не было в реальном прогоне.Источник: глава «Правила и скиллы агента» программы Personal Corp.
Если скилл делает не то, откройте SKILL.md, найдите мешающую строку и удалите или перепишите её. В interview-me из шаблона штаба есть строка, которая поручает агенту самому искать факты о вас. Из-за неё агент может пойти искать по всему компьютеру. Строку убирают или пишут в запросе: «не ищи информацию вне этой папки».
Скилл отдела называют по имени отдела с префиксом corp, например corp-research. Тогда чужой скилл с тем же именем не вызовет конфликт.
Скиллы и правила лежат в папках на вашем компьютере, и агент работает с ними там же. Следующая часть книги, «Удалённая работа с агентом», о том, как давать агенту задачи, когда вы не за ноутбуком: с телефона, из Telegram, через GitHub или на сервере.