# agent-skills

Правило задаёт стандарты создания навыков для GitHub Copilot. Оно помогает правильно оформить файл SKILL.md, настроить триггеры активации и структурировать инструкции.

- правило · `type=rule` · GitHub Copilot · ★ 40418
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/instructions/agent-skills.instructions.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/rules/agent-skills

## Что делает

Правило активируется при редактировании файлов по маске `**/skills/**/SKILL.md`. Оно указывает Copilot, как проверять структуру пользовательских навыков. Навык хранится в отдельной папке и содержит инструкции вместе с шаблонами или скриптами. В отличие от общих правил кодинга, такие навыки подключаются динамически под конкретную задачу.

Главное требование касается шапки frontmatter. Поле `name` ограничено 64 символами в нижнем регистре через дефис, а `description` должно занимать от 10 до 1024 знаков в одинарных кавычках. Если описание составлено размыто, Copilot не запустит сценарий. Ассистент считывает только имя и описание для автоподбора навыка. Поэтому в описании нужно чётко указывать действия и условия вызова.

Инструкция задаёт состав разделов документа, включая пошаговые рабочие процессы и таблицу неполадок. Если процедура насчитывает больше 5 шагов, правило рекомендует выносить подробности в папку `references/`. Хранить готовые навыки советуют в каталоге `.github/skills/` внутри репозитория либо глобально в `~/.copilot/skills/`.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/instructions/agent-skills.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/agent-skills.md` — Поле paths во frontmatter ограничивает файлы: applyTo из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/agent-skills.mdc` — Во frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/agent-skills.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/agent-skills.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/github/awesome-copilot/tree/HEAD/instructions/agent-skills.instructions.md

## Когда брать
- оформить файл SKILL.md по стандартам репозитория
- составить frontmatter с триггерами для автозапуска навыка
- структурировать пошаговые инструкции и таблицы неполадок
- вынести длинные сценарии в каталог references

## Примеры запросов агенту
- Создай файл `.github/skills/webapp-testing/SKILL.md` для тестирования интерфейса через Playwright.
- Проверь frontmatter в файле `skills/deploy/SKILL.md` и добавь триггеры вызова в `description`.
- Оформи раздел `Gotchas` и пошаговый процесс в файле `.github/skills/docker-build/SKILL.md`.

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 732 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md