Claude Skills (Agent Skills) для системного аналитика: обзор и топ-10 навыков

Claude Skills — это не «папка с промптами». Это сценарии поведения, которые Claude Code загружает в контекст при старте и активирует по триггерам. Системный аналитик может упаковать свою экспертизу в файл SKILL.md — и ИИ будет применять её автоматически, без напоминаний в каждом чате.

На конкретике. У вас есть шаблон ревью ТЗ, отточенный за пару лет. Обычно вы копируете его в промпт, правите под ситуацию, получаете результат. С навыком — файл review-tz/SKILL.md лежит в папке .claude/skills/, и когда вы пишете «отревьюй ТЗ», Claude сам знает, по каким критериям смотреть, в каком формате выдать результат и на что обратить внимание. Никаких копипаст.

Что такое Claude Skills — и при чём тут аналитик

Anthropic запустила Agent Skills в марте 2026. Механика простая: для каждого навыка создаётся папка с SKILL.md, внутри — YAML-заголовок с name и description, а ниже — инструкция на естественном языке. Claude Code сканирует все навыки при старте, читает description и понимает, когда какой навык активировать.

Навыки решают реальную боль аналитика: каждый проект требует своего набора правил, шаблонов и чек-листов. Раньше это кочевало из Confluence в Notion, из Notion в голову. Теперь — в .claude/skills/.

Приведу пример. На одном проекте у нас было соглашение: все Use Case пишутся по трёхуровневой модели — цель, основной поток, альтернативы — с обязательным указанием предусловий и NFR-нот. Без навыка приходилось объяснять это Claude в каждом новом чате. С навыком — один раз описал формат в SKILL.md, и ИИ придерживается его всегда. Экономия — часа два в неделю минимум.

Если вы работали с промпт-инжинирингом для системного аналитика, навыки — это следующий уровень. Не разрозненные промпты, а структурированная база экспертизы.

SKILL.md изнутри: структура файла навыка

Каждый навык — это SKILL.md с двумя обязательными секциями: YAML-frontmatter и тело инструкции.

1
---
2
name: review-technical-spec
3
description: >
4
  Ревью технического задания по чек-листу из 12 пунктов.
5
  Включает проверку полноты требований, противоречий,
6
  нефункциональных требований и критериев приёмки.
7
---

Тело инструкции — обычный markdown. Можно описывать:

• Пошаговый алгоритм ревью или анализа
• Чек-листы с критериями приёмки
• Шаблоны ответа — формат выдачи результата
• Ссылки на внутренние документы команды (Confluence, Notion)
• Примеры хороших и плохих спецификаций

Файл лежит внутри папки навыка в .claude/skills/. Там же — дополнительные ресурсы: шаблоны документов, CSV-таблицы, референсные спеки. Claude Code подгружает их при активации навыка.

Важный нюанс: description в YAML — это и есть триггер. Claude сравнивает запрос пользователя с description всех навыков и выбирает наиболее релевантный. Поэтому description критичен. Пишите конкретно: не «помощь с требованиями», а «ревью функциональных требований: проверка полноты, непротиворечивости, прослеживаемости и критериев приёмки».

Жизненный цикл навыка

Механика активации:

flowchart TD
  A["Аналитик создаёт<br/>SKILL.md"] --> B["Claude Code загружает<br/>skills при старте"]
  B --> C["Определение триггеров:<br/>description + rules"]
  C --> D{"Запрос пользователя<br/>попадает под навык?"}
  D -->|"Да"| E["Активация навыка:<br/>загрузка инструкций в контекст"]
  D -->|"Нет"| F["Стандартный ответ"]
  E --> G["Выполнение задачи<br/>по инструкциям навыка"]
  G --> H["Результат:<br/>спецификация / ревью / диаграмма"]
  style A fill:#4a90d9,stroke:#2c5f8a,color:#fff
  style B fill:#7b68ee,stroke:#5a4db2,color:#fff
  style C fill:#7b68ee,stroke:#5a4db2,color:#fff
  style D fill:#f0a500,stroke:#c88400,color:#fff
  style E fill:#50c878,stroke:#3a9a5c,color:#fff
  style F fill:#e0e0e0,stroke:#999,color:#333
  style G fill:#50c878,stroke:#3a9a5c,color:#fff
  style H fill:#4a90d9,stroke:#2c5f8a,color:#fff

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

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

На практике: написали навык → протестировали на реальном ТЗ → навык пропустил проверку NFR → дополнили инструкцию → работает стабильно. Итераций обычно две-три. После этого навык живёт в проекте без внимания.

Топ-10 навыков для системного аналитика

Список навыков, которые я использую сам. Каждый закрывает конкретную рутину, можно скопировать, адаптировать под проект и запустить за 10 минут.

1. Генератор User Story из брифа

Триггер: стейкхолдер прислал абзац текста — нужны структурированные User Story.

Что внутри: шаблон User Story — As a… I want… So that…, критерии приёмки, приоритет по MoSCoW, связь с бизнес-целью. Инструкция: «разбей текст на атомарные сценарии, выдели роли, сформулируй ценность».

2. Ревьюер технического задания

Триггер: готовое ТЗ — нужно найти дыры до того, как их найдёт разработчик.

Что внутри: чек-лист из 12 пунктов. Проверка полноты функциональных блоков, непротиворечивость, наличие NFR, прослеживаемость требований к бизнес-целям. Формат выдачи: таблица с колонками «проблема», «серьёзность», «предлагаемое исправление».

3. Генератор C4-диаграмм (Context + Containers)

Триггер: описание системы — нужна архитектурная диаграмма.

Что внутри: инструкция по уровням C4 (System Context, Containers), формат выдачи — Mermaid-код с цветовой схемой. Внешние системы — серые, внутренние контейнеры — синие, БД — фиолетовые. Навык запрашивает список интеграций, если они не указаны явно.

4. Детектор противоречий в требованиях

Триггер: спецификация из нескольких разделов — нужно найти логические конфликты.

Что внутри: алгоритм попарного сравнения требований. Конфликт ролей, конфликт данных (разные форматы дат), конфликт состояний. Выдача — список противоречий с цитированием исходных пунктов.

5. Составитель словаря терминов

Триггер: набор документов — нужно вытащить и унифицировать терминологию.

Что внутри: извлечение терминов из текста, формат: «термин / определение / синонимы (запрещённые) / контекст». Автоматически подсвечивает термины, используемые в разных значениях.

6. Формализатор API-контракта (OpenAPI)

Триггер: описание эндпоинтов текстом — нужна OpenAPI-спека.

Что внутри: шаблон OpenAPI 3.1, маппинг текстовых описаний в paths/parameters/responses, соглашения по неймингу и форматам. Задаёт уточняющие вопросы по аутентификации и пагинации.

7. Декомпозитор эпика на задачи

Триггер: крупная фича одним абзацем — нужно разбить на User Story и задачи.

Что внутри: алгоритм декомпозиции. Критерий атомарности: одна история = одна роль + одно действие + одна ценность. Если история затрагивает два разных bounded context — разбивается. Группировка по слоям: фронт, бэк, БД, интеграции.

8. Оценщик трудозатрат (стори-поинты)

Триггер: список User Story — нужна относительная оценка сложности.

Что внутри: шкала Фибоначчи, критерии: количество интеграций, сложность бизнес-логики, неопределённость требований, объём UI. Оценка с обоснованием в одну строку.

9. Генератор тест-кейсов из требований

Триггер: требование — нужны тест-кейсы.

Что внутри: шаблон (ID, предусловия, шаги, ожидаемый результат). На каждое требование — минимум 1 позитивный и 2 граничных кейса. Для интеграционных сценариев — проверка таймаутов и кодов ошибок.

10. Составитель метрик и NFR

Триггер: функциональные требования — нужно формализовать нефункциональные.

Что внутри: чек-лист категорий NFR: производительность, надёжность, безопасность, масштабируемость, наблюдаемость. Сканирует функциональные требования и предлагает численные метрики: «p95 < 200ms», «идемпотентность обязательна». Если данных недостаточно — помечает как [требует уточнения].

Десять навыков — не предел. Стартуйте с двух-трёх, которые закрывают самую болезненную рутину. Через неделю станет понятно, какие ещё нужны.

Подключение навыка в Claude Code

Если у вас настроен Claude Code, добавление навыка — три шага:

1. Создайте папку: .claude/skills/review-tz/
2. Создайте файл: SKILL.md с YAML-frontmatter и инструкцией
3. Перезапустите Claude Code — он сканирует навыки при старте

Файловая структура проекта:

1
project/
2
├── .claude/
3
│   ├── CLAUDE.md          ← общие инструкции проекта
4
│   └── skills/
5
│       ├── review-tz/
6
│       │   └── SKILL.md
7
│       ├── generate-us/
8
│       │   └── SKILL.md
9
│       └── c4-diagram/
10
│           ├── SKILL.md
11
│           └── template.mmd  ← шаблон C4
12
└── docs/
13
    └── requirements.md

Папка .claude/skills/ в корне проекта. Навыки видны всем, кто клонирует репозиторий — команда получает единый стандарт работы с ИИ без дополнительной настройки.

Если Claude Code ещё не настроен — MCP-серверы: как подключить LLM к внутренним системам разбирают тему подключения инструментов с нуля.

Skills vs промпты vs MCP: в чём разница

Навыки не заменяют MCP — дополняют. Навык может содержать инструкцию «запроси все User Story из Jira через MCP и проверь полноту по чек-листу». Связка мощнее, чем каждый инструмент по отдельности.

Промпты никуда не делись. Для одноразового запроса навык — перебор: глупо писать SKILL.md, чтобы спросить «что такое идемпотентность». Но если ревьюите ТЗ дважды в неделю — навык окупается за первый день.

Чек-лист для аналитика

• Определите 1–2 повторяющихся сценария, которые отжирают время
• Опишите их в SKILL.md: триггер, алгоритм, формат выдачи
• Положите файл в `.claude/skills/<имя-навыка>/SKILL.md`
• Протестируйте на реальной задаче и дополните инструкцию
• Закоммитьте в репозиторий — команда скажет спасибо (или как минимум не спросит «а где спецификация?»)

Восемьдесят процентов рутины аналитика — это повторяющиеся операции. Требования не пишутся сами, но с навыками Claude Code перестаёшь тратить время на механику и фокусируешься на том, что реально требует головы.