AI: Skills

URLs
Описание
Icon for https://claude.com/skills
Skills | Claude
Док Antrophic
Icon for https://opencode.ai/docs/ru/skills/
Навыки агента
Док OpenCode
Icon for https://agentskills.io/
Overview - Agent Skills
Открытый стандарт
Icon for https://skills.sh/
The Agent Skills Directory
Skills Library
Icon for https://skillsmp.com/
Agent Skills Marketplace - Claude, Codex & ChatGPT Skills | SkillsMP
Skills Marketplace
Icon for https://github.com/obra/superpowers/
GitHub - obra/superpowers: An agentic skills framework & software development methodology that works.
Библиотека навыков
Icon for https://12gramsofcarbon.com/p/your-agent-skills-are-all-slop
Your agent skills are all slop
Почему лучше писать навыки самим
Icon for https://scottspence.com/posts/claude-code-skills-dont-auto-activate
Claude Code Skills Don't Auto-Activate (a workaround) - Scott Spence
Workaround по авто-вызовам навыков
Icon for https://scottspence.com/posts/how-to-make-claude-code-skills-activate-reliably
How to Make Claude Code Skills Activate Reliably - Scott Spence
Workaround по авто-вызовам навыков
Icon for https://arxiv.org/pdf/2602.12670
https://arxiv.org/pdf/2602.12670
Исследования по использованию навыков
Icon for https://www.groff.dev/blog/implementing-claude-md-agent-skills
Implementing CLAUDE.md and Agent Skills In Your Repository - Matthew Groff
Советы
Skills (Навыки) — это упакованная экспертиза (инструкции, скрипты, контекст), которая позволяет ИИ-агентам выполнять специфические задачи более точно и эффективно. Навыки загружаются в контекст динамически, экономя ресурсы.


Как работает

    Обнаружение: Изначально агент видит только Frontmatter навыка (имя и описание) в списке доступных инструментов. Полный текст инструкции в контексте отсутствует.
    Выбор: Агент анализирует запрос пользователя и выбирает подходящий навык.
    Активация: Если навык нужен для текущей задачи (или получена явная команда), агент делает Tool Call для загрузки содержимого.
    Исполнение: Полный текст SKILL.md и связанные файлы загружаются в контекстное окно, и агент выполняет инструкции.


Структура

Навык представляет собой папку с файлом конфигурации.
skills/
|- {skill-name}/ # Директория скилла
|-- SKILL.md     # Определение навыка (инструкция)
|-- scripts/     # Вспомогательные скрипты (опционально)
|--- *.py        # Чаще всего python или js\ts
|-- # Любые другие файлы и директории, нужные навыку

Расположение:
  • Локально в проекте .{agent-name}/skills/{skill-name}/ .
  • Глобально у пользователя ~/.{agent-name}/skills/{skill-name} .

Файл SKILL.md:
  • YAML-шапка (Frontmatter):
  • name: Идентификатор для вызова.
  • description: Описание, чтобы агент понял, когда активировать навык.
  • Тело инструкции (Markdown):
  • Инструкции, примеры, требования, ограничения, вопросы, которые нужно уточнить у пользователя.
--- // Frontmatter
name: skill-name // Уникальное имя (a-z, 0-9, дефисы)
description: Use when... // Краткое описание (1-2 предложения, до 500 знаков)
---

// Основные инструкции в Markdown


Для чего

  • Экономия контекста: В отличие от Rules, которые всегда занимают контекст, навыки подгружаются только при необходимости или по востребованию.
  • Специализированные знания: Для задач, требующих специфического контекста (например, написание тестов, проведение код-ревью и т.д.)
  • Строгие рабочие процессы: Когда нужно гарантировать выполнение чек-листа или последовательности шагов (например, выполнение задачи по плану).


Примеры

  • Создание тестов;
  • Поиск информации в коде;
  • Рефакторинг;
  • Написание тех документации;
  • Добавление комментариев в код.


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

не все способы могут быть доступны у вашего агента. 5 - самый универсальный
    Агент автоматически выбирает подходящий навык на основе запроса:
  • Напиши юнит-тесты для класса Player → активирует create-unit-tests
  • Сделай ревью моих изменений → активирует review-code
    Явный запрос на использование навыка:
  • Задокументируй этот класс, используя навык → активирует add-summary
    Вызов через /, как  Command⁠ :
  • /rnd-task Добавление статуса "Отравление"
    Вызов через  Hook⁠  перед обработкой промпта или после ответа агента.
    Добавление в контекст через @, как  Workflow⁠ :
  • Персонаж бежит не туда, исправь по инструкции @fix-bug/SKILL.md


Best Practices

    Использование навыков даёт существенный прирост в эффективности решения задач. Меньшие и более дешевые модели, снабженные хорошими навыками, способны превосходить более крупные модели без навыков.
    Создавайте для всех частых повторяющихся действий/промптов/инструкций.
    Можно создавать цепочки навыков, когда один навык отдаёт требование на запуск другого.
    Компактные и умеренно детализированные инструкции работают гораздо лучше, чем длинные документы. Оптимально до 150 строк или до 1000 токенов.
    Оптимальное количество навыков для одной задачи — от 2 до 3. 4 и более навыков перегружает агента и снижает эффективность.
    Пишите навыки самостоятельно. Модели не обучены генерировать навыки сами для себя. Агент со сгенерированными навыками работает даже хуже, чем без них совсем.
    На практике агенты часто игнорируют навыки. Хук, который заставляет агента перед ответом вывести список навыков и явно написать YES/NO для каждого — нужен ли он сейчас, повышает срабатывание до ~84%.
    Поле description должно отвечать на вопрос "Когда это использовать?", а не "Что это такое".
    Используйте теги <required> или прямые приказы («CRITICAL», «MANDATORY»). Агенты лучше реагируют на императивный тон в инструкциях навыка.
    Навык должен быть самодостаточным. Если он требует внешних скриптов, положите их в папку scripts/ внутри навыка.
    Навыки изначально разрабатывались как более эффективная и экономная в плане контекста замена  🔌⁠⁠AI: MCP⁠  . Вы можете заменять свои MCP на кастомные скиллы.