diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c32abba
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Навыки для AI-ассистентов
+
+Коллекция навыков (skills) для AI-ассистентов и сред разработки.
+
+## Список навыков
+
+- **[html-to-scss](./html-to-scss/SKILL.md)** — генерация структуры SCSS по методологии БЭМ на основе переданной HTML-разметки.
+
+## Установка
+
+Для установки навыков рекомендуется использовать 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. Добавьте информацию о новом навыке в список в `README.md`.