Шаблоны Claude Code: навыки, агенты, хуки и другое

Что такое шаблоны Claude Code?

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

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

На практике это обычно файлы на базе Markdown, JSON или shell, которые хранятся в папках уровня проекта, например .claude/, либо упакованы в каталоги плагинов для совместного использования.

Типичная структура на уровне проекта может выглядеть так:

my-app/
├── CLAUDE.md
├── .mcp.json
└── .claude/
    ├── skills/
    │   └── database-migration/
    │       └── SKILL.md
    ├── agents/
    │   └── security-auditor.md
    ├── commands/
    │   └── summarize-pr.md
    └── settings.json

Шаблоны Claude Code и CLAUDE.md

CLAUDE.md по‑прежнему важен, но выполняет иную роль. Думайте о CLAUDE.md как о брифе проекта: что это за проект, какие команды важны, какие стандарты кодирования действуют и какие архитектурные соглашения Claude должен помнить. 

Для подробного разбора см. наш гайд по написанию CLAUDE.md.

Шаблоны более модульны:

• Навык может закодировать процесс миграции. 
• Агент может изолировать персону для аудита безопасности. 
• Хук может запускаться после правок файлов. 
• Конфигурация MCP может подключить Claude к GitHub, SQLite или другой внешней системе.

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

Больше таких практик описано в нашем руководстве по лучшим практикам.

Пользовательские команды также покрываются системой навыков, хотя устаревший формат .claude/commands/ всё ещё работает. Рекомендуемый новый формат — .claude/skills/<name>/SKILL.md, который поддерживает вызов через slash‑команду и автоматическое подключение Claude.

Какие виды шаблонов Claude Code доступны?

Экосистема шаблонов Claude Code обычно делится на шесть категорий: навыки, агенты, команды, хуки, интеграции MCP и плагины. 

Первые пять напрямую меняют поведение Claude. Плагины немного иные: это формат дистрибуции, который может объединять навыки, агентов, хуки, команды, серверы MCP и другие компоненты в повторно используемый пакет.

Ниже разберём каждую из категорий.

1. Навыки

Навыки — это пакеты инструкций для повторяемых многошаговых задач. Обычно навык — это папка с файлом SKILL.md, содержащим YAML‑фронтматтер и тело в Markdown. 

Во фронтматтере описывается, что делает навык и как он должен себя вести; в теле — какие шаги Claude нужно выполнить. Подробно это разобрано в руководстве Claude Skills.

Claude использует описание навыка, чтобы понять, когда он релевантен. По умолчанию навык может вызывать и пользователь, и Claude: вы можете ввести /skill-name, или Claude загрузит его автоматически, когда текущая задача соответствует описанию навыка. Автоматический вызов модели можно отключить для сценариев, где нужен ручной контроль, например при деплое.

Короткий пример файла: .claude/skills/database-migration/SKILL.md

---
name: database-migration
description: Use when creating, reviewing, or modifying database migrations. Ensures migrations are reversible, tested, and checked before and after execution.
allowed-tools:
  - Read
  - Write
  - Bash
---

# Database Migration Skill

When working on a database migration:

1. Inspect the existing schema and migration history before writing changes.
2. Confirm whether the migration is additive, destructive, or data-transforming.
3. Create a reversible migration whenever the framework supports rollback.
4. Run the project’s migration check command before applying the migration.
5. Run tests that cover the affected models, queries, or API endpoints.
6. After writing the migration, summarize:
   - schema changes
   - rollback behavior
   - affected tables
   - test commands run

Это полезно, потому что инструкции процедурные. Вы не просто говорите Claude «будь осторожен с миграциями». Вы даёте ему повторяемый чек‑лист. 

Навыки лучше всего подходят для всего, что вы иначе вставляли бы в Claude больше двух раз: генерация API‑эндпоинтов, написание changelog, подготовка тестов, создание release notes, ревью pull request или проверка миграций.

Для широкой вдохновляющей подборки того, что разработчики превращают в повторяемые AI‑процессы, см. наш список Agent Skills.

2. Агенты

Агенты, точнее настраиваемые субагенты в Claude Code, — это специализированные AI‑помощники с собственной Markdown‑дефиницией, YAML‑фронтматтером, ограничениями на инструменты, выбором модели и системным промптом. 

Их можно хранить в .claude/agents/ для охвата проекта или в ~/.claude/agents/ для личного охвата. Агенты создаются по запросу к Claude или путём редактирования markdown‑файлов напрямую в папке .claude/agents/.

Между навыками и агентами есть разница. Навык определяет, как выполнить задачу. Агент определяет, кем должен быть Claude при выполнении работы: его роль, фокус, разрешения и рамки.

Рассмотрим пример агента:

---
name: security-auditor
description: Reviews code for security vulnerabilities and produces a findings report without modifying files.
tools: Read, Glob, Grep, Bash
model: sonnet
---

You are a security auditor.

Your task is to inspect the codebase for vulnerabilities, risky patterns, and missing safeguards.

Rules:
- Do not edit files.
- Do not suggest broad rewrites unless directly tied to a security issue.
- Focus on authentication, authorization, input validation, secrets, dependency risk, and unsafe shell or SQL usage.
- Produce a findings report with severity, affected files, evidence, and recommended next steps.

Этот агент полезен, потому что задаёт Claude чёткие рамки. В общей сессии Claude может сразу перейти к исправлению найденных проблем. Агент‑аудитор безопасности должен только инспектировать и отчитываться, избегая правок. 

Агенты лучше всего подходят для специализированных областей — аудит безопасности, ревью документации, архитектурный обзор, data engineering или проверки качества кода — где важны изоляция контекста и границы разрешений.

Агенты также полезны в паре со специализированными навыками. Например, агент‑аудитор безопасности может вызывать навык по отчёту о находках, а агент‑ревьюер фронтенда — навык для тестирования компонентов.

3. Команды

Команды — это ярлыки, вызываемые через слэш, например /generate-tests, /check-deps или /summarize-pr. Исторически пользовательские команды хранились как файлы Markdown в каталоге .claude/commands/, причём имя файла служило именем команды. 

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

Команды уместны, когда триггер должен быть явным. Навык может активироваться автоматически при обнаружении подходящей задачи, а команда должна выполняться только по вашему выбору. Поэтому команды хороши в качестве контрольных точек: «сгенерировать тесты сейчас», «суммировать этот PR сейчас», «проверить зависимости сейчас» или «подготовить сообщение коммита сейчас».

4. Хуки

Хуки — это правила автоматизации, которые запускаются в ответ на события жизненного цикла Claude Code. Это определяемые пользователем shell‑команды, выполняемые в конкретные моменты жизненного цикла Claude Code, что даёт детерминированный контроль над поведением. 

В отличие от рассмотренных выше шаблонов, хуки срабатывают не от того, что вы просите, а от того, что делает Claude.

Проще говоря, вам не нужно надеяться, что Claude вспомнит отформатировать файл после правки: хук сделает это автоматически.

Текущие имена событий для хуков включают, например, PreToolUse, PostToolUse, Notification и Stop. 

Пример: запуск форматирования после правки или записи файла Claude:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Example: block risky shell commands before Claude runs them:
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/block-dangerous-bash.py"
          }
        ]
      }
    ]
  }
}

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

Подробное руководство читайте в Claude Code Hooks Guide.

5. Интеграции MCP

Интеграции MCP подключают Claude Code к внешним инструментам, источникам данных и API через Model Context Protocol. MCP выступает в роли соединительного слоя между AI‑системами и внешними инструментами. В Claude Code это означает, что Claude может выходить за рамки локальных файлов и shell‑команд. 

Это позволяет Claude взаимодействовать с внешними сервисами, такими как GitHub, базы данных, системы документации, облачные платформы или внутренние API — в зависимости от того, какие серверы MCP вы настроите. Полное объяснение и демонстрационный проект см. в нашем руководстве по Model Context Protocol.

Сервер MCP может предоставлять три широких вида возможностей:

• Инструменты: исполняемые функции, которые Claude может вызывать, например создание issue в GitHub или выполнение запроса к базе данных.
• Ресурсы: источники контекста только для чтения, такие как файл, строка в базе данных или документ.
• Промпты: повторно используемые шаблоны задач, предоставляемые сервером.

На уровне проекта файл .mcp.json может настраивать несколько серверов параллельно:

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sqlite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "./data/app.db"
      ]
    }
  }
}

Это важно, потому что Claude может рассуждать только на основе доступного ему контекста и инструментов. Без MCP он может изучать локальные файлы, но не ваш трекер задач, базу данных, облачное окружение или внутренний API. 

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

6. Плагины

Плагины — это упакованные наборы. Они могут включать навыки, агентов, хуки, конфигурации MCP, команды и другие компоненты в рамках одной устанавливаемой структуры. 

В Claude Code плагин обычно содержит манифест .claude-plugin/plugin.json и папки компонентов, такие как skills/, agents/, hooks/, а также .mcp.json в корне плагина.

Пример структуры плагина:

frontend-workflow-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── component-test/
│       └── SKILL.md
├── agents/
│   └── frontend-reviewer.md
├── hooks/
│   └── hooks.json
└── .mcp.json

Пример json плагина:

{
  "name": "frontend-workflow",
  "displayName": "Frontend Workflow",
  "version": "1.0.0",
  "description": "Frontend development workflow with review agents, test skills, and formatting hooks",
  "author": {
    "name": "Your Team"
  }
}

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

Чтобы собрать плагин с нуля, см. пошаговое руководство по плагинам Claude Code от DataCamp.

Какой тип шаблона выбрать?

Понимаю: во всём этом легко запутаться. Каждый тип может менять поведение Claude. Разница в основном в том, как они запускаются и какой дают уровень контроля.

Чтобы было нагляднее, вот сравнение:

Простое правило выбора:

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

В реальных проектах эти типы обычно комбинируют. Плагин безопасности может включать агента security-auditor, навык audit-findings, команду для проверки зависимостей и pre-commit‑хук. Агент определяет роль, навык — структуру отчёта, команда даёт явную контрольную точку, а хук обеспечивает ограничение.

Для процессов, где Claude должен следовать формальному плану перед реализацией, spec‑driven development часто подходит лучше, чем разовые подсказки.

Где найти шаблоны Claude Code?

Есть три практичных источника: Anthropic, коллекции сообщества и вы сами.

Во‑первых, начните с официальных ресурсов Anthropic и документации. Документация Claude Code от Anthropic охватывает навыки, субагентов, хуки, MCP и плагины — это лучший источник, чтобы уточнить актуальные форматы файлов и поведение перед публикацией чего‑либо в продакшене.

Во‑вторых, используйте коллекции сообщества. Самый заметный хаб сообщества — aitmpl.com, который позиционирует себя как каталог готовых к использованию конфигураций для проектов Claude Code. В его живой навигации сейчас есть Skills, Agents, Commands, Settings, Hooks, MCPs и Plugins. 

Текущая интерактивная команда установки:

npx claude-code-templates@latest

В документации проекта также показан короткий алиас:

npx cct@latest

Для отдельных компонентов в актуальном README на GitHub приводятся команды установки, например:

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

Там же показана пакетная установка полного набора с использованием нескольких флагов в одной команде.

Оценивая шаблоны сообщества, проверьте несколько признаков качества:

• Достаточно ли конкретно указано description, чтобы Claude корректно вызывал навык или агента?

• Узко ли заданы allowed-tools, или шаблон без нужды запрашивает широкие права на запись и bash?

• Поддерживается ли репозиторий в последнее время?

• Объясняет ли шаблон, что он меняет?

• Не включает ли он хуки или серверы MCP, которые выполняют непроверенный вами код?

В‑третьих, пишите свои. Это обычно лучший путь для процессов, тесно связанных с вашим стеком. Шаблон сообщества может дать полезную базу, но он не знает вашу внутреннюю политику миграций, соглашения об именовании, модель данных или допустимый риск деплоя.

Заключение

Шаблоны Claude Code переводят Claude Code из помощника «сессия за сессией» в постоянную среду разработки. 

Шесть описанных категорий — это, по сути, слои: навыки кодируют процессы, агенты задают роли, команды создают явные действия, хуки обеспечивают ограничения, MCP подключает внешние системы, а плагины упаковывают всё для повторного использования.

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

Чтобы продолжить изучение Claude Code, загляните на наши курсы Claude Code 101 и Claude Code in Action.