AIKraft/AI/Войти
AIKraft/Skills/Написание отличных навыков

Написание отличных навыков

Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.

mattpocock official Документы

Что делает навык

Написание отличных навыков — это справочник по качественному написанию и редактированию skills, описывающий терминологию и принципы, которые делают поведение ИИ-агента предсказуемым. Главная цель — выработать детерминизм из стохастической системы, обеспечивая стабильный процесс выполнения задач.

Когда применять

  • Создание новых навыков (skills) для ИИ-агентов с нуля.
  • Редактирование существующих описаний навыков для оптимизации контекстной нагрузки.
  • Выбор между модельным и пользовательским вызовом навыка в зависимости от требований к автономности.
  • Управление когнитивной нагрузкой при большом количестве пользовательских навыков с помощью router skill.

Как работает

  1. Определите, нужен ли автономный вызов: если агент или другой навык должен запускать его сам, используйте model-invocation; если только вручную — user-invocation.
  2. Для model-invocation напишите описание, ориентированное на модель, с богатыми триггерными фразами (например, 'Use when the user wants…'), избегая лишних слов для снижения context load.
  3. Для user-invocation установите disable-model-invocation: true и напишите краткое однострочное описание для человека, убрав списки триггеров.
  4. Если количество user-invoked навыков превышает возможности памяти, создайте router skill — один пользовательский навык, который перечисляет остальные и указывает, когда их использовать.
  5. Постоянно сокращайте описание, так как каждое слово увеличивает context load, а предсказуемость процесса важнее идентичности вывода.

Примеры запросов агенту

Напиши описание для навыка, который должен запускаться автоматически, когда пользователь упоминает 'редактирование текста'.
Создай user-invoked навык с отключенным модельным вызовом для функции 'очистка кэша'.
Разработай router skill, который будет вызывать различные инструменты анализа данных в зависимости от типа запроса.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «writing-great-skills» из репозитория: # https://github.com/mattpocock/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r writing-great-skills/ ~/.claude/skills/writing-great-skills/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.