feat: migrate 12 personal skills + add build/install scripts

- skills/: editable sources for all 12 personal skills (caveman family,
  find-skills, project-bootstrap, task-status-wiki, using-context7,
  using-markitdown, wiki-maintainer, compress)
- dist/: built .skill archives, committed (cross-machine deploy without
  needing zip on the target)
- scripts/build.sh + build.ps1: zip skills/<name>/ into dist/<name>.skill;
  Windows fallback uses .NET ZipArchive (PS 5.1 Compress-Archive writes
  backslashes that break extraction on *nix)
- scripts/install.sh: copy skills/<name>/ into ~/.claude/skills/<name>/
  ($CLAUDE_SKILLS_DIR overrides target)
- .wiki/source/repo-layout.md, build-notes.md: design + gotchas
- .gitignore: keep dist/ tracked

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-28 10:42:33 +03:00
parent 782a00d6b8
commit 9f54068de0
51 changed files with 3243 additions and 6 deletions

View File

@@ -1,7 +1,64 @@
# claude-skills
Совместное хранилище и мастерская навыков для Claude.
## About
<!-- Describe the project here -->
Здесь мы с Claude вместе разрабатываем, отлаживаем и храним скиллы:
- **`skills/`** — редактируемые исходники (markdown + ассеты), source of truth
- **`dist/`** — собранные `.skill` архивы, закоммичены в репо
- **`scripts/`** — утилиты: `build.sh` (исходник → `.skill`), `install.sh` (исходник → `~/.claude/skills/`)
- **`.wiki/`**, **`.tasks/`** — рабочие материалы и доска задач
## Quick start
<!-- Instructions for running the project -->
### Установить скиллы на новом компе
```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/source/repo-layout.md`](.wiki/source/repo-layout.md).