feat(skills): переработать AI-скиллы

- добавлены синхронные английские и русские инструкции для агентов
- расширена сборка документов из Markdown-фрагментов
- артефакты перенесены в игнорируемый release output
- обновлены README и проверки скиллов

skills/README.md

@@ -1,12 +1,48 @@
 # AI skills
 
-Исходники скилов `svg-sprites` и `svg-sprites-ru` находятся в `skills/svg-sprites/`. Готовые самодостаточные артефакты записываются в `skills/artifacts/svg-sprites/` и `skills/artifacts/svg-sprites-ru/` и коммитятся в Git.
+Исходники английского и русского скиллов находятся в `skills/svg-sprites/src/{en,ru}/`. Готовые переносимые артефакты генерируются в `skills/artifacts/`, игнорируются Git и упаковываются в ZIP во время release workflow.
 
-Основные `README.md`, `README_RU.md` и файлы `docs/{en,ru}/*.md` являются источником истины. Сборка копирует их в `references/` готового скила, поэтому вручную редактировать файлы внутри `skills/artifacts/` нельзя.
+Обе языковые версии имеют одинаковую структуру:
+
+```text
+src/<language>/
+├── SKILL.md
+├── core/
+│   ├── 00-package-overview.md
+│   ├── 10-mode-selection.md
+│   ├── 20-project-inspection.md
+│   ├── 30-react-next-setup.md
+│   ├── 40-generated-contract.md
+│   ├── 50-usage-and-colors.md
+│   ├── 60-verification.md
+│   └── 70-diagnostics.md
+└── references/
+    ├── react-vite.md
+    ├── react-webpack.md
+    ├── next-app.md
+    ├── next-pages.md
+    ├── legacy.md
+    ├── migration-1.md
+    ├── programmatic-api.md
+    └── complex-svg.md
+```
+
+`core/` содержит обязательные знания, раскрываемые прямо в итоговый `SKILL.md`. `references/` содержит самостоятельные инструкции для агента по конкретным стекам и редким сценариям. Пользовательские `README*.md` и `docs/{en,ru}/*.md` дополнительно копируются в `references/upstream/` как вторичный источник полного публичного API.
+
+## Композиция Markdown
+
+В любой собираемый документ можно включать фрагменты:
+
+```md
+<!-- include: ./core/10-mode-selection.md -->
+```
+
+Include раскрываются рекурсивно, путь считается относительно включающего файла. Циклы, отсутствующие файлы, выход за `skills/svg-sprites/`, frontmatter во фрагментах и нераскрытые include завершают сборку ошибкой. Заголовки не сдвигаются автоматически: entry содержит единственный `# H1`, inline-фрагменты начинаются с `##`.
+
+## Локальная сборка
 
 ```bash
 npm run build:skill
-npm run check:skill
 ```
 
-`build:skill` обновляет оба артефакта, а `check:skill` без изменения файлов проверяет их содержимое и синхронность с документацией. Версия без суффикса использует английский язык, версия с суффиксом `-ru` — русский.
+Команда собирает и валидирует обе языковые версии, затем записывает их в игнорируемый каталог `skills/artifacts/`. Сборщик проверяет точный список файлов, безопасные пути, symlink, Markdown fences, локальные ссылки и anchors, единственный H1, frontmatter, размер основного документа и отсутствие `TODO`.