---
read_when:
    - Ви створюєте нову користувацьку навичку у своєму робочому просторі
    - Вам потрібен швидкий стартовий робочий процес для Skills на основі SKILL.md
summary: Створюйте й тестуйте власні Skills робочого простору з SKILL.md
title: Створення Skills
x-i18n:
    generated_at: "2026-05-11T21:00:03Z"
    model: gpt-5.5
    provider: openai
    source_hash: a468a0b21f4e43542b175b8acb8ad8b19dbbea06ce8e0b97c48206bf88a661c5
    source_path: tools/creating-skills.md
    workflow: 16
---

Skills навчають агента, як і коли використовувати інструменти. Кожна навичка — це каталог,
що містить файл `SKILL.md` із YAML frontmatter та інструкціями markdown.

Про те, як навички завантажуються та пріоритезуються, див. [Skills](/uk/tools/skills).

## Створіть свою першу навичку

<Steps>
  <Step title="Створіть каталог навички">
    Навички розміщуються у вашому робочому просторі. Створіть нову папку:

    ```bash
    mkdir -p ~/.openclaw/workspace/skills/hello-world
    ```

  </Step>

  <Step title="Напишіть SKILL.md">
    Створіть `SKILL.md` у цьому каталозі. Frontmatter визначає метадані,
    а тіло markdown містить інструкції для агента.

    ```markdown
    ---
    name: hello-world
    description: A simple skill that says hello.
    ---

    # Hello World Skill

    When the user asks for a greeting, use the `echo` tool to say
    "Hello from your custom skill!".
    ```

    Використовуйте hyphen-case з малими літерами, цифрами та дефісами для
    `name` навички. Узгоджуйте назву папки та `name` у frontmatter.

  </Step>

  <Step title="Додайте інструменти (необов’язково)">
    Ви можете визначити власні схеми інструментів у frontmatter або доручити агенту
    використовувати наявні системні інструменти (наприклад, `exec` або `browser`). Навички також можуть
    постачатися всередині plugins разом з інструментами, які вони документують.

  </Step>

  <Step title="Завантажте навичку">
    Запустіть новий сеанс, щоб OpenClaw підхопив навичку:

    ```bash
    # From chat
    /new

    # Or restart the gateway
    openclaw gateway restart
    ```

    Перевірте, що навичку завантажено:

    ```bash
    openclaw skills list
    ```

  </Step>

  <Step title="Протестуйте її">
    Надішліть повідомлення, яке має активувати навичку:

    ```bash
    openclaw agent --message "give me a greeting"
    ```

    Або просто поспілкуйтеся з агентом і попросіть привітання.

  </Step>
</Steps>

## Довідник метаданих навички

YAML frontmatter підтримує такі поля:

| Поле                                | Обов’язково | Опис                                                           |
| ----------------------------------- | ----------- | -------------------------------------------------------------- |
| `name`                              | Так         | Унікальний ідентифікатор із малих літер, цифр і дефісів        |
| `description`                       | Так         | Однорядковий опис, показаний агенту                            |
| `metadata.openclaw.os`              | Ні          | Фільтр ОС (`["darwin"]`, `["linux"]` тощо)                     |
| `metadata.openclaw.requires.bins`   | Ні          | Обов’язкові бінарні файли в PATH                               |
| `metadata.openclaw.requires.config` | Ні          | Обов’язкові ключі конфігурації                                 |

## Найкращі практики

- **Будьте лаконічні** — інструктуйте модель, _що_ робити, а не як бути ШІ
- **Безпека передусім** — якщо ваша навичка використовує `exec`, переконайтеся, що підказки не дозволяють довільне впровадження команд із недовіреного вводу
- **Тестуйте локально** — використовуйте `openclaw agent --message "..."` для тестування перед поширенням
- **Використовуйте ClawHub** — переглядайте навички та долучайтеся до них на [ClawHub](https://clawhub.ai)

## Де розміщуються навички

| Розташування                    | Пріоритет       | Область застосування       |
| ------------------------------- | --------------- | -------------------------- |
| `\<workspace\>/skills/`         | Найвищий        | Для окремого агента        |
| `\<workspace\>/.agents/skills/` | Високий         | Для агента робочого простору |
| `~/.agents/skills/`             | Середній        | Спільний профіль агента    |
| `~/.openclaw/skills/`           | Середній        | Спільно (усі агенти)       |
| Вбудовані (постачаються з OpenClaw) | Низький      | Глобальна                  |
| `skills.load.extraDirs`         | Найнижчий       | Власні спільні папки       |

## Пов’язане

- [Довідник Skills](/uk/tools/skills) — правила завантаження, пріоритету та gating
- [Конфігурація Skills](/uk/tools/skills-config) — схема конфігурації `skills.*`
- [ClawHub](/uk/clawhub) — публічний реєстр навичок
- [Створення Plugins](/uk/plugins/building-plugins) — plugins можуть постачати навички