# claude-skills

> Russian version: [README.ru.md](README.ru.md).

Joint workshop and storage for Claude skills.

## About

A shared workspace where Claude and I author, debug, and ship skills together:

- **`skills/`** — editable sources (markdown + assets), the source of truth
- **`dist/`** — built `.skill` archives, committed to the repo
- **`scripts/`** — utilities: `build.sh` (source → `.skill`), `install.sh` (source → `~/.claude/skills/`)
- **`.wiki/`**, **`.tasks/`** — working notes and the task board

## Quick start

### Install skills on a fresh machine

**Windows (PowerShell):**

```powershell
git clone <repo> claude-skills
cd claude-skills
bash scripts/install.sh           # copies every skills/* into ~/.claude/skills/
# or only specific ones:
bash scripts/install.sh caveman wiki-maintainer
```

**Linux / macOS (bash):**

```bash
git clone <repo> claude-skills
cd claude-skills
bash scripts/install.sh           # copies every skills/* into ~/.claude/skills/
# or only specific ones:
bash scripts/install.sh caveman wiki-maintainer
```

The install target can be overridden with `CLAUDE_SKILLS_DIR=/path bash scripts/install.sh`.

> `install.sh` works on Windows under git-bash. A native `install.ps1` is on the task board but not yet implemented.

### Edit a skill

```bash
# 1. Edit skills/<name>/SKILL.md (or its assets).
# 2. Push the changes into the live skill folder:
bash scripts/install.sh <name>
# 3. Rebuild the archive (optional, but handy before a commit):
bash scripts/build.sh <name>
```

### Build `.skill` archives

```bash
bash scripts/build.sh                 # all skills
bash scripts/build.sh caveman         # one skill
```

`build.sh` uses `zip` when it's available (Linux/macOS) or delegates to
`scripts/build.ps1` via PowerShell (Windows without `zip`). On Windows you
can also run `powershell scripts/build.ps1` directly.

## Layout

```
claude-skills/
├── skills/                 ← sources (one folder per skill)
├── dist/                   ← .skill archives (committed)
├── scripts/
│   ├── build.sh / build.ps1
│   └── install.sh
├── .wiki/                  ← design docs, notes
├── .tasks/                 ← STATUS.md
├── CLAUDE.md
└── README.md               (this file — see README.ru.md for Russian)
```

For the principles and decisions behind this layout see
[`.wiki/concepts/repo-layout.md`](.wiki/concepts/repo-layout.md).