# Навыки

Источник: https://razum.sh/docs/customize/skills

> Инструкции для типовых задач, которые агент подключает сам, когда задача на них похожа.

Навык — это «как мы делаем X»: как готовить коммерческое предложение, как разбирать
выгрузку из CRM, как выпускать релиз. В отличие от правил, навык не висит в каждой
задаче: агент видит только его название и описание и загружает целиком, когда задача на
него похожа. В чате это видно строкой «Использовал навык …».

## Формат

Навык — папка с файлом `SKILL.md`. Рядом можно положить шаблоны, примеры и скрипты, на
которые ссылается инструкция.

```md title=".razum/skills/commercial-offer/SKILL.md"
---
name: commercial-offer
description: Коммерческое предложение для B2B-клиента. Используй, когда просят КП, предложение или расчёт для компании.
---

# Коммерческое предложение

1. Возьми реквизиты клиента из ЕГРЮЛ по ИНН.
2. Цены — из `prices.csv` рядом с этим файлом, в рублях без НДС.
3. Структура: задача клиента → решение → стоимость → сроки → контакты.
4. Сохрани результат документом и предложи опубликовать.
```

* **`name`** — короткое имя латиницей.
* **`description`** — главное поле: по нему агент решает, когда звать навык. Пишите, что
  навык делает и **когда** его использовать.
* **`paths`** — необязательно: навык предлагается, когда агент работает с подходящими
  файлами.

## Где лежат навыки

| Папка                      | Для кого                                               |
| -------------------------- | ------------------------------------------------------ |
| `.razum/skills/` в проекте | Навыки этого проекта, вместе с кодом в git             |
| `~/.razum/skills/`         | Ваши навыки для всех проектов на этом компьютере       |
| Плагины                    | Навыки из установленных [плагинов](https://razum.sh/docs/customize/plugins) |
| Встроенные                 | Навыки, которые идут с «Разумом»                       |

Все навыки видны в «Персонализации» на вкладке «Навыки»: там их можно включить,
выключить, посмотреть содержимое и удалить.

## Создать навык

Проще всего — с агентом: «Персонализация» → «Навыки» → «Создать с агентом». Агент
расспросит, чему навык учит и когда его применять, и сам запишет `SKILL.md`. Можно и
словами в любом чате:

> Создай навык: как мы готовим еженедельный отчёт для руководителя. Возьми за образец отчёт в `reports/2026-09-26.md`.

Чтобы вызвать навык явно, выберите его в меню «+» поля ввода → «Навыки».

## Навыки сотрудников

У каждого сотрудника свои навыки, они живут на его облачном компьютере. Попросите
сотрудника создать навык — он будет доступен ему и его агентам.

Навыки из Cursor и Claude Code переносятся [импортом](https://razum.sh/docs/customize/import).