Примеры скиллов Claude: разбор 5 репозиториев и что из них копировать

Коротко

Чужой SKILL.md читается за десять минут и даёт больше, чем очередной гайд «что такое skills». Пять репозиториев закрывают весь спектр, и каждый учит своему. anthropics/skills — эталон формата, там же лежат спецификация и пустой шаблон. kepano/obsidian-skills показывает скилл-справочник: агент путается в чужом формате — даём ему правила формата, а не процедуру. mattpocock/skills — процессные скиллы и разделение на те, что запускает человек, и те, что подхватывает модель сама. obra/superpowers — методология, где скиллы ссылаются друг на друга и включаются цепочкой. travisvn/awesome-claude-skills — каталог: по нему ищут, но по нему не учатся.

Копировать стоит структуру: короткое тело, тяжёлые детали вынесены в отдельные файлы, description написан как условие срабатывания, а не как реклама. Не копировать: чужие allowed-tools, привязку к чужому стеку и наборы «на всякий случай» — каждый вызванный скилл висит в контексте до конца сессии и стоит токенов на каждом ходу.

В чём задача

Скилл — это папка с файлом SKILL.md: YAML-шапка плюс инструкции в markdown. Формат простой, и именно поэтому «как написать скилл» — не проблема. Проблема в том, что первый свой скилл почти у всех получается пересказом того, что модель и так знает: три абзаца вежливых советов, которые ничего не меняют в поведении агента.

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

Если вы ещё не разбирались с базой — формат, установка, где лежат файлы — начните с гайда по Claude Skills, дальше эта статья ляжет ровнее. И отдельно стоит понимать чем скиллы отличаются от MCP и от вызова API: половина «скиллов» в каталогах на самом деле должна была быть MCP-сервером.

Пошагово

Пять репозиториев ниже я расставил не по популярности, а по тому, чему у них учиться. Звёзды приведены по страницам репозиториев на июль 2026 — цифра пляшет от недели к неделе, ориентироваться на неё как на признак качества не стоит.

Шаг 1. Начните с spec и template в anthropics/skills. В репозитории четыре директории: skills с примерами по категориям, spec со спецификацией, template с болванкой и .claude-plugin. Пятнадцать минут на template экономят день переписывания. Заодно посмотрите документные скиллы (docx, pdf, pptx, xlsx) — они устроены иначе, чем остальные: инструкция тонкая, а работу делают python-скрипты рядом. Это ответ на вопрос «а если задачу должен решать код, а не текст».

Шаг 2. Посмотрите на kepano/obsidian-skills, чтобы понять скилл-справочник. Пять скиллов (obsidian-markdown, obsidian-bases, json-canvas, obsidian-cli, defuddle) не описывают процедуру. Они описывают формат: как выглядят вики-ссылки, что такое callout, какой синтаксис у Bases. Агент писал валидный markdown, но неправильный для Obsidian — не потому что глупый, а потому что не знал правил. Подробный разбор набора — в статье про скиллы от автора Obsidian. Это самый переносимый паттерн: у вас в проекте наверняка есть свой внутренний формат, про который модель не знает ничего.

Шаг 3. У mattpocock/skills смотрите не содержание, а разметку вызова. Скиллы там разложены на две группы — те, что запускает человек (grill-me, handoff, teach), и те, что модель включает сама, когда видит подходящий момент. В Claude Code это управляется двумя полями шапки: disable-model-invocation: true (только по команде) и user-invocable: false (только автоматически). Разница не косметическая: у скилла, доступного модели, описание постоянно висит в контексте, чтобы она знала о его существовании. Детальный разбор набора — здесь.

Шаг 4. В obra/superpowers изучайте композицию. Скиллы ссылаются друг на друга: брейншторм отрабатывает до кода, TDD включается на реализации, изоляция веток — перед работой. Ставится всё это плагином через маркетплейс, и в этом же главная ловушка: набор спроектирован как цельная методология. Выдернуть из него один скилл можно, но он будет ссылаться на соседей, которых вы не поставили.

Шаг 5. Каталог — последним, а не первым. travisvn/awesome-claude-skills полезен, когда вы уже знаете, что ищете: там разбивка на официальные и коммунальные скиллы, инструменты и раздел про безопасность. Открывать его первым — верный способ поставить двадцать скиллов и не понять ни одного.

Проверка результата

Когда переносите чужое решение в свой проект, прогоните его по четырём вопросам. Все четыре — про поведение агента, а не про красоту файла.

Описание срабатывает? Спросите у агента что-то из области скилла, не называя его. Если не подхватил — переписывайте description в терминах пользовательской формулировки, а не своей. В листинге скиллов текст description вместе с when_to_use обрезается на 1536 символах (документация Claude Code), так что ключевой случай ставьте первым.

Тело помещается в бюджет? Официальная рекомендация — держать SKILL.md короче 500 строк, детали выносить в отдельные файлы. Причина в том, что содержимое вызванного скилла попадает в разговор один раз и остаётся до конца сессии; при автосжатии контекста возвращаются первые 5000 токенов каждого скилла, а общий бюджет на все — 25 000 токенов. Всё, что не влезло, тихо пропадает.

Скилл меняет поведение? Сравните два прогона одной задачи — со скиллом и без. Если разницы нет, вы написали пересказ здравого смысла. Это нормальный промежуточный результат, но его надо увидеть.

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

Подводные камни

Чужой скилл тащит чужой стек. Наборы вроде mattpocock/skills заточены под TypeScript и Node: пре-коммит-хуки, свой раннер тестов, свои соглашения по задачам. На другом стеке половина инструкций превращается в шум, который агент честно пытается выполнить.

Лицензия не всегда «бери и делай». В anthropics/skills основная часть под Apache 2.0, а документные скиллы (skills/docx, skills/pdf, skills/pptx, skills/xlsx) — source-available: исходники открыты, но это не open source, и переносить их в свой продукт нельзя. У kepano/obsidian-skills, mattpocock/skills и obra/superpowers — MIT. Проверяйте перед копированием в коммерческий репозиторий.

Скиллы — это исполняемые инструкции, а не документация. В папке скилла может лежать скрипт, который скилл предлагает запустить, а allowed-tools — заранее разрешить его запуск без вопроса. Ставить набор из каталога, не открыв файлы, — это ровно то же самое, что запускать чужой bash-скрипт не глядя.

Много скиллов — хуже, чем мало. Описания всех скиллов, доступных модели, лежат в контексте постоянно. Двадцать установленных наборов — это постоянный налог на каждый запрос и повышенный шанс, что агент подхватит не тот скилл. Начинайте с трёх, добавляйте по одному.

Копировать чужую формулировку задачи бесполезно, если своя размытая. Скилл не чинит непонятное ТЗ — он только фиксирует повторяющуюся процедуру. Если агент переделывает работу по три раза, проблема обычно в постановке: об этом отдельно — как поставить задачу, чтобы агент понял.

Частые вопросы

С чего начать, если репозиториев много, а времени мало?

Откройте template в anthropics/skills и один скилл из kepano/obsidian-skills — этого хватает, чтобы написать первый рабочий скилл в тот же вечер. Остальные три репозитория читайте, когда упрётесь: в композицию, в разделение ролей вызова или в поиск готового решения.

Скиллы из этих репозиториев работают только в Claude Code?

Нет. Формат Agent Skills — открытый стандарт, и наборы вроде obsidian-skills заявляют совместимость с Claude Code, Codex CLI и opencode. Установка отличается: путями (~/.claude/skills/<имя>/SKILL.md для личных, .claude/skills/ для проектных) или менеджером плагинов конкретного агента. Само содержимое SKILL.md — обычный markdown, читать и разбирать его можно вообще без установленного агента.

Как понять, что задача решается не скиллом, а чем-то другим?

Если нужны свежие данные из внешней системы или вызовы чужого API — это MCP-сервер. Если нужна одна короткая инструкция «всегда делай так» — это строчка в CLAUDE.md. Скилл оправдан, когда есть повторяемая многошаговая процедура или объёмный справочный материал, который жалко держать в контексте постоянно. Разбор границы — в статье про разницу между MCP, скиллами и API.

Стоит ли выкладывать свои скиллы в открытый доступ?

Публикация дисциплинирует: то, что нельзя объяснить постороннему за 500 строк, обычно и своему агенту объяснено плохо. Но проверьте файлы на внутренние пути, имена сервисов и ключи — скиллы часто пишутся «для себя» и наследуют детали инфраструктуры. И помните, что чужие звёзды на репозитории ничего не говорят о том, подойдёт ли набор вашему стеку.