vitya
9f54068de0
- 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>
65 lines
2.4 KiB
Markdown
65 lines
2.4 KiB
Markdown
# claude-skills
|
||
|
||
Совместное хранилище и мастерская навыков для 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/source/repo-layout.md`](.wiki/source/repo-layout.md).
|