# skill-best-practices

Руководство по созданию, оформлению и отладке файлов SKILL.md. Помогает настроить триггеры вызова и проверить структуру навыков перед коммитом.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3500 установок
- Автор: dboeckli
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dboeckli/ai-agent-skills/tree/HEAD/.claude/skills/skill-best-practices/SKILL.md
- Обновлён: 2026-09-29
- HTML: https://affpapa.org/nevibecode/skills/skill-best-practices

## Что делает

Скилл задаёт правила разработки навыков для ИИ-агентов. Он помогает пройти путь от выбора сценария до сборки каталога с `SKILL.md`, скриптами в `scripts/` и справочными материалами в `references/`. Главный акцент сделан на блоке YAML frontmatter. Поле `description` определяет, когда агент подгружает инструкцию в контекст, поэтому в руководство включены шаблоны триггерных фраз и негативных условий вызова.

Для проверки разметки в репозитории предусмотрен скрипт `bash .claude/skills/skill-best-practices/scripts/validate-skills.sh`. Он находит типовые ошибки YAML вроде блочных скаляров и сбитых отступов до отправки изменений в ветку. Для общей настройки окружения Claude Code или работы с хуками этот скилл не предназначен.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dboeckli/ai-agent-skills --skill skill-best-practices -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/skill-best-practices/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/skill-best-practices/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dboeckli/ai-agent-skills --skill skill-best-practices -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/skill-best-practices/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dboeckli/ai-agent-skills --skill skill-best-practices -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/skill-best-practices/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dboeckli/ai-agent-skills skill-best-practices
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/skill-best-practices/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dboeckli/ai-agent-skills --skill skill-best-practices -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dboeckli/ai-agent-skills --path .claude/skills/skill-best-practices
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/skill-best-practices/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add dboeckli/ai-agent-skills --skill skill-best-practices -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dboeckli/ai-agent-skills/tree/HEAD/.claude/skills/skill-best-practices/SKILL.md

## Когда брать
- составить описание навыка в `SKILL.md` с чёткими условиями вызова
- провести аудит существующего навыка по чек-листу
- устранить пропуски активации или ложные срабатывания агента
- проверить корректность YAML-разметки через bash-скрипт

## Примеры запросов агенту
- Помоги составить SKILL.md для нового навыка планирования спринтов
- Проверь мой SKILL.md и укажи на ошибки в триггерах
- Скилл не подгружается сам, помоги переписать описание

## Похожие
- [diff-intake](https://affpapa.org/nevibecode/skills/diff-intake.md) — скилл · 42800 установок
- [home-assistant-best-practices](https://affpapa.org/nevibecode/skills/home-assistant-best-practices.md) — скилл · 8600 установок
- [turbo-pipelines](https://affpapa.org/nevibecode/skills/turbo-pipelines.md) — скилл · 3600 установок
- [edge-signal-aggregator](https://affpapa.org/nevibecode/skills/edge-signal-aggregator.md) — скилл · 3200 установок
- [edge-pipeline-orchestrator](https://affpapa.org/nevibecode/skills/edge-pipeline-orchestrator.md) — скилл · 3200 установок
- [nemotron-customize](https://affpapa.org/nevibecode/skills/nemotron-customize.md) — скилл · 2100 установок

Из того же набора: [dboeckli/ai-agent-skills](https://affpapa.org/nevibecode/by/dboeckli/ai-agent-skills.md) — 5 карточек

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

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