# Навыки для AI-ассистентов

Коллекция навыков (skills) для AI-ассистентов и сред разработки.

## Список навыков

- **[format-html](./format-html/SKILL.md)** — форматирование и исправление сырой HTML-разметки (отступы в 4 пробела, выравнивание структуры, закрытие тегов).
- **[html-to-scss](./html-to-scss/SKILL.md)** — генерация структуры SCSS по методологии БЭМ на основе переданной HTML-разметки.
- **[backend-integration-guide](./backend-integration-guide/SKILL.md)** — генерация краткой инструкции по интеграции вёрстки для бэкенда/CMS по git-коммиту.
- **[optimize-fonts](./optimize-fonts/SKILL.md)** — оптимизация подключения шрифтов: сабсетинг, variable-шрифты, `unicode-range` и metric-override fallback для устранения сдвига (CLS).
- **[plan-orchestrator](./plan-orchestrator/SKILL.md)** — исполнение согласованного плана по пунктам силами субагентов: фаза плана, вопросы, работа, независимая проверка и коммит на каждый пункт.

## Установка

Для установки навыков рекомендуется использовать CLI-пакет [skills](https://www.npmjs.com/package/skills):

```bash
# Установка навыка из репозитория
npx skills add git@gitea.optiweb.ru:public/skills.git
```

Также можно вручную скопировать папку нужного навыка в директорию скиллов вашего ассистента (например, `.agents/skills/`).

## Добавление нового навыка

1. Создайте папку с именем навыка (например, `my-skill/`).
2. Добавьте в неё файл `SKILL.md` с описанием и правилами работы.
3. Пишите `SKILL.md` на английском: название, описание, правила, примеры и шаблоны промптов. Навык читают ассистенты в разных проектах, и по-английски он срабатывает стабильнее. Если навык формирует текст для конкретного проекта, язык задаётся внутри навыка правилом — по инструкциям проекта (`AGENTS.md`, `CLAUDE.md`) или по языку пользователя; пример — `plan-orchestrator`, раздел «Prompt language».
4. Добавьте информацию о новом навыке в список в `README.md`.