# claude-skills

> English version: [README.md](README.md).

Совместное хранилище и мастерская навыков для Claude.

## About

Здесь мы с Claude вместе разрабатываем, отлаживаем и храним скиллы:

- **`skills/`** — редактируемые исходники (markdown + ассеты), source of truth
- **`dist/`** — собранные `.skill` архивы, закоммичены в репо
- **`scripts/`** — утилиты: `build.sh` (исходник → `.skill`), `install.sh` (исходник → `~/.claude/skills/`)
- **`.wiki/`**, **`.tasks/`** — рабочие материалы и доска задач

## Quick start

### Установить скиллы на новом компе

```bash
git clone <repo> claude-skills
cd claude-skills
bash scripts/install.sh           # копирует все skills/* в ~/.claude/skills/
# или конкретные:
bash scripts/install.sh caveman wiki-maintainer
```

Цель установки можно переопределить переменной `CLAUDE_SKILLS_DIR=/path bash scripts/install.sh`.

### Использование в проектах

Когда скиллы установлены, проще всего раскатить их на новый (или
существующий) проект через скилл [`project-bootstrap`](skills/project-bootstrap/).
Скажи агенту **«bootstrap»** или **«настрой проект»** в папке проекта — он
за один проход:

- инициализирует `git` (если ещё нет) и положит вменяемый `.gitignore`
- создаст стартовый `README.md`
- развернёт `.wiki/` по [паттерну Karpathy LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) (делегируется в [`setup-wiki`](skills/setup-wiki/))
- развернёт `.tasks/` с канонической доской задач (делегируется в [`setup-tasks`](skills/setup-tasks/))
- запишет `CLAUDE.md` со скилл-триггерами (`use superpowers`, `use project wiki`, `use task management system`, `check across all projects`, `we're on Windows`)
- зафиксирует версии использованных скиллов в `.wiki/concepts/bootstrap-manifest.md`, чтобы дрифт раскладки между проектами оставался отлаживаемым
- проверит, установлен ли официальный плагин `superpowers@claude-plugins-official`, и если нет — выведет команду установки (без плагина триггер `use superpowers` мёртвый)

Два режима, выбирается автоматически: **init** для пустой папки и **upgrade**
для существующего проекта (скилл только дозаполняет пробелы и ничего не
перезаписывает без явного подтверждения). В режиме upgrade `CLAUDE.md`
сливается идемпотентно — только канонические триггер-строки, которых ещё
нет в файле, дописываются после явного подтверждения, поэтому повторный
запуск `project-bootstrap` после обновления шаблона подтягивает новые
триггеры, не дублируя старые.

### Отредактировать скилл

```bash
# 1. Правишь skills/<name>/SKILL.md (или ассеты)
# 2. Раскатываешь правки в живые скиллы:
bash scripts/install.sh <name>
# 3. Пересобираешь архив (опц., но удобно делать перед коммитом):
bash scripts/build.sh <name>
```

### Собрать `.skill` архивы

```bash
bash scripts/build.sh                 # все
bash scripts/build.sh caveman          # один
```

`build.sh` использует `zip` если он есть (Linux/macOS) или делегирует в
`scripts/build.ps1` через PowerShell (Windows без `zip`). На Windows
можно сразу запускать `powershell scripts/build.ps1`.

## Layout

```
claude-skills/
├── skills/                 ← исходники (по папке на скилл)
├── dist/                   ← .skill архивы (коммитятся)
├── scripts/
│   ├── build.sh / build.ps1
│   └── install.sh
├── .wiki/                  ← дизайн-доки, заметки
├── .tasks/                 ← STATUS.md
├── CLAUDE.md
└── README.md
```

Подробнее про принципы и решения — в [`.wiki/concepts/repo-layout.md`](.wiki/concepts/repo-layout.md).