Оплати Подписку
AI

Claude Skills: полный гайд от синтаксиса SKILL.md до Deep Research и сетевых инструментов

Claude Skills: полный гайд от синтаксиса SKILL.md до Deep Research и сетевых инструментов

Skills — это не функция только для терминала. После октября 2025 года, когда Anthropic официально запустила систему Skills, она стала доступна сразу на трёх платформах: в claude.ai (через веб-интерфейс, на всех планах включая Free), в Claude Code (CLI, через файловую систему) и через API (программно, параметром skills).

Один и тот же файл SKILL.md работает везде без изменений — в этом и есть смысл открытого стандарта, который в декабре 2025-го принял OpenAI для Codex CLI.

Теперь экосистема Skills — это больше 40 000 публичных репозиториев, официальный anthropics/skills на 87 000+ звёзд и инструменты вроде skill-creator, которые позволяют написать свой скилл за 20 минут.

Эта статья — технический гайд по всем трём точкам входа: от загрузки ZIP в claude.ai до интеграции Deep Research в CLI и настройки среды для работы с Anthropic API через зарубежный IP.

TL;DR

  • Skills — это папки с файлом SKILL.md, содержащим YAML-фронтматтер и инструкции в Markdown. Claude загружает их динамически по контексту или по команде /skill-name.
  • Доступны на всех планах claude.ai включая Free: Settings → Capabilities (включить code execution) → Customize → Skills. Загрузка — ZIP-архив с GitHub.
  • В Claude Code скиллы кладутся в ~/.claude/skills/ (глобально) или .claude/skills/ (проектно). Живое обнаружение изменений — перезапуск не нужен.
  • Для работы с Anthropic API из России нужен зарубежный IP: таймауты и ошибки соединения лечатся настройкой переменных окружения.
  • Экосистема уже огромная: awesome-claude-skills, skillsmp.com, официальный anthropics/skills, репозитории deep research и специализированные коллекции вроде polyakov claude skills.

Архитектура системы: три платформы, один стандарт

Один SKILL.md — три точки входа. Это ключевое свойство системы, которое часто упускают из виду.

  • claude.ai — самый простой путь. Скачиваешь ZIP-архив скилла с GitHub, заходишь в Settings → Capabilities (убеждаешься, что code execution включён) → Customize → Skills → загружаешь файл. Всё. Скилл автоматически триггерится по контексту. Доступно на всех планах, включая Free.
  • Claude Code (CLI) — кладёшь папку скилла в ~/.claude/skills/ (глобально для всех проектов) или .claude/skills/ (только для текущего проекта, шарится через git). Поддерживает расширенные возможности: !команды для препроцессинга, $ARGUMENTS, plugin marketplace, живое обнаружение изменений без перезапуска сессии.
  • API — передаёшь скиллы программно через параметр skills в запросе. Используется для встраивания в собственные продукты.

Skills работают по принципу прогрессивного раскрытия контекста. Это ключевое архитектурное решение.

Claude сначала загружает только метаданные каждого скилла — примерно 100 токенов на скилл. На основании поля description он решает, нужен ли этот скилл для текущей задачи. Если да — загружает тело SKILL.md целиком (обычно до 5 000 токенов). Вспомогательные файлы из scripts/ и references/ загружаются только в момент выполнения конкретных шагов.

Это принципиально отличает Skills от MCP-серверов. MCP — это кухня: ножи, кастрюли, доступ к внешним API. Skill — рецепт, который описывает, как этими инструментами пользоваться. Их можно и нужно комбинировать.

Структура конфигурации SKILL.md: синтаксис и поля фронтматтера

Минимальный валидный скилл — это два поля: name и description. Всё остальное опционально.

--- name: commit-formatter description: > Форматирует git-коммиты по Conventional Commits. Используй, когда пользователь упоминает коммит, git message, или просит написать/отформатировать коммит. --- # Commit Formatter Форматируй все коммиты строго по Conventional Commits 1.0.0. ## Формат <тип>(<область>): <описание> ## Правила - Глагол в повелительном наклонении, без точки, максимум 72 символа - Breaking changes: добавляй `!` после типа ## Пример Input: "добавил авторизацию через JWT" Output: `feat(auth): implement JWT-based authentication`

Расширенные поля фронтматтера для боевых скиллов:

  • allowed-tools — ограничивает набор инструментов. Например, Bash(git *) или Read(*.py). Критически важно для security-скиллов.
  • context — режим выполнения: fork запускает скилл в изолированном контексте.
  • agent — тип агента: Explore, Edit, и другие.
  • disable-model-invocation — скилл вызывается только вручную через /skill-name.
  • compatibility — зависимости и требуемые инструменты.

Директория скилла может выглядеть так:

my-skill/ ├── SKILL.md # Основной файл (обязателен) ├── scripts/ │ └── process.py # Скрипт, который Claude может запустить ├── templates/ │ └── output.md # Шаблон вывода └── references/ └── docs.md # Справочная документация

Неочевидный момент про description: Claude склонен к undertriggering — не использовать скилл, даже когда он подходит.

Официальная рекомендация Anthropic — делать description немного «напористым»: явно перечислять контексты, в которых нужно применять скилл, включая неочевидные формулировки запросов.

Динамический контекст через !-команды и $ARGUMENTS

Синтаксис !команда`` позволяет вставлять в скилл живые данные ещё до отправки Claude. Это не то, что Claude выполняет — это препроцессинг на стороне Claude Code.

--- name: pr-summary description: Суммирует изменения в pull request. Используй при работе с PR. context: fork allowed-tools: Bash(gh *) --- ## Контекст pull request - Diff: !`gh pr diff` - Комментарии: !`gh pr view --comments` - Изменённые файлы: !`gh pr diff --name-only` ## Задача Напиши краткое summary этого PR для team update.

Claude получает уже заполненный промпт с реальными данными. Это значительно мощнее, чем просто инструкция «зайди и посмотри PR».

Для параметризованных скиллов — $ARGUMENTS:

--- name: fix-issue description: Исправляет GitHub issue по номеру. disable-model-invocation: true --- Исправь GitHub issue $ARGUMENTS, следуя нашим coding standards. 1. Прочитай описание issue 2. Реализуй исправление 3. Напиши тесты 4. Создай коммит

Вызов: /fix-issue 347 — и Claude получает "Исправь GitHub issue 347".

Обзор GitHub-репозиториев: awesome-claude-skills и основные подборки

Экосистема community-скиллов к марту 2026 года насчитывает десятки тысяч репозиториев. Найти нужный вручную — задача нетривиальная.

Основные агрегаторы и каталоги, на которые стоит ориентироваться:

  • travisvn/awesome-claude-skills — курированный список с разбивкой по категориям: разработка, безопасность, продуктивность, интеграции. Хороший старт для поиска готового решения.
  • ComposioHQ/awesome-claude-skills — фокус на action-скиллах: Gmail, Slack, GitHub, Asana и 1000+ других сервисов через Composio.
  • BehiSecc/awesome-claude-skills — более широкий охват, включая security, research и специфические интеграции.
  • VoltAgent/awesome-agent-skills — официальные скиллы от Anthropic, Google, Vercel, Stripe, Cloudflare, Trail of Bits и других. Более 500 позиций.
  • anthropics/skills — официальный репозиторий Anthropic. Здесь живут docx, pdf, pptx, xlsx, skill-creator, webapp-testing, mcp-builder. Apache 2.0.
  • skillsmp.com — независимый маркетплейс с поиском по 500 000+ скиллам, синхронизируется с GitHub.

Отдельного упоминания заслуживают специализированные коллекции. Запросы вроде polyakov claude skills в поиске — сигнал о том, что люди ищут авторские подборки конкретных разработчиков. Если ты ведёшь GitHub-аккаунт и публикуешь скиллы под своим именем, Google и Яндекс начнут ранжировать тебя именно по таким запросам. Это хорошая мотивация структурировать личную коллекцию в отдельный репозиторий.

Установка claude skills: как скачать и подключить репозиторий

claude skills download сводится к трём командам для CLI или двум кликам для claude.ai.

Путь через claude.ai (без терминала):

  1. Открой нужный репозиторий на GitHub.
  2. Скачай папку скилла как ZIP-архив (Code → Download ZIP, или используй утилиты типа download-directory.github.io).
  3. Зайди в Settings → Capabilities → убедись, что code execution включён → Customize → Skills → загрузи ZIP.

Путь через Claude Code (терминал):

Глобальная установка скилла из GitHub:

# Клонируем репозиторий или скачиваем конкретный скилл git clone https://github.com/glebis/claude-skills.git /tmp/claude-skills # Копируем нужный скилл cp -r /tmp/claude-skills/deep-research ~/.claude/skills/ # Проверяем доступность claude # → спрашиваем: "What skills are available?"

Для проектных скиллов (шарятся через git с командой):

mkdir -p .claude/skills cp -r /tmp/skill-name .claude/skills/ git add .claude/skills/ git commit -m "feat: add deep-research skill"

Установка через официальный plugin marketplace (если подключён):

/plugin marketplace add anthropics/skills /plugin install document-skills@anthropic-agent-skills

Через npm-обёртки (для кросс-агентных пакетов):

npx skills add anthropics/claude-code --skill frontend-design npx skills list

Важный нюанс для claude skills github — живое обнаружение изменений работает только для скиллов из директорий, добавленных через --add-dir. Если ты правишь ~/.claude/skills/ во время сессии, изменения применяются без перезапуска.

Интеграция deep research skill claude code: 8-фазный пайплайн

199-biotechnologies/claude-deep-research-skill — community-реализация Deep Research для Claude Code с 8-фазным пайплайном, которая по заявленным характеристикам превосходит встроенный Advanced Research в Claude Desktop. Ключевые возможности:

  • 4 режима: Quick (3 фазы, ~2–5 мин), Standard (6 фаз, ~5–10 мин), Deep (8 фаз, ~10–20 мин), UltraDeep (8+ фаз, ~20–45 мин).
  • Graph-of-Thoughts — нелинейное ветвление гипотез, а не линейный поиск.
  • CiteGuard — валидация цитат и детекция галлюцинаций.
  • Auto-Continuation — рекурсивный запуск субагентов для отчётов 50 000+ слов.

Установка:

cp -r deep-research ~/.claude/skills/

Структура файлов скилла:

deep-research/ ├── SKILL.md # Основной файл (11 KB) ├── research_engine.py # Движок оркестрации (16 KB) └── utils/ ├── citation_manager.py # Отслеживание источников └── source_evaluator.py # Скоринг доверия к источнику (0–100)

Запуск напрямую из командной строки:

python3 ~/.claude/skills/deep-research/research_engine.py \ --query "Сравнение архитектур трансформеров для кодогенерации" \ --mode deep

Skill creator claude: создаём скилл в интерактивном режиме

skill-creator — официальный скилл из anthropics/skills, который помогает создавать другие скиллы. Это мета-инструмент: скилл для написания скиллов.

Установка через plugin marketplace или вручную:

cp -r anthropics/skills/skills/skill-creator ~/.claude/skills/

После этого в Claude Code достаточно сказать: "Создай скилл для code review по нашим стандартам". Он задаст уточняющие вопросы, предложит структуру SKILL.md и проверит, что description сформулирован достаточно чётко для триггеринга.

Самая полезная встроенная функция skill-creator — оптимизационный цикл для описания. Он разбивает тест-кейсы в соотношении 60/40 (train/test), замеряет trigger rate, генерирует улучшенные варианты description и выбирает лучший по тестовой выборке. Это решает главную боль авторов скиллов: скилл есть, но Claude его не использует.

Чтобы оплатить Anthropic API для полноценной работы с Claude Code в России, можно воспользоваться сервисом для оплаты зарубежных подписок рублями — Оплати Подписку. Сервис выдаёт реквизиты карты, которые вводятся напрямую на платёжной странице Anthropic.

Сетевые инструменты и настройка окружения для Anthropic API

При работе с Claude Code через зарубежный IP возникают характерные проблемы: таймауты при первом подключении, ошибки ETIMEDOUT и ECONNRESET. Это не баг Claude Code — это следствие нестабильного или высоколатентного канала через инструменты маршрутизации.

Решение на уровне переменных окружения:

# Увеличиваем таймаут для API-запросов (в миллисекундах) export ANTHROPIC_API_TIMEOUT=60000 # Указываем прокси-шлюз, если используется настройка сетевого шлюза export HTTPS_PROXY=http://127.0.0.1:10809 export HTTP_PROXY=http://127.0.0.1:10809 # Для Node.js-окружения Claude Code export NODE_OPTIONS="--max-old-space-size=4096"

Для hysteria2 как инструмента маршрутизации трафика — работа аналогична: hysteria2-клиент поднимает локальный socks5/http-прокси, переменная HTTPS_PROXY перенаправляет туда трафик от Claude Code. Принцип тот же, что и для любого другого инструмента смены виртуального местоположения. hysteria2 skill для claude code в буквальном смысле — это скилл-обёртка, который перед запуском проверяет доступность внешнего IP и при необходимости переключает интерфейс маршрутизации.

Пример минимальной bash-обёртки для проверки доступности API:

#!/bin/bash # check-api-connectivity.sh API_ENDPOINT="https://api.anthropic.com" TIMEOUT=10 check_connection() { curl -s --max-time "$TIMEOUT" \ -o /dev/null \ -w "%{http_code}" \ -H "x-api-key: ${ANTHROPIC_API_KEY}" \ "${API_ENDPOINT}/v1/models" 2>/dev/null } STATUS=$(check_connection) if [ "$STATUS" = "200" ]; then echo "✓ API доступен (${STATUS})" elif [ "$STATUS" = "000" ]; then echo "✗ Нет соединения. Проверь инструменты маршрутизации." echo " Текущий HTTPS_PROXY: ${HTTPS_PROXY:-не задан}" exit 1 else echo "! API вернул ${STATUS}. Проверь API-ключ." exit 1 fi

Для автоматизации — оберни в скилл с allowed-tools: Bash(curl *) и добавь в pre-session hook.

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

Безопасность: что проверять перед установкой стороннего скилла

Каждый скилл — это исполняемый код в твоём окружении. Anthropic прямо предупреждает: скиллы могут содержать prompt injections, tool poisoning и скрытые malware-пейлоады.

Чеклист перед установкой:

  • Прочитай SKILL.md полностью — обращай внимание на allowed-tools. Скилл с Bash(*) без ограничений — красный флаг.
  • Проверь скрипты в scripts/ — никаких сетевых вызовов на сторонние хосты, никаких hardcoded credentials.
  • Убедись, что description описывает именно то, что заявлено в README.
  • Для production-окружений — изолируй Claude Code в Docker-контейнере с ограниченными правами.
  • API-ключи никогда не должны появляться в SKILL.md. Только через переменные окружения или MCP-конфигурацию.

Инструмент agnix из BehiSecc/awesome-claude-skills умеет валидировать SKILL.md по 156 правилам с автофиксом — полезно и для своих скиллов, и для проверки чужих.

FAQ: частые вопросы про claude skills как использовать

Скилл не триггерится — что делать?

Первым делом — переписать description. Claude принимает решение загрузить скилл только на основании этого поля. Если формулировка абстрактная или не совпадает с тем, как реально звучат запросы, скилл будет молчать. Проверь через "What skills are available?" что скилл вообще виден.

Можно ли использовать один скилл в нескольких проектах?

Да. Глобальные скиллы в ~/.claude/skills/ доступны во всех сессиях. Проектные в .claude/skills/ — только в рамках проекта и шарятся через git.

Чем Skills отличаются от MCP-серверов?

MCP добавляет инструменты — функции, которые Claude может вызывать. Skills добавляют инструкции — паттерны поведения и рабочие процессы. Они дополняют друг друга: MCP-сервер даёт доступ к Sentry, скилл описывает, как именно проводить code review с этими данными.

Работают ли community-скиллы с claude.ai или только с Claude Code?

На обеих платформах. В claude.ai — загружаешь ZIP через Customize → Skills, скилл активируется автоматически по контексту. В Claude Code — кладёшь папку в ~/.claude/skills/, получаешь дополнительно !команды, $ARGUMENTS и plugin marketplace. Один и тот же SKILL.md работает везде без изменений.

Сколько скиллов можно держать активными?

Технических ограничений на количество нет. Но каждый скилл добавляет ~100 токенов в контекст (метаданные). При 50+ активных скиллах могут быть заметные накладные расходы на каждый запрос.

Итог

Система Skills — это не надстройка для удобства, а структурный сдвиг в том, как работает Claude Code. Модульность, открытый стандарт, GitHub-экосистема с тысячами готовых решений — всё это превращает агента из универсального помощника в специализированный инструмент, заточенный под конкретный стек и процессы команды.

Ключевые точки входа для начала работы:

  • anthropics/skills — официальные скиллы, включая skill-creator и document-skills.
  • travisvn/awesome-claude-skills или BehiSecc/awesome-claude-skills — курированные подборки для поиска готовых решений.
  • skillsmp.com — claude skills marketplace с поиском по 500 000+ репозиториям.
  • 199-biotechnologies/claude-deep-research-skill — если нужен настоящий deep research прямо из терминала.

Anthropic API требует зарубежного биллинга. Если нужно оплатить подписку Claude Pro, Max или пополнить API-кредиты рублями — Оплати Подписку решает этот вопрос без открытия зарубежных счетов.