Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Skills расширяют возможности Claude. Создайте файл SKILL.md с инструкциями, и Claude добавит его в свой набор инструментов. Claude использует skills при необходимости, или вы можете вызвать один напрямую с помощью /skill-name. Создайте skill, когда вы постоянно вставляете один и тот же сценарий, контрольный список или многошаговую процедуру в чат, или когда раздел CLAUDE.md превратился в процедуру, а не в факт. В отличие от содержимого CLAUDE.md, тело skill загружается только при его использовании, поэтому большой справочный материал стоит почти ничего, пока вам он не понадобится.
Для встроенных команд, таких как /help и /compact, и встроенных skills, таких как /debug и /simplify, см. справочник команд.Пользовательские команды были объединены с skills. Файл в .claude/commands/deploy.md и skill в .claude/skills/deploy/SKILL.md оба создают /deploy и работают одинаково. Ваши существующие файлы .claude/commands/ продолжают работать. Skills добавляют дополнительные функции: каталог для вспомогательных файлов, frontmatter для управления тем, кто вызывает skill, и возможность для Claude загружать их автоматически при необходимости.
Skills в Claude Code следуют открытому стандарту Agent Skills, который работает с несколькими инструментами AI. Claude Code расширяет стандарт дополнительными функциями, такими как управление вызовом, выполнение в subagent и динамическое внедрение контекста.

​
Встроенные skills

Claude Code включает набор встроенных skills, которые доступны в каждой сессии, включая /simplify, /batch, /debug, /loop и /claude-api. В отличие от большинства встроенных команд, которые выполняют фиксированную логику напрямую, встроенные skills основаны на подсказках: они дают Claude подробный сценарий и позволяют ему организовать работу, используя свои инструменты. Вы вызываете их так же, как любой другой skill, введя / и затем имя skill. Встроенные skills перечислены вместе со встроенными командами в справочнике команд, отмечены как Skill в столбце Purpose.

​
Начало работы

​
Создайте свой первый skill

Этот пример создаёт skill, который суммирует незафиксированные изменения в вашем git-репозитории и отмечает всё рискованное. Он загружает живой diff в подсказку перед тем, как Claude его прочитает, поэтому ответ основан на вашем фактическом рабочем дереве, а не на том, что Claude может угадать из открытых файлов. Claude загружает skill автоматически, когда вы спрашиваете об изменениях, или вы можете вызвать его напрямую с помощью /summarize-changes.
1

Создайте каталог skill

Создайте каталог для skill в папке личных skills. Личные skills доступны во всех ваших проектах.
mkdir -p ~/.claude/skills/summarize-changes
2

Напишите SKILL.md

Каждому skill нужен файл SKILL.md с двумя частями: YAML frontmatter между маркерами ---, который говорит Claude, когда использовать skill, и содержимое markdown с инструкциями, которые Claude следует при запуске skill. Имя каталога становится командой, которую вы вводите, а description помогает Claude решить, когда загружать skill автоматически.Сохраните это в ~/.claude/skills/summarize-changes/SKILL.md:
---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.
Строка !`git diff HEAD` использует динамическое внедрение контекста: Claude Code запускает команду и заменяет строку её выходом перед тем, как Claude увидит содержимое skill, поэтому инструкции приходят с текущим diff уже встроенным.
3

Протестируйте skill

Откройте git-проект, внесите небольшое изменение в любой файл и запустите Claude Code, выполнив claude. Вы можете протестировать skill двумя способами.Позвольте Claude вызвать его автоматически, задав вопрос, который соответствует описанию:
What did I change?
Или вызовите его напрямую с именем skill:
/summarize-changes
В любом случае Claude должен ответить с кратким резюме вашего редактирования и списком рисков.

​
Где находятся skills

Место, где вы сохраняете skill, определяет, кто может его использовать:
МестоположениеПутьПрименяется к
EnterpriseСм. управляемые параметрыВсе пользователи в вашей организации
Personal~/.claude/skills/<skill-name>/SKILL.mdВсе ваши проекты
Project.claude/skills/<skill-name>/SKILL.mdТолько этот проект
Plugin<plugin>/skills/<skill-name>/SKILL.mdГде включен плагин
Когда skills имеют одинаковые имена на разных уровнях, enterprise переопределяет personal, а personal переопределяет project. Plugin skills используют пространство имён plugin-name:skill-name, поэтому они не могут конфликтовать с другими уровнями. Если у вас есть файлы в .claude/commands/, они работают так же, но если skill и команда имеют одинаковое имя, skill имеет приоритет.

​
Обнаружение живых изменений

Claude Code следит за каталогами skills на предмет изменений файлов. Добавление, редактирование или удаление skill в ~/.claude/skills/, в проекте .claude/skills/ или в .claude/skills/ внутри каталога --add-dir вступает в силу в текущей сессии без перезагрузки. Создание каталога skills верхнего уровня, который не существовал при запуске сессии, требует перезагрузки Claude Code, чтобы новый каталог можно было отслеживать.

​
Автоматическое обнаружение из родительских и вложенных каталогов

Project skills загружаются из .claude/skills/ в вашем начальном каталоге и в каждом родительском каталоге вплоть до корня репозитория, поэтому запуск Claude в подкаталоге по-прежнему подхватывает skills, определённые в корне. Когда вы работаете с файлами в подкаталогах ниже вашего начального каталога, Claude Code также обнаруживает skills из вложенных каталогов .claude/skills/ по требованию. Например, если вы редактируете файл в packages/frontend/, Claude Code также ищет skills в packages/frontend/.claude/skills/. Это поддерживает настройки monorepo, где пакеты имеют свои собственные skills. Каждый skill — это каталог с SKILL.md в качестве точки входа: 
my-skill/
├── SKILL.md           # Main instructions (required)
├── template.md        # Template for Claude to fill in
├── examples/
│   └── sample.md      # Example output showing expected format
└── scripts/
    └── validate.sh    # Script Claude can execute
SKILL.md содержит основные инструкции и является обязательным. Другие файлы необязательны и позволяют вам создавать более мощные skills: шаблоны для заполнения Claude, примеры выходных данных, показывающие ожидаемый формат, скрипты, которые Claude может выполнять, или подробную справочную документацию. Ссылайтесь на эти файлы из вашего SKILL.md, чтобы Claude знал, что они содержат и когда их загружать. См. Добавьте вспомогательные файлы для получения дополнительной информации.
Файлы в .claude/commands/ по-прежнему работают и поддерживают тот же frontmatter. Skills рекомендуются, так как они поддерживают дополнительные функции, такие как вспомогательные файлы.

​
Skills из дополнительных каталогов

Флаг --add-dir предоставляет доступ к файлам скорее, чем конфигурацию обнаружения, но skills — это исключение: .claude/skills/ в добавленном каталоге загружается автоматически. См. Обнаружение живых изменений для того, как правки подхватываются во время сессии. Другая конфигурация .claude/, такая как subagents, команды и стили выходных данных, не загружается из дополнительных каталогов. См. таблицу исключений для полного списка того, что загружается и что не загружается, и рекомендуемые способы совместного использования конфигурации между проектами.
Файлы CLAUDE.md из каталогов --add-dir не загружаются по умолчанию. Чтобы загружать их, установите CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1. См. Загрузка из дополнительных каталогов.

​
Настройка skills

Skills настраиваются через YAML frontmatter в верхней части SKILL.md и содержимое markdown, которое следует.

​
Типы содержимого skill

Файлы skill могут содержать любые инструкции, но размышление о том, как вы хотите их вызывать, помогает направить, что включить: Справочное содержимое добавляет знания, которые Claude применяет к вашей текущей работе. Соглашения, паттерны, руководства по стилю, знания предметной области. Это содержимое выполняется встроенно, поэтому Claude может использовать его вместе с контекстом вашего разговора. 
---
name: api-conventions
description: API design patterns for this codebase
---

When writing API endpoints:
- Use RESTful naming conventions
- Return consistent error formats
- Include request validation
Содержимое задачи даёт Claude пошаговые инструкции для конкретного действия, такого как развёртывания, коммиты или генерация кода. Это часто действия, которые вы хотите вызвать напрямую с помощью /skill-name, а не позволять Claude решать, когда их запускать. Добавьте disable-model-invocation: true, чтобы предотвратить автоматическое срабатывание Claude. 
---
name: deploy
description: Deploy the application to production
context: fork
disable-model-invocation: true
---

Deploy the application:
1. Run the test suite
2. Build the application
3. Push to the deployment target
Ваш SKILL.md может содержать что угодно, но размышление о том, как вы хотите вызывать skill (вы, Claude или оба) и где вы хотите его запускать (встроенно или в subagent), помогает направить, что включить. Для сложных skills вы также можете добавить вспомогательные файлы, чтобы сохранить основной skill сосредоточенным. Сохраняйте само тело кратким. После загрузки skill его содержимое остаётся в контексте на протяжении ходов, поэтому каждая строка — это повторяющаяся стоимость токенов. Указывайте, что делать, а не рассказывайте, как или почему, и применяйте тот же тест краткости, который вы бы применили к содержимому CLAUDE.md.

​
Справочник frontmatter

Помимо содержимого markdown, вы можете настроить поведение skill, используя поля YAML frontmatter между маркерами --- в верхней части вашего файла SKILL.md: 
---
name: my-skill
description: What this skill does
disable-model-invocation: true
allowed-tools: Read Grep
---

Your skill instructions here...
Все поля необязательны. Только description рекомендуется, чтобы Claude знал, когда использовать skill.
ПолеОбязательноОписание
nameНетОтображаемое имя для skill. Если опущено, использует имя каталога. Только строчные буквы, цифры и дефисы (максимум 64 символа).
descriptionРекомендуетсяЧто делает skill и когда его использовать. Claude использует это, чтобы решить, когда применять skill. Если опущено, использует первый абзац содержимого markdown. Комбинированный текст description и when_to_use усекается на 1 536 символах в списке skills для уменьшения использования контекста.
when_to_useНетДополнительный контекст для того, когда Claude должен вызвать skill, такой как фразы-триггеры или примеры запросов. Добавляется к description в списке skills и учитывается в лимите 1 536 символов.
argument-hintНетПодсказка, показываемая при автодополнении, чтобы указать ожидаемые аргументы. Пример: [issue-number] или [filename] [format].
argumentsНетИменованные позиционные аргументы для подстановки $name в содержимом skill. Принимает строку, разделённую пробелами, или список YAML. Имена соответствуют позициям аргументов по порядку.
disable-model-invocationНетУстановите на true, чтобы предотвратить автоматическую загрузку этого skill Claude. Используйте для рабочих процессов, которые вы хотите запустить вручную с помощью /name. Также предотвращает предварительную загрузку skill в subagents. По умолчанию: false.
user-invocableНетУстановите на false, чтобы скрыть из меню /. Используйте для фоновых знаний, которые пользователи не должны вызывать напрямую. По умолчанию: true.
allowed-toolsНетИнструменты, которые Claude может использовать без запроса разрешения, когда этот skill активен. Принимает строку, разделённую пробелами, или список YAML.
modelНетМодель для использования, когда этот skill активен. Переопределение применяется для остальной части текущего хода и не сохраняется в параметры; модель сессии возобновляется при вашем следующем запросе. Принимает те же значения, что и /model, или inherit, чтобы сохранить активную модель.
effortНетУровень усилий при активном этом skill. Переопределяет уровень усилий сессии. По умолчанию: наследует из сессии. Опции: low, medium, high, xhigh, max; доступные уровни зависят от модели.
contextНетУстановите на fork, чтобы запустить в контексте forked subagent.
agentНетКакой тип subagent использовать, когда установлен context: fork.
hooksНетHooks, ограниченные жизненным циклом этого skill. См. Hooks в skills и agents для формата конфигурации.
pathsНетGlob паттерны, которые ограничивают, когда этот skill активируется. Принимает строку, разделённую запятыми, или список YAML. Когда установлено, Claude загружает skill автоматически только при работе с файлами, соответствующими паттернам. Использует тот же формат, что и правила, специфичные для пути.
shellНетShell для использования в блоках !`command` и ```! в этом skill. Принимает bash (по умолчанию) или powershell. Установка powershell запускает встроенные команды shell через PowerShell на Windows. Требует CLAUDE_CODE_USE_POWERSHELL_TOOL=1.

​
Доступные подстановки строк

Skills поддерживают подстановку строк для динамических значений в содержимом skill:
ПеременнаяОписание
$ARGUMENTSВсе аргументы, переданные при вызове skill. Если $ARGUMENTS отсутствует в содержимом, аргументы добавляются как ARGUMENTS: <value>.
$ARGUMENTS[N]Доступ к конкретному аргументу по индексу на основе 0, например $ARGUMENTS[0] для первого аргумента.
$NСокращение для $ARGUMENTS[N], например $0 для первого аргумента или $1 для второго.
$nameИменованный аргумент, объявленный в списке frontmatter arguments. Имена соответствуют позициям по порядку, поэтому с arguments: [issue, branch] заполнитель $issue расширяется до первого аргумента и $branch ко второму.
${CLAUDE_SESSION_ID}Текущий ID сессии. Полезно для логирования, создания файлов, специфичных для сессии, или корреляции выходных данных skill с сессиями.
${CLAUDE_EFFORT}Текущий уровень усилий: low, medium, high, xhigh или max. Используйте это, чтобы адаптировать инструкции skill к активному параметру усилий.
${CLAUDE_SKILL_DIR}Каталог, содержащий файл SKILL.md skill. Для plugin skills это подкаталог skill в плагине, а не корень плагина. Используйте это в командах bash injection для ссылки на скрипты или файлы, поставляемые с skill, независимо от текущего рабочего каталога.
Индексированные аргументы используют кавычки в стиле shell, поэтому оборачивайте многословные значения в кавычки, чтобы передать их как один аргумент. Например, /my-skill "hello world" second заменяет $0 на hello world и $1 на second. Заполнитель $ARGUMENTS всегда расширяется до полной строки аргумента в том виде, в котором она была введена. Пример использования подстановок: 
---
name: session-logger
description: Log activity for this session
---

Log the following to logs/${CLAUDE_SESSION_ID}.log:

$ARGUMENTS

​
Добавьте вспомогательные файлы

Skills могут включать несколько файлов в их каталоге. Это сохраняет SKILL.md сосредоточенным на основном, позволяя Claude получать доступ к подробному справочному материалу только при необходимости. Большие справочные документы, спецификации API или коллекции примеров не нужно загружать в контекст каждый раз, когда запускается skill. 
my-skill/
├── SKILL.md (required - overview and navigation)
├── reference.md (detailed API docs - loaded when needed)
├── examples.md (usage examples - loaded when needed)
└── scripts/
    └── helper.py (utility script - executed, not loaded)
Ссылайтесь на вспомогательные файлы из SKILL.md, чтобы Claude знал, что содержит каждый файл и когда его загружать: 
## Additional resources

- For complete API details, see [reference.md](reference.md)
- For usage examples, see [examples.md](examples.md)
Сохраняйте SKILL.md под 500 строк. Переместите подробный справочный материал в отдельные файлы.

​
Управляйте тем, кто вызывает skill

По умолчанию как вы, так и Claude можете вызывать любой skill. Вы можете ввести /skill-name, чтобы вызвать его напрямую, и Claude может загружать его автоматически при необходимости для вашего разговора. Два поля frontmatter позволяют вам ограничить это:
  • disable-model-invocation: true: Только вы можете вызвать skill. Используйте это для рабочих процессов с побочными эффектами или которые вы хотите контролировать по времени, такие как /commit, /deploy или /send-slack-message. Вы не хотите, чтобы Claude решил развернуть, потому что ваш код выглядит готовым.
  • user-invocable: false: Только Claude может вызвать skill. Используйте это для фоновых знаний, которые не являются действенными как команда. Skill legacy-system-context объясняет, как работает старая система. Claude должен знать это при необходимости, но /legacy-system-context не является значимым действием для пользователей.
Этот пример создаёт skill развёртывания, который может запустить только вы. Поле disable-model-invocation: true предотвращает автоматическое запуск Claude: 
---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
---

Deploy $ARGUMENTS to production:

1. Run the test suite
2. Build the application
3. Push to the deployment target
4. Verify the deployment succeeded
Вот как два поля влияют на вызов и загрузку контекста:
FrontmatterВы можете вызватьClaude может вызватьКогда загружается в контекст
(по умолчанию)ДаДаОписание всегда в контексте, полный skill загружается при вызове
disable-model-invocation: trueДаНетОписание не в контексте, полный skill загружается при вашем вызове
user-invocable: falseНетДаОписание всегда в контексте, полный skill загружается при вызове
В обычной сессии описания skills загружаются в контекст, чтобы Claude знал, что доступно, но полное содержимое skill загружается только при вызове. Subagents с предварительно загруженными skills работают иначе: полное содержимое skill внедряется при запуске.

​
Жизненный цикл содержимого skill

Когда вы или Claude вызываете skill, отрендеренное содержимое SKILL.md входит в разговор как одно сообщение и остаётся там для остальной части сессии. Claude Code не перечитывает файл skill при последующих ходах, поэтому пишите рекомендации, которые должны применяться на протяжении всей задачи, как постоянные инструкции, а не одноразовые шаги. Auto-compact переносит вызванные skills в рамках бюджета токенов. Когда разговор суммируется для освобождения контекста, Claude Code повторно прикрепляет самый последний вызов каждого skill после сводки, сохраняя первые 5 000 токенов каждого. Повторно прикреплённые skills делят объединённый бюджет в 25 000 токенов. Claude Code заполняет этот бюджет, начиная с самого недавно вызванного skill, поэтому более старые skills могут быть полностью удалены после компактирования, если вы вызвали много в одной сессии. Если skill кажется перестаёт влиять на поведение после первого ответа, содержимое обычно всё ещё присутствует, и модель выбирает другие инструменты или подходы. Усильте описание skill и инструкции, чтобы модель продолжала его предпочитать, или используйте hooks для детерминированного обеспечения поведения. Если skill большой или вы вызвали несколько других после него, повторно вызовите его после компактирования, чтобы восстановить полное содержимое.

​
Предварительно одобрите инструменты для skill

Поле allowed-tools предоставляет разрешение для перечисленных инструментов, пока skill активен, поэтому Claude может использовать их без запроса вашего одобрения. Это не ограничивает, какие инструменты доступны: каждый инструмент остаётся вызываемым, и ваши параметры разрешений по-прежнему управляют инструментами, которые не указаны. Для skills, проверенных в каталоге .claude/skills/ проекта, allowed-tools вступает в силу после того, как вы примете диалог доверия рабочей области для этой папки, так же как правила разрешений в .claude/settings.json. Проверьте skills проекта перед доверием к репозиторию, так как skill может предоставить себе широкий доступ к инструментам. Этот skill позволяет Claude запускать команды git без одобрения за использование, когда вы вызываете его: 
---
name: commit
description: Stage and commit the current changes
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *)
---
Чтобы заблокировать skill от использования определённых инструментов, добавьте правила отказа в ваши параметры разрешений вместо этого.

​
Передайте аргументы в skills

Как вы, так и Claude можете передавать аргументы при вызове skill. Аргументы доступны через заполнитель $ARGUMENTS. Этот skill исправляет проблему GitHub по номеру. Заполнитель $ARGUMENTS заменяется на всё, что следует за именем skill: 
---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---

Fix GitHub issue $ARGUMENTS following our coding standards.

1. Read the issue description
2. Understand the requirements
3. Implement the fix
4. Write tests
5. Create a commit
Когда вы запускаете /fix-issue 123, Claude получает “Fix GitHub issue 123 following our coding standards…” Если вы вызываете skill с аргументами, но skill не включает $ARGUMENTS, Claude Code добавляет ARGUMENTS: <your input> в конец содержимого skill, чтобы Claude всё ещё видел, что вы ввели. Для доступа к отдельным аргументам по позиции используйте $ARGUMENTS[N] или более короткий $N: 
---
name: migrate-component
description: Migrate a component from one framework to another
---

Migrate the $ARGUMENTS[0] component from $ARGUMENTS[1] to $ARGUMENTS[2].
Preserve all existing behavior and tests.
Запуск /migrate-component SearchBar React Vue заменяет $ARGUMENTS[0] на SearchBar, $ARGUMENTS[1] на React и $ARGUMENTS[2] на Vue. Тот же skill, используя сокращение $N: 
---
name: migrate-component
description: Migrate a component from one framework to another
---

Migrate the $0 component from $1 to $2.
Preserve all existing behavior and tests.

​
Продвинутые паттерны

​
Внедрите динамический контекст

Синтаксис !`<command>` запускает команды оболочки перед отправкой содержимого skill Claude. Выходные данные команды заменяют заполнитель, поэтому Claude получает фактические данные, а не саму команду. Этот skill суммирует pull request, получая живые данные PR с помощью GitHub CLI. Команды !`gh pr diff` и другие запускаются первыми, и их выходные данные вставляются в подсказку: 
---
name: pr-summary
description: Summarize changes in a pull request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## Your task
Summarize this pull request...
Когда этот skill запускается:
  1. Каждый !`<command>` выполняется немедленно (перед тем, как Claude что-либо увидит)
  2. Выходные данные заменяют заполнитель в содержимом skill
  3. Claude получает полностью отрендеренную подсказку с фактическими данными PR
Это предварительная обработка, а не то, что Claude выполняет. Claude видит только окончательный результат. Подстановка выполняется один раз над исходным файлом. Выходные данные команды вставляются как простой текст и не переканализируются для дальнейших !`<command>` заполнителей, поэтому команда не может выдать заполнитель для последующего прохода для расширения. Для многострочных команд используйте блок кода, открытый с ```! вместо встроенной формы: 
## Environment
```!
node --version
npm --version
git status --short
```
Чтобы отключить это поведение для skills и пользовательских команд из источников пользователя, проекта, плагина или дополнительного каталога, установите "disableSkillShellExecution": true в параметры. Каждая команда заменяется на [shell command execution disabled by policy] вместо запуска. Встроенные и управляемые skills не затронуты. Этот параметр наиболее полезен в управляемых параметрах, где пользователи не могут его переопределить.
Чтобы запросить более глубокое рассуждение при запуске skill, включите ultrathink где-нибудь в содержимое skill. См. Используйте ultrathink для одноразового глубокого рассуждения.

​
Запустите skills в subagent

Добавьте context: fork в ваш frontmatter, когда вы хотите, чтобы skill запускался в изоляции. Содержимое skill становится подсказкой, которая управляет subagent. Он не будет иметь доступ к истории вашего разговора.
context: fork имеет смысл только для skills с явными инструкциями. Если ваш skill содержит рекомендации, такие как “используйте эти соглашения API” без задачи, subagent получает рекомендации, но не действенную подсказку, и возвращается без значимого выходного сигнала.
Skills и subagents работают вместе в двух направлениях:
ПодходСистемная подсказкаЗадачаТакже загружает
Skill с context: forkОт типа агента (Explore, Plan и т.д.)Содержимое SKILL.mdCLAUDE.md
Subagent с полем skillsТело markdown subagentСообщение делегирования ClaudeПредварительно загруженные skills + CLAUDE.md
С context: fork вы пишете задачу в своём skill и выбираете тип агента для её выполнения. Для обратного (определение пользовательского subagent, который использует skills как справочный материал), см. Subagents.

​
Пример: Research skill, используя Explore agent

Этот skill запускает исследование в forked Explore agent. Содержимое skill становится задачей, и агент предоставляет инструменты только для чтения, оптимизированные для исследования кодовой базы: 
---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: Explore
---

Research $ARGUMENTS thoroughly:

1. Find relevant files using Glob and Grep
2. Read and analyze the code
3. Summarize findings with specific file references
Когда этот skill запускается:
  1. Создаётся новый изолированный контекст
  2. Subagent получает содержимое skill в качестве своей подсказки (“Research $ARGUMENTS thoroughly…”)
  3. Поле agent определяет среду выполнения (модель, инструменты и разрешения)
  4. Результаты суммируются и возвращаются в ваш основной разговор
Поле agent указывает, какую конфигурацию subagent использовать. Опции включают встроенные агенты (Explore, Plan, general-purpose) или любой пользовательский subagent из .claude/agents/. Если опущено, использует general-purpose.

​
Ограничьте доступ Claude к skills

По умолчанию Claude может вызывать любой skill, у которого не установлен disable-model-invocation: true. Skills, которые определяют allowed-tools, предоставляют Claude доступ к этим инструментам без одобрения за использование, когда skill активен. Ваши параметры разрешений по-прежнему управляют поведением одобрения базовой линии для всех остальных инструментов. Несколько встроенных команд также доступны через инструмент Skill, включая /init, /review и /security-review. Другие встроенные команды, такие как /compact, недоступны. Три способа управления, какие skills может вызывать Claude: Отключите все skills, отказав в инструменте Skill в /permissions: 
# Add to deny rules:
Skill
Разрешите или запретите конкретные skills, используя правила разрешений: 
# Allow only specific skills
Skill(commit)
Skill(review-pr *)

# Deny specific skills
Skill(deploy *)
Синтаксис разрешений: Skill(name) для точного совпадения, Skill(name *) для совпадения префикса с любыми аргументами. Скройте отдельные skills, добавив disable-model-invocation: true в их frontmatter. Это полностью удаляет skill из контекста Claude.
Поле user-invocable управляет только видимостью меню, а не доступом инструмента Skill. Используйте disable-model-invocation: true, чтобы заблокировать программный вызов.

​
Переопределите видимость skill из параметров

Параметр skillOverrides управляет видимостью skill из ваших параметров вместо frontmatter самого skill. Используйте его для skills, чей SKILL.md вы не хотите редактировать, например для тех, которые проверены в общем репозитории проекта или предоставлены MCP сервером. Меню /skills пишет его для вас: выделите skill и нажмите Space для циклического переключения состояний, затем Enter для сохранения в .claude/settings.local.json. Каждый ключ — это имя skill, и каждое значение — одно из четырёх состояний:
ЗначениеУказано ClaudeВ меню /
"on"Имя и описаниеДа
"name-only"Только имяДа
"user-invocable-only"СкрытоДа
"off"СкрытоСкрыто
Skill, отсутствующий в skillOverrides, рассматривается как "on". Пример ниже сворачивает один skill до его имени и полностью отключает другой: 
{
  "skillOverrides": {
    "legacy-context": "name-only",
    "deploy": "off"
  }
}
Skills плагинов не затронуты skillOverrides. Управляйте ими через /plugin вместо этого.

​
Делитесь skills

Skills могут распространяться на разных уровнях в зависимости от вашей аудитории:
  • Project skills: Зафиксируйте .claude/skills/ в контроле версий
  • Plugins: Создайте каталог skills/ в вашем плагине
  • Managed: Развёртывайте организацию-широко через управляемые параметры

​
Генерируйте визуальный выходной сигнал

Skills могут объединять и запускать скрипты на любом языке, давая Claude возможности, выходящие за рамки того, что возможно в одной подсказке. Один мощный паттерн — генерирование визуального выходного сигнала: интерактивные HTML файлы, которые открываются в вашем браузере для исследования данных, отладки или создания отчётов. Этот пример создаёт обозреватель кодовой базы: интерактивное древовидное представление, где вы можете развёртывать и свёртывать каталоги, видеть размеры файлов с первого взгляда и определять типы файлов по цвету. Создайте каталог Skill: 
mkdir -p ~/.claude/skills/codebase-visualizer/scripts
Сохраните это в ~/.claude/skills/codebase-visualizer/SKILL.md. Описание говорит Claude, когда активировать этот Skill, а инструкции говорят Claude запустить поставляемый скрипт. Путь скрипта использует ${CLAUDE_SKILL_DIR}, поэтому он разрешается правильно независимо от того, установлен ли skill на личном, проектном или плагин-уровне: 
---
name: codebase-visualizer
description: Generate an interactive collapsible tree visualization of your codebase. Use when exploring a new repo, understanding project structure, or identifying large files.
allowed-tools: Bash(python3 *)
---

# Codebase Visualizer

Generate an interactive HTML tree view that shows your project's file structure with collapsible directories.

## Usage

Run the visualization script from your project root:

```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/visualize.py .
```

This creates `codebase-map.html` in the current directory and opens it in your default browser.

## What the visualization shows

- **Collapsible directories**: Click folders to expand/collapse
- **File sizes**: Displayed next to each file
- **Colors**: Different colors for different file types
- **Directory totals**: Shows aggregate size of each folder
Сохраните это в ~/.claude/skills/codebase-visualizer/scripts/visualize.py. Этот скрипт сканирует дерево каталогов и генерирует самодостаточный HTML файл с:
  • Боковой панелью сводки, показывающей количество файлов, количество каталогов, общий размер и количество типов файлов
  • Столбчатой диаграммой, разбивающей кодовую базу по типу файла (топ 8 по размеру)
  • Свёртываемым деревом, где вы можете развёртывать и свёртывать каталоги, с цветовыми индикаторами типов файлов
Скрипт требует Python 3, но использует только встроенные библиотеки, поэтому нет пакетов для установки: 
#!/usr/bin/env python3
"""Generate an interactive collapsible tree visualization of a codebase."""

import json
import sys
import webbrowser
from html import escape
from pathlib import Path
from collections import Counter

IGNORE = {'.git', 'node_modules', '__pycache__', '.venv', 'venv', 'dist', 'build'}

def scan(path: Path, stats: dict) -> dict:
    result = {"name": path.name, "children": [], "size": 0}
    try:
        for item in sorted(path.iterdir()):
            if item.name in IGNORE or item.name.startswith('.'):
                continue
            if item.is_file():
                size = item.stat().st_size
                ext = item.suffix.lower() or '(no ext)'
                result["children"].append({"name": item.name, "size": size, "ext": ext})
                result["size"] += size
                stats["files"] += 1
                stats["extensions"][ext] += 1
                stats["ext_sizes"][ext] += size
            elif item.is_dir():
                stats["dirs"] += 1
                child = scan(item, stats)
                if child["children"]:
                    result["children"].append(child)
                    result["size"] += child["size"]
    except PermissionError:
        pass
    return result

def generate_html(data: dict, stats: dict, output: Path) -> None:
    ext_sizes = stats["ext_sizes"]
    total_size = sum(ext_sizes.values()) or 1
    sorted_exts = sorted(ext_sizes.items(), key=lambda x: -x[1])[:8]
    colors = {
        '.js': '#f7df1e', '.ts': '#3178c6', '.py': '#3776ab', '.go': '#00add8',
        '.rs': '#dea584', '.rb': '#cc342d', '.css': '#264de4', '.html': '#e34c26',
        '.json': '#6b7280', '.md': '#083fa1', '.yaml': '#cb171e', '.yml': '#cb171e',
        '.mdx': '#083fa1', '.tsx': '#3178c6', '.jsx': '#61dafb', '.sh': '#4eaa25',
    }
    lang_bars = "".join(
        f'<div class="bar-row"><span class="bar-label">{ext}</span>'
        f'<div class="bar" style="width:{(size/total_size)*100}%;background:{colors.get(ext,"#6b7280")}"></div>'
        f'<span class="bar-pct">{(size/total_size)*100:.1f}%</span></div>'
        for ext, size in sorted_exts
    )
    def fmt(b):
        if b < 1024: return f"{b} B"
        if b < 1048576: return f"{b/1024:.1f} KB"
        return f"{b/1048576:.1f} MB"

    html = f'''<!DOCTYPE html>
<html><head>
  <meta charset="utf-8"><title>Codebase Explorer</title>
  <style>
    body {{ font: 14px/1.5 system-ui, sans-serif; margin: 0; background: #1a1a2e; color: #eee; }}
    .container {{ display: flex; height: 100vh; }}
    .sidebar {{ width: 280px; background: #252542; padding: 20px; border-right: 1px solid #3d3d5c; overflow-y: auto; flex-shrink: 0; }}
    .main {{ flex: 1; padding: 20px; overflow-y: auto; }}
    h1 {{ margin: 0 0 10px 0; font-size: 18px; }}
    h2 {{ margin: 20px 0 10px 0; font-size: 14px; color: #888; text-transform: uppercase; }}
    .stat {{ display: flex; justify-content: space-between; padding: 8px 0; border-bottom: 1px solid #3d3d5c; }}
    .stat-value {{ font-weight: bold; }}
    .bar-row {{ display: flex; align-items: center; margin: 6px 0; }}
    .bar-label {{ width: 55px; font-size: 12px; color: #aaa; }}
    .bar {{ height: 18px; border-radius: 3px; }}
    .bar-pct {{ margin-left: 8px; font-size: 12px; color: #666; }}
    .tree {{ list-style: none; padding-left: 20px; }}
    details {{ cursor: pointer; }}
    summary {{ padding: 4px 8px; border-radius: 4px; }}
    summary:hover {{ background: #2d2d44; }}
    .folder {{ color: #ffd700; }}
    .file {{ display: flex; align-items: center; padding: 4px 8px; border-radius: 4px; }}
    .file:hover {{ background: #2d2d44; }}
    .size {{ color: #888; margin-left: auto; font-size: 12px; }}
    .dot {{ width: 8px; height: 8px; border-radius: 50%; margin-right: 8px; }}
  </style>
</head><body>
  <div class="container">
    <div class="sidebar">
      <h1>📊 Summary</h1>
      <div class="stat"><span>Files</span><span class="stat-value">{stats["files"]:,}</span></div>
      <div class="stat"><span>Directories</span><span class="stat-value">{stats["dirs"]:,}</span></div>
      <div class="stat"><span>Total size</span><span class="stat-value">{fmt(data["size"])}</span></div>
      <div class="stat"><span>File types</span><span class="stat-value">{len(stats["extensions"])}</span></div>
      <h2>By file type</h2>
      {lang_bars}
    </div>
    <div class="main">
      <h1>📁 {escape(data["name"])}</h1>
      <ul class="tree" id="root"></ul>
    </div>
  </div>
  <script>
    const data = {json.dumps(data)};
    const colors = {json.dumps(colors)};
    function fmt(b) {{ if (b < 1024) return b + ' B'; if (b < 1048576) return (b/1024).toFixed(1) + ' KB'; return (b/1048576).toFixed(1) + ' MB'; }}
    function esc(s) {{ return s.replace(/[&<>"']/g, c => ({{"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"}}[c])); }}
    function render(node, parent) {{
      if (node.children) {{
        const det = document.createElement('details');
        det.open = parent === document.getElementById('root');
        det.innerHTML = `<summary><span class="folder">📁 ${{esc(node.name)}}</span><span class="size">${{fmt(node.size)}}</span></summary>`;
        const ul = document.createElement('ul'); ul.className = 'tree';
        node.children.sort((a,b) => (b.children?1:0)-(a.children?1:0) || a.name.localeCompare(b.name));
        node.children.forEach(c => render(c, ul));
        det.appendChild(ul);
        const li = document.createElement('li'); li.appendChild(det); parent.appendChild(li);
      }} else {{
        const li = document.createElement('li'); li.className = 'file';
        li.innerHTML = `<span class="dot" style="background:${{colors[node.ext]||'#6b7280'}}"></span>${{esc(node.name)}}<span class="size">${{fmt(node.size)}}</span>`;
        parent.appendChild(li);
      }}
    }}
    data.children.forEach(c => render(c, document.getElementById('root')));
  </script>
</body></html>'''
    output.write_text(html)

if __name__ == '__main__':
    target = Path(sys.argv[1] if len(sys.argv) > 1 else '.').resolve()
    stats = {"files": 0, "dirs": 0, "extensions": Counter(), "ext_sizes": Counter()}
    data = scan(target, stats)
    out = Path('codebase-map.html')
    generate_html(data, stats, out)
    print(f'Generated {out.absolute()}')
    webbrowser.open(f'file://{out.absolute()}')
Чтобы протестировать, откройте Claude Code в любом проекте и попросите “Visualize this codebase.” Claude запускает скрипт, генерирует codebase-map.html и открывает его в вашем браузере. Этот паттерн работает для любого визуального выходного сигнала: графики зависимостей, отчёты о покрытии тестами, документация API или визуализации схемы базы данных. Поставляемый скрипт выполняет тяжёлую работу, пока Claude обрабатывает оркестрацию.

​
Устранение неполадок

​
Skill не срабатывает

Если Claude не использует ваш skill при необходимости:
  1. Проверьте, что описание включает ключевые слова, которые пользователи естественно скажут
  2. Убедитесь, что skill появляется в What skills are available?
  3. Попробуйте переформулировать ваш запрос, чтобы лучше соответствовать описанию
  4. Вызовите его напрямую с помощью /skill-name, если skill может быть вызван пользователем

​
Skill срабатывает слишком часто

Если Claude использует ваш skill, когда вы этого не хотите:
  1. Сделайте описание более конкретным
  2. Добавьте disable-model-invocation: true, если вы хотите только ручной вызов

​
Описания skills обрезаны

Описания skills загружаются в контекст, чтобы Claude знал, что доступно. Все имена skills всегда включены, но если у вас много skills, описания сокращаются, чтобы соответствовать бюджету символов, что может удалить ключевые слова, которые Claude нужны для совпадения с вашим запросом. Бюджет масштабируется на 1% контекстного окна модели. Когда он переполняется, описания для skills, которые вы вызываете реже всего, удаляются в первую очередь, поэтому skills, которые вы фактически используете, сохраняют полный текст. Запустите /doctor, чтобы увидеть, переполняется ли бюджет и какие skills затронуты. Чтобы повысить бюджет, установите параметр skillListingBudgetFraction (например, 0.02 = 2%) или переменную окружения SLASH_COMMAND_TOOL_CHAR_BUDGET на фиксированное количество символов. Чтобы освободить бюджет для других skills, установите записи с низким приоритетом на "name-only" в skillOverrides, чтобы они отображались без описания. Вы также можете обрезать текст description и when_to_use в источнике: поместите ключевой вариант использования в начало, так как комбинированный текст каждой записи ограничен 1 536 символами независимо от бюджета. Лимит настраивается с помощью maxSkillDescriptionChars.

​
Связанные ресурсы

  • Отладка вашей конфигурации: диагностируйте, почему skill не появляется или не срабатывает
  • Subagents: делегируйте задачи специализированным агентам
  • Plugins: упакуйте и распространяйте skills с другими расширениями
  • Hooks: автоматизируйте рабочие процессы вокруг событий инструментов
  • Memory: управляйте файлами CLAUDE.md для постоянного контекста
  • Commands: справочник для встроенных команд и встроенных skills
  • Permissions: управляйте доступом к инструментам и skills