# av-dev-skills

Личный маркетплейс плагинов и скилов для разработки — чтобы подключать их к
проектам по мере необходимости, а не держать в глобальном `~/.claude`.

## Подключение

Типичный способ — подключить плагин **на уровне проекта**, чтобы он был активен у
всех, кто открывает репозиторий. Флаг `--scope project` пишет прямо в
`.claude/settings.json` проекта (коммитится в репозиторий) — из интерактивной
сессии Claude Code:

```
/plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git --scope project
/plugin install av-dev-backlog@av-dev-skills --scope project
```

…или те же команды из терминала:

```
claude plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git --scope project
claude plugin install av-dev-backlog@av-dev-skills --scope project
```

Обе формы дописывают в `.claude/settings.json` ровно то, что можно внести и
руками — маркетплейс в `extraKnownMarketplaces`, плагин в `enabledPlugins`:

```json
{
  "extraKnownMarketplaces": {
    "av-dev-skills": {
      "source": {
        "source": "git",
        "url": "https://git.vakhrushev.me/av/dev-skills.git"
      }
    }
  },
  "enabledPlugins": {
    "av-dev-backlog@av-dev-skills": true
  }
}
```

При первом открытии проекта Claude Code попросит доверять воркспейсу; после
подтверждения маркетплейс и включённые плагины подгружаются автоматически. Ключ
включения — `"<плагин>@<маркетплейс>": true`.

Без `--scope project` те же команды пишут в user-конфиг — разовая установка
только себе, настройки проекта не трогаются:

```
/plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git
/plugin install av-dev-backlog@av-dev-skills
```

## Плагины

- **av-dev-backlog** — ведение беклога задач как каталога markdown-файлов (одна
  задача = один файл `<slug>.md` + строка в индексе `README.md`). Скилл
  `backlog`: заведение задачи из диалога, разбор находок аудита/ревью, груминг,
  приоритизация, декомпозиция, штурм идей. Реализацией не занимается. Вызов:
  `/av-dev-backlog:backlog`.
- **av-dev-git** — git-обвязка для личных проектов. Скилл `commit`: сообщения
  коммитов в личном стиле (русский, опциональный scope-префикс, первая строка
  «что сделано», тело 1–3 пункта, без co-authored). Вызов: `/av-dev-git:commit`.

Соглашение об именах: имя **плагина** длинное с префиксом `av-dev-` (уникально в
маркетплейсе), имена **скилов** внутри — короткие. Вызов выходит вида
`/av-dev-<плагин>:<скилл>`.

## Структура

```
.claude-plugin/marketplace.json   — манифест маркетплейса
<plugin>/.claude-plugin/plugin.json — манифест плагина
<plugin>/skills/<skill>/SKILL.md    — скилы плагина (авто-обнаружение)
```