Скиллы: GitHub и skills.sh

Ты поставил Claude Code, погонял его на паре задач и почувствовал кайф. А теперь хочется большего: чтобы агент не просто отвечал, а делал сложные вещи по-взрослому — ревьюил код, готовил презентации, дебажил по шагам, работал с конкретным API. Для этого есть скиллы. Это самый недооценённый способ прокачать агента, и разобраться в нём можно за десять минут. Давай по-человечески: что это, откуда брать, как поставить и как не превратить агента в свалку.

Что такое скилл и зачем он вообще

Скилл (навык) — это папка с файлом SKILL.md внутри. В этом файле обычным markdown написана инструкция: как делать какую-то конкретную задачу. Иногда рядом лежат вспомогательные скрипты или файлы-ресурсы, которые навык использует. И всё. Никакой магии, никакого бинарника — просто упакованная процедура, которую агент подгружает, когда задача совпадает с тем, для чего навык создан.

Самая честная аналогия — рабочая инструкция для нового сотрудника. Представь, что ты нанял толкового, но незнакомого с твоими порядками человека. Можно каждый раз объяснять заново, как у вас принято делать ревью кода или собирать отчёт. А можно один раз написать понятную памятку, положить в общую папку — и человек открывает её ровно тогда, когда берётся за эту задачу. Скилл — это и есть такая памятка для агента.

Зачем это нужно на практике. Без скилла ты каждый раз объясняешь Claude Code, КАК сделать работу: «проверь код вот по таким критериям», «структурируй презентацию вот так», «при дебаге сначала воспроизведи баг, потом сужай». Сегодня объяснил подробно, завтра поленился — и результат поплыл. Со скиллом процедура зафиксирована один раз. Агент идёт по проверенному маршруту, а не сочиняет его заново под настроение. Качество становится стабильным и предсказуемым — а это в работе с агентом ценнее, чем разовая вспышка гениальности.

Главная мысль: скилл — это не «магическая прокачка», а зафиксированный опыт. Ты учишь агента одной процедуре один раз, и дальше переиспользуешь её бесконечно. Хороший набор скиллов = твой личный свод рабочих стандартов, который агент соблюдает за тебя.

Откуда брать скиллы

Тебе не нужно писать всё с нуля. Сообщество уже наделало кучу готовых навыков, и есть два основных места, откуда их тянут.

GitHub — открытые репозитории

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

Скилл с GitHub — это просто папка в репозитории. Чтобы его поставить, ты клонируешь репозиторий или копируешь нужную папку со скиллом в свой каталог скиллов (про каталоги — ниже). Конкретные команды и структуру всегда смотри в README конкретного репозитория: авторы пишут, куда класть и как подключать. Не угадывай флаги и пути по памяти — открой инструкцию репозитория в момент установки, она там есть.

skills.sh — каталог сообщества

Второе место — skills.sh, реестр-каталог скиллов сообщества. Удобнее, чем рыться по GitHub вручную: можно искать навыки по теме и ставить их более-менее единообразно. Это как магазин навыков — пришёл, нашёл по названию или задаче, забрал.

Точные команды установки и адреса на skills.sh периодически меняются, поэтому я не буду тут диктовать тебе конкретную строчку, которая через месяц устареет. Принцип всегда один и тот же, и его достаточно, чтобы не потеряться:

1. Нашёл скилл под свою задачу (через поиск на skills.sh или в репозитории на GitHub).
2. Установил или скопировал его в свой каталог скиллов.
3. Агент подхватывает навык сам — и дальше использует, когда задача подходит.

Не зубри команды — держи в голове маршрут «найти → положить в каталог скиллов → агент подхватил». Конкретные флаги и URL сверяй в источнике в момент установки. Реестры и репозитории живут своей жизнью и обновляются, а принцип не меняется.

Как поставить — принцип

Технически установка скилла — это положить его папку в правильное место. Каталоги скиллов бывают двух уровней:

• Пользовательский — скиллы, доступные тебе во всех проектах. Сюда кладёшь то, чем пользуешься постоянно вне зависимости от задачи (ревью кода, дебаг, ресёрч).
• Проектный — скиллы внутри конкретного проекта. Сюда — узкое, что нужно только этому репозиторию: работа с его API, его стилевые правила, его процедуры деплоя.

Логика простая: универсальное — к пользователю, специфичное — в проект. Точные пути каталогов смотри в актуальной документации Claude Code и в инструкции скилла — я намеренно не вписываю их сюда, чтобы ты не наткнулся на устаревший путь. Скопировал папку в нужный каталог — на этом установка кончилась. Перезапусти сессию, если агент не увидел навык сразу.

Как агент понимает, когда применить скилл

Вот тут самое интересное, и это объясняет половину успеха. Агент выбирает навык по его описанию и триггеру, прописанным в SKILL.md. Грубо говоря, в начале файла навык сам про себя говорит: «я для того-то, применяй меня, когда задача про это». Когда ты даёшь агенту запрос, он сопоставляет твою задачу с этими описаниями и подтягивает подходящий навык.

Из этого следует одна очень практичная вещь: качество описания решает всё. Если описание размытое — «помогает с кодом», — агент не поймёт, в какой момент его звать, и навык будет простаивать. Если описание чёткое — «ревью pull request: ищет баги, проверяет тесты, оценивает читаемость» — агент сам сообразит подтянуть его в нужный момент. Поэтому, когда оцениваешь чужой скилл или пишешь свой, смотри в первую очередь на описание-триггер, а не только на тело инструкции.

Гигиена набора — не тащи всё подряд

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

• Безопасность. Скилл может содержать скрипты, которые выполняются. Ставь навыки только из источников, которым доверяешь. Перед установкой чего-то незнакомого — загляни внутрь, посмотри, что за скрипты там лежат. Это не паранойя, это базовая гигиена, как не запускать случайный exe из интернета.
• Шум. Каждый лишний скилл — это лишние описания, которые агент держит в поле зрения. Раздутый набор размывает фокус: агент чаще промахивается с выбором навыка. Меньше, но точнее под твои реальные задачи — лучше, чем «на всякий случай всё».
• Чистка. Раз в какое-то время пройдись по списку и выкинь то, чем не пользуешься. Не жалей: удалённый скилл всегда можно поставить заново за минуту, а мёртвый груз в наборе мешает каждый день.

Правило большого пальца: набор скиллов — это рабочий ящик с инструментами, а не склад. В ящике лежит то, чем ты реально работаешь на этой неделе. Всё остальное — на полке в магазине, заберёшь когда понадобится.

Свой первый скилл

Самый недооценённый шаг — написать скилл самому. Это проще, чем кажется, потому что скилл — это всего лишь папка и markdown-файл с инструкцией. Не нужно быть программистом.

Начни не с абстракции, а с одной своей повторяющейся задачи. Подумай: что ты объясняешь агенту чаще всего? Может, у тебя свой формат коммитов. Или ты каждый раз диктуешь, как оформлять README. Или у тебя есть личный чек-лист перед тем, как считать фичу готовой. Вот это и есть кандидат в первый скилл.

Дальше — простая схема:

1. Создай папку с понятным именем.
2. Положи внутрь файл SKILL.md.
3. В начале файла коротко и чётко опиши, для чего навык и когда его применять — это твой триггер, по нему агент будет его звать.
4. Ниже — сама инструкция: шаги, критерии, примеры. Пиши так, будто объясняешь толковому новичку, который видит твою задачу впервые.
5. Положи папку в каталог скиллов и проверь на реальной задаче.

Первый блин может выйти комом — это нормально. Прогнал скилл на задаче, увидел, что агент понял не так, поправил формулировку в SKILL.md, прогнал снова. Через две-три итерации у тебя будет рабочий навык, который экономит время каждый день.

Что дальше

Скиллы — это переход от «я каждый раз объясняю агенту, как делать» к «агент уже умеет, потому что я научил его один раз». Начни с малого: поставь один-два готовых навыка под задачи, которые делаешь регулярно, поживи с ними неделю, прочувствуй разницу в стабильности. Потом напиши свой первый скилл из самой надоевшей повторяющейся задачи. Этого достаточно, чтобы агент из «умной болталки» превратился в инструмент, который работает по твоим стандартам. А конкретные команды установки и пути каталогов — всегда сверяй в источнике в момент, когда ставишь: это единственное, что я просил бы тебя не брать на веру по памяти.