В этой статье разбирается, что такое навык Claude Code на самом деле, как устанавливать готовые навыки из маркетплейса Anthropic, как вручную разместить пользовательский файл SKILL.md и как написать собственный навык с нуля на Linux.

Многие полагают, что Claude Code решает любую задачу одинаково: анализирует запрос и на ходу выбирает оптимальный подход. Но это не так. Для повторяющихся действий он может обратиться к папке на диске, извлечь инструкции, которые вы или Anthropic уже написали для конкретной ситуации, и следовать им, а не переизобретать процесс каждый раз.

Эта папка и есть навык. Как только вы научитесь устанавливать и создавать навыки, Claude Code перестанет воспринимать рутинные задачи системного администрирования как новые.

Навык можно представить как многократно используемый набор инструкций, который Claude Code автоматически применяет при обнаружении подходящей задачи. Вместо того чтобы каждый раз объяснять одни и те же шаги, вы записываете их один раз в файл SKILL.md, и Claude Code задействует их при необходимости. Это экономит время, делает рабочий процесс согласованным и значительно упрощает повторяющиеся действия.

Что такое навык Claude Code на самом деле

Навык Claude Code - это папка, содержащая файл SKILL.md, а также опциональные скрипты, справочные документы или шаблоны. Файл SKILL.md состоит из двух частей: компактного блока YAML-фронтматтера, определяющего имя и описание навыка, и последующих инструкций в формате Markdown, которые объясняют Claude Code, как выполнить задание.

Claude Code загружает не все навыки при каждом запросе. Сначала он проверяет описания доступных навыков. Если запрос совпадает с описанием, он загружает соответствующий навык и следует его инструкциям.

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

Навыки Claude Code соответствуют открытому стандарту Agent Skills от Anthropic. Это значит, что созданный вами навык без изменений можно использовать и в Claude.ai, и через Claude API.

Примеры из этого руководства проверены на Ubuntu 24.04 LTS и RHEL 9, но команды будут работать одинаково на любом дистрибутиве Linux, поддерживаемом Claude Code, поскольку они не привязаны к специфичным путям.

Предварительные требования: установка Claude Code

Перед началом работы с навыками необходимо установить Claude Code.

Самый простой способ: использовать официальный установщик, не требующий Node.js:

curl -fsSL https://claude.ai/install.sh | bash

Если вы предпочитаете установку через npm, убедитесь, что у вас установлена версия Node.js 22 или новее:

npm install -g @anthropic-ai/claude-code

Не запускайте npm-установку с sudo. Установка глобальных npm-пакетов от имени root может привести к проблемам с правами, которые помешают будущим обновлениям. Если вы столкнулись с ошибками прав доступа, лучшим вариантом будет использование nvm для управления Node.js, поскольку он устанавливает всё в домашний каталог.

После завершения установки проверьте, что Claude Code доступен:

claude --version

Если команда выводит номер версии, Claude Code установлен корректно. При первом запуске выполните:

claude

Затем пройдите аутентификацию, чтобы войти в учётную запись Anthropic.

Если вы устанавливаете Claude Code впервые и вам нужна пошаговая инструкция, обратитесь к курсу Claude Code for Linux Sysadmins.

Установка готовых навыков из маркетплейса Anthropic

Anthropic предоставляет коллекцию готовых навыков в репозитории anthropics/skills на GitHub. В неё входят навыки для работы с документами, а также примеры для разработки и корпоративных сценариев. Вместо ручной загрузки вы можете добавить репозиторий в качестве маркетплейса прямо из Claude Code.

Запустите сеанс Claude Code и выполните:

/plugin marketplace add anthropics/skills

Это зарегистрирует маркетплейс, но не установит отдельные навыки.

Чтобы установить конкретные наборы навыков, выполните:

/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Пояснение компонентов:

  • /plugin install - устанавливает плагин из зарегистрированного маркетплейса.
  • document-skills и example-skills - это названия плагинов.
  • @anthropic-agent-skills - это маркетплейс, добавленный на предыдущем шаге.

После установки плагина для его использования не нужно запускать специальных команд. Просто опишите, что вы хотите сделать. Claude Code сопоставит запрос с описаниями установленных навыков и автоматически загрузит подходящий при совпадении.

Ручная установка навыка

Не все навыки поступают из маркетплейса Anthropic. Вы можете использовать навыки, которыми поделились другие, или создавать собственные. Claude Code находит их по расположению, поэтому никакой загрузки или регистрации не требуется.

Чтобы навык был доступен для всех проектов в системе, создайте каталог в домашней папке:

mkdir -p ~/.claude/skills/log-triage

Чтобы навык был доступен только в текущем проекте, создайте его в каталоге .claude вашего проекта:

mkdir -p .claude/skills/log-triage

Затем поместите файл SKILL.md внутрь созданной папки.

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

Если навык и пользовательская слеш-команда имеют одинаковое имя, Claude Code отдаёт приоритет навыку.

Если вы хотите собрать полноценный набор личных навыков автоматизации, курс AI for Linux расскажет, как интегрировать Claude Code в повседневную работу с Linux и системное администрирование.

Создание собственного SKILL.md

Если вам приходится многократно давать Claude Code одни и те же инструкции, разумнее создать пользовательский навык, а не вставлять каждый раз один и тот же запрос.

Например, если вы всегда просите Claude Code проверять journalctl, сопоставлять метки времени и искать недавние обновления пакетов при сбое службы, эти шаги можно сохранить в навыке.

Сначала создайте каталог навыка и файл SKILL.md:

mkdir -p ~/.claude/skills/log-triage
nano ~/.claude/skills/log-triage/SKILL.md

Базовому навыку достаточно секции YAML-фронтматтера и следующих за ней инструкций:

---
name: log-triage
description: Use this skill when a systemd service has crashed or is
  failing to start, or when asked to investigate why a service died.
  Correlates journalctl output with recent package changes.
---

# Log Triage

1. Run `systemctl status <service>` to confirm the current state.
2. Pull the last 15 minutes of logs with `journalctl -u <service> --since "-15 min"`.
3. Cross-check the failure timestamp against recent package installs
   with `journalctl -u dpkg --since "-1 day"` (Debian/Ubuntu) or
   `journalctl -u dnf --since "-1 day"` (RHEL/Rocky).
4. Report the likely cause in plain language before suggesting a fix.

В этом примере <service> - плейсхолдер. При выполнении команд замените его на фактическое имя службы, например nginx, sshd или httpd.

Поле description особенно важно, поскольку Claude Code использует его, чтобы решить, когда загружать навык. Формулируйте его так, как если бы вы описывали проблему другому человеку. Например, “Использовать этот навык, когда служба systemd падает или не запускается” гораздо эффективнее общего описания вроде “навык анализа журналов”.

Типичные ошибки при создании навыков

Вот распространённые ошибки, которых следует избегать при создании навыков Claude Code:

  • Слишком общие описания: описание вроде “помогает с журналами” слишком общее и может не совпадать с запросом. Вместо этого опишите ситуации, в которых навык должен применяться, например “Использовать этот навык, когда служба systemd не запускается или падает”.
  • Сохранение навыка в неправильном месте: Claude Code ищет навыки только в ~/.claude/skills/ для персональных навыков и .claude/skills/ для навыков конкретного проекта. Если навык находится в другом месте, он не будет обнаружен.
  • Пропуск разделителей YAML-фронтматтера: строки --- в начале и конце секции YAML обязательны. Без них Claude Code воспринимает весь файл как обычный Markdown и игнорирует метаданные навыка.
  • Слишком большой навык: основной файл SKILL.md должен быть посвящён задаче. Если у вас есть объёмные справочные материалы, примеры или документация, разместите их в подкаталоге references/, чтобы Claude Code загружал их только при необходимости.

Проверка работы навыка

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

$ claude
> nginx keeps dying on this box, can you figure out why?

Во время ответа Claude Code наблюдайте, как он подходит к задаче. Если навык активирован, он будет следовать инструкциям из вашего SKILL.md, а не генерировать стандартный сценарий диагностики.

Если навык не используется и Claude Code даёт общий ответ, скорее всего, проблема в поле описания. Обновите его так, чтобы оно соответствовало тому, как вы обычно формулируете проблему, и протестируйте снова.

Если вы хотите научиться создавать и использовать более сложную автоматизацию с Claude Code, курс Claude Code for Linux Sysadmins содержит отдельный модуль по созданию пользовательских навыков.

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

Диагностика навыка, который не срабатывает

Если навык не используется, сначала проверьте, что он сохранён в правильном месте:

ls ~/.claude/skills/

Или для проекта:

ls .claude/skills/

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

Затем откройте файл и проверьте, что YAML-фронтматтер заключён между обязательными строками ---. Также убедитесь, что поле name содержит только строчные буквы и дефисы, без пробелов или заглавных символов.

Если навык по-прежнему не срабатывает, проблема, скорее всего, в описании. Перепишите его, используя те же слова, которыми вы обычно описываете задачу. Чем точнее описание соответствует вашим типичным запросам, тем выше вероятность, что Claude Code загрузит навык автоматически.

Сравнение навыков, CLAUDE.md и пользовательских команд

Claude Code предлагает несколько способов настройки поведения, и каждый служит своей цели.

Используйте CLAUDE.md для информации, которая должна быть постоянно доступна в проекте. Например, если ваш проект всегда использует pnpm вместо npm или придерживается определённого стандарта кодирования, эти сведения должны находиться в CLAUDE.md, поскольку Claude Code загружает их в начале каждого сеанса.

Используйте навык для инструкций, нужных только в определённых ситуациях. Claude Code загружает навык только при совпадении запроса с его описанием, что помогает сохранить рабочий контекст сфокусированным.

Также поддерживаются пользовательские слеш-команды. Например, создав файл .claude/commands/deploy.md, вы получите команду /deploy, которую можно запускать по необходимости.

Главное преимущество навыков в том, что вам не нужно запоминать или вводить специальную команду. Claude Code активирует их автоматически, когда запрос совпадает с описанием, а сам навык может включать вспомогательные скрипты, шаблоны и справочные файлы вместе с инструкциями.

Заключение

Навыки Claude Code позволяют сохранять повторяющиеся сценарии, чтобы каждый раз не объяснять одни и те же шаги. В этом руководстве мы рассмотрели, что такое навык, как устанавливать готовые навыки из маркетплейса Anthropic, как вручную добавить пользовательский файл SKILL.md и как создать собственный навык с нуля.

Если у вас есть задача, которую вы регулярно поручаете Claude Code, подумайте о создании навыка. Напишите чёткое описание, соответствующее вашим обычным формулировкам, сохраните навык и протестируйте его при следующей необходимости.

Создали полезный навык для Claude Code или у вас есть идея? Делитесь в комментариях.