Скиллы

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

Поиск скилла

1. Откройте приложение «Скиллы».
2. Используйте поиск по названию или назначению.
3. Откройте карточку, чтобы изучить описание и входящие файлы.
4. Подключите скилл к текущему рабочему пространству.

Как использовать скилл в чате

1. Откройте карточку подключённого скилла.
2. Нажмите действие прикрепления.
3. Сформулируйте конкретную задачу.
4. Укажите агенту использовать приложенный скилл.

Одновременно прикладывайте только те скиллы, которые действительно нужны. Конфликтующие инструкции ухудшают результат.

Собственный скилл

Кнопка Добавить свой позволяет загрузить Markdown-файл или папку с Markdown-файлами. Один файл автоматически преобразуется в структуру <имя>/SKILL.md. Перед загрузкой проверьте:

• понятное название и назначение;
• одну ограниченную область ответственности;
• полный файл инструкций;
• отсутствие секретов;
• отсутствие опасных или слишком широких команд;
• относительные пути к дополнительным материалам.

Подключение и отключение

• Подключение устанавливает скилл в рабочее пространство.
• Отключение удаляет community-скилл из доступного набора, но не отменяет уже выполненные изменения.
• Встроенные скиллы Promto отключить нельзя.
• Перед обновлением пользовательского скилла проверьте, не зависит ли текущая работа от старой версии.

Если скилл не работает

1. Убедитесь, что он подключён.
2. Проверьте, что в карточке отображаются его файлы.
3. Приложите скилл к новому сообщению.
4. Назовите ожидаемый результат и критерии готовности.
5. Если загрузка завершилась ошибкой, исправьте структуру пакета и повторите.

Скилл дополняет задачу, а не заменяет её. Агенту всё равно нужны цель, контекст и ограничения.

Инструкции и CLI для агента

Отдельной focused-инструкции с English title и topic для приложения «Скиллы» нет. Источником правил служит файл SKILL.md самого подключённого скилла; это инструкция, а не исполняемая CLI-команда. Если задача относится к отдельной области Promto, агент дополнительно загружает соответствующий topic, например design, mobile, git или publish.

Доверенные механизмы:

• подключённый скилл по его точному slug — агент должен полностью прочитать его SKILL.md и следовать указанному там workflow;
• skills — реальный npm CLI для установки скилла из репозитория. Каноническая команда: npx --yes skills add <repository> -g -y --copy --skill "<slug>". Она нужна для установки, но не для «запуска» уже подключённого скилла;
• read, grep, find и ls — встроенные tools агента для чтения инструкции и связанных с ней файлов; это не shell CLI.

Не просите агента вызвать несуществующие команды use_skill, run_skill или передать get_instruction несуществующий topic skills.

Готовый промпт для агента

Используй подключённый скилл "<точный-slug>". Сначала найди и полностью прочитай его SKILL.md и все обязательные файлы, на которые он прямо ссылается. Коротко назови применяемый workflow, затем выполни задачу по нему. Не устанавливай скилл повторно и не выдумывай команды use_skill или topic "skills". Если для предметной области существует focused-инструкция Promto, загрузи её отдельным get_instruction с реальным topic.