Навыки¶

Создание навыков¶

Через интерфейс¶

Шаг 1: Откройте панель навыков

1. Откройте чат Koda
2. Переключитесь в режим Агент
3. Нажмите Навыки в панели инструментов
4. В секции Глобальные навыки или Локальные навыки введите желаемое название нового навыка и нажмите +
5. Откроется новая вкладка редактора со свежесозданным файлом SKILL.md – заполните его инструкциями

Koda создаст файл SKILL.md с шаблоном:

---
name: my-skill
description: Describe when this skill should be used
---

# my-skill

## Purpose
Describe the purpose of this skill

## When to use
Describe when this skill should be activated

## Instructions
Step-by-step instructions for the AI model

## Examples
Examples of how to use this skill

Создание вручную¶

Шаг 1: Создайте директорию

# Локальный навык в проекте
mkdir -p .koda/skills/my-skill

# Глобальный навык
mkdir -p ~/.koda/skills/my-skill

Шаг 2: Создайте файл SKILL.md

# Локальный
touch .koda/skills/my-skill/SKILL.md

# Глобальный
touch ~/.koda/skills/my-skill/SKILL.md

Шаг 3: Заполните файл

Откройте файл и добавьте frontmatter и инструкции.

Просмотр списка навыков¶

1. Откройте Koda в режиме Агент
2. Нажмите Навыки
3. Просмотрите список:
4. Глобальные навыки — установленные в домашней директории текущего пользователя ОС
5. Локальные навыки — установленные в директории проекта

Обновление списка навыков¶

Если вы добавили/изменили навыки вручную:

Через интерфейс:

1. Откройте Навыки
2. Нажмите Обновить список навыков

Перезапуск IDE:

• Закройте и откройте IDE
• Навыки загрузятся автоматически

Включение/выключение навыков¶

В ходе своей работы, модель знает только о тех навыках, которые активированы (включены) в панели навыков.

1. Откройте Навыки
2. Найдите нужный навык в списке
3. Используйте переключатель справа для (де)активации навыка.

Удаление навыков¶

1. Откройте Навыки
2. Найдите ненужный навык в списке
3. Нажмите на кнопку (Удалить)
4. Подтвердите удаление

Использование навыков¶

Модель выбирает тот навык, у которого поле description наиболее близко подходит для решения вашей задачи.

Вы: Создай React компонент для формы логина
Модель: [распознаёт задачу → навык "react-component"]
Модель: [вызывает read_skill с параметром "react-component"]
Модель: [следует инструкциям из навыка]

Также можно явно попросить модель использовать какой-нибудь конкретный навык, указав его название (name).

Вы: Используй навык python-api для создания endpoint
Агент: [вызывает read_skill: python-api]
Агент: [следует инструкциям]

Решение проблем¶

Навык не отображается в списке¶

Причины:

• Неправильное расположение файла
• Ошибка в frontmatter
• Навык выключен

Решения:

1. Проверьте расположение:

   # Локальный
   ls .koda/skills/my-skill/SKILL.md
   # Глобальный
   ls ~/.koda/skills/my-skill/SKILL.md
   

2. Проверьте frontmatter:

   ---
   name: my-skill          # Обязательно
   description: Описание   # Обязательно
   ---
   

3. Проверьте статус:
4. Откройте Навыки
5. Убедитесь, что навык включён

Ошибка "Skill not found"¶

Причины:

• Неправильное имя навыка
• Навык не загружен

Решения:

1. Проверьте имя:

   # Имя должно совпадать с названием директории
   .koda/skills/my-skill/SKILL.md
   # name: my-skill
   

2. Обновите список:
3. Нажмите 🔄 в панели навыков
4. Или перезапустите IDE

Навык не активируется автоматически¶

Причины:

• Непонятное описание
• Модель не распознаёт задачу

Решения:

1. Улучшите description:

   ---
   name: react-component
   description: |
     Создание React компонентов с лучшими практиками.
     Используй когда пользователь просит создать компонент,
     упоминает React, JSX, или frontend.
   ---
   

2. Добавьте ключевые слова:

   ## When to use
   Используй этот навык когда:
   - Пользователь просит "создай компонент"
   - Упоминается "React", "JSX", "frontend"
   - Нужно создать UI элемент
   

3. Используйте явно:

   Вы: Используй навык react-component для создания формы
   

Ошибка при чтении навыка¶

Причины:

• Повреждён файл
• Неправильный формат Markdown

Решения:

1. Проверьте файл:

   cat .koda/skills/my-skill/SKILL.md
   

2. Исправьте формат:
3. Убедитесь, что frontmatter разделён ---
4. Проверьте отступы в YAML
5. Убедитесь, что Markdown валиден
6. Пересоздайте навык:
7. Удалите навык
8. Создайте заново через интерфейс