# 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`.

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

```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).