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:
61
README.md
61
README.md
@@ -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).
|
||||
|
||||
Reference in New Issue
Block a user