docs(ai-agents): update the llm/skills setup and link the setup prompt

Since llm/skills 1.13.0 `composer require` is the whole setup: the plugin reads the agent directories the project already has, proposes a skills.json and asks one question to confirm it. The previous text described settings under `extra.skills` in composer.json, a surface that is now deprecated.

Assisted-By: Claude Opus 5

Author: roxblnfk

docs/intro/ai-agents.md

@@ -33,20 +33,38 @@ To avoid copying skills by hand from `vendor/testo/testo/skills/` into wherever
 composer require --dev llm/skills
 ```
 
-Once installed, `composer skills:update` copies skills into `.agents/skills/` (the path is configurable via `extra.skills.target` in `composer.json`). Testo is a trusted skill provider, so no extra configuration is needed. To make them visible to a specific agent, add its path to `extra.skills.aliases` — for example, `.claude/skills` for Claude Code:
+That's the whole setup. Composer will ask you to allow the plugin — answer **y**. After that, the plugin looks at the agent directories the project already has (`.claude/`, `.cursor/`, …), builds a configuration from them, and asks a single question to confirm it. Press **Enter** and it writes a `skills.json` at the project root and syncs the skills right away. Commit that file next to `composer.json` so the whole team gets the same setup.
+
+If you'd rather make the choices yourself, or come back to them later, run the wizard:
+
+```bash
+composer skills:init
+```
+
+Either way you end up with something like this:
 
 ```json
 {
-    "extra": {
-        "skills": {
-            "aliases": [".claude/skills", ".cursor/skills"],
-            "auto-sync": true
-        }
-    }
+    "$schema": "https://raw.githubusercontent.com/roxblnfk/skills/master/resources/skills.schema.json",
+    "target": ".agents/skills",
+    "aliases": [".claude/skills", ".cursor/skills"],
+    "auto-sync": true
 }
 ```
 
-At those paths the plugin creates links (Windows junctions or POSIX symlinks) pointing at the main folder — the same set of skills is visible to every agent with no duplicated files.
+Skills land in `target` — one real directory, tool-agnostic by default. Every path in `aliases` becomes a link to it (a junction on Windows, a symlink on POSIX), so each agent sees the same set of skills and no file is duplicated. With `auto-sync` on (the default), the skills are refreshed after every `composer install` and `composer update`; you can also run the sync by hand at any moment:
+
+```bash
+composer skills:update
+```
+
+Testo needs no extra configuration: the `testo/*` vendor is on the plugin's built-in trusted list, and a package you require directly is trusted anyway.
+
+You don't have to do any of this by hand — hand the [Set Up Agent Skills](/docs/ai/prompts/skills.md) prompt to your agent and it installs the plugin, builds a `skills.json` around the agents this project uses, and checks that the skills landed.
+
+::: tip
+The plugin isn't limited to Composer packages. `composer skills:add <vendor>/<repo>` registers a GitHub or GitLab repository as a skill source and fetches it right away — handy for your team's own skill collection.
+:::
 
 ## Typical workflow
 
@@ -58,7 +76,7 @@ The same three steps work for new tests and for porting an existing suite:
 
 ### Example prompts
 
-For ready-made, more elaborate prompts (project initialization, migrating an existing suite with `bridge-rector`, and more), see the [Prompts](/docs/ai/prompts.md) page. The two below are quick, minimal starting points.
+For ready-made, more elaborate prompts (project initialization, migrating an existing suite with `bridge-rector`, and more), see the [Prompts](/docs/intro/prompts.md) page. The two below are quick, minimal starting points.
 
 Writing tests from scratch:
 

ru/docs/intro/ai-agents.md

@@ -29,20 +29,38 @@ AI-агенты хорошо пишут тесты на Testo и так же х
 composer require --dev llm/skills
 ```
 
-После установки `composer skills:update` копирует скиллы в `.agents/skills/` (путь настраивается через `extra.skills.target` в `composer.json`). Testo является доверенным поставщиком скиллов, так что никаких дополнительных настроек не нужно. А чтобы их подхватил конкретный агент, добавьте в `extra.skills.aliases` нужный путь — например, `.claude/skills` для Claude Code:
+Это и есть вся установка. Composer спросит разрешение на запуск плагина — ответьте **y**. Дальше плагин посмотрит, какие папки агентов уже есть в проекте (`.claude/`, `.cursor/` и другие), соберёт по ним конфигурацию и задаст один вопрос — подтвердить её. Нажмите **Enter**, и он запишет в корень проекта файл `skills.json` и сразу синхронизирует скиллы. Закоммитьте этот файл рядом с `composer.json`, чтобы у всей команды была одинаковая настройка.
+
+Если хочется выбрать всё самому или вернуться к настройкам позже, запустите мастер:
+
+```bash
+composer skills:init
+```
+
+Так или иначе, получится примерно такой файл:
 
 ```json
 {
-    "extra": {
-        "skills": {
-            "aliases": [".claude/skills", ".cursor/skills"],
-            "auto-sync": true
-        }
-    }
+    "$schema": "https://raw.githubusercontent.com/roxblnfk/skills/master/resources/skills.schema.json",
+    "target": ".agents/skills",
+    "aliases": [".claude/skills", ".cursor/skills"],
+    "auto-sync": true
 }
 ```
 
-На этих путях плагин создаст ссылки (junction на Windows, symlink на POSIX) на основную папку — один и тот же набор скиллов будет виден всем агентам без дублирования файлов.
+Скиллы попадают в `target` — это единственная настоящая папка, по умолчанию не привязанная к конкретному агенту. На каждый путь из `aliases` плагин создаёт ссылку на неё (junction на Windows, symlink на POSIX), поэтому все агенты видят один и тот же набор скиллов, а файлы не дублируются. Пока включён `auto-sync` (а он включён по умолчанию), скиллы обновляются после каждого `composer install` и `composer update`; синхронизацию можно запустить и вручную в любой момент:
+
+```bash
+composer skills:update
+```
+
+Никаких дополнительных настроек для Testo не требуется: вендор `testo/*` есть во встроенном списке доверенных, да и пакет, который вы подключили сами, доверенный по умолчанию.
+
+Всю настройку можно не делать руками, а поручить агенту: отдайте ему промпт [«Настройка скиллов для агентов»](/ru/docs/ai/prompts/skills.md) — он подключит плагин, соберёт `skills.json` под агентов этого проекта и проверит, что скиллы разложились.
+
+::: tip
+Плагин работает не только с Composer-пакетами. Команда `composer skills:add <vendor>/<repo>` регистрирует репозиторий на GitHub или GitLab как источник скиллов и сразу же его скачивает — удобно для собственной коллекции скиллов вашей команды.
+:::
 
 ## Типичный сценарий
 
@@ -54,7 +72,7 @@ composer require --dev llm/skills
 
 ### Примеры промптов
 
-Готовые промпты для более сложных сценариев (инициализация проекта, миграция существующего набора тестов через `bridge-rector` и другие) собраны на странице [Промпты](/ru/docs/ai/prompts.md). Ниже — два коротких промпта для быстрого старта.
+Готовые промпты для более сложных сценариев (инициализация проекта, миграция существующего набора тестов через `bridge-rector` и другие) собраны на странице [Промпты](/ru/docs/intro/prompts.md). Ниже — два коротких промпта для быстрого старта.
 
 Написание тестов с нуля: