skills/README.ru.md

claude-skills

English version: README.md.

Совместное хранилище и мастерская навыков для Claude.

About

Здесь мы с Claude вместе разрабатываем, отлаживаем и храним скиллы:

• skills/ — редактируемые исходники (markdown + ассеты), source of truth
• dist/ — собранные .skill архивы, закоммичены в репо
• scripts/ — утилиты: build.sh (исходник → .skill), install.sh (исходник → ~/.claude/skills/)
• .wiki/, .tasks/ — рабочие материалы и доска задач

Quick start

Установить скиллы на новом компе

git clone <repo> claude-skills
cd claude-skills
bash scripts/install.sh           # копирует все skills/* в ~/.claude/skills/
# или конкретные:
bash scripts/install.sh using-wiki caveman

Цель установки можно переопределить переменной CLAUDE_SKILLS_DIR=/path bash scripts/install.sh.

Использование в проектах

Когда скиллы установлены, проще всего раскатить их на новый (или существующий) проект через скилл project-bootstrap. Скажи агенту «bootstrap» или «настрой проект» в папке проекта — он за один проход:

• инициализирует git (если ещё нет) и положит вменяемый .gitignore
• создаст стартовый README.md
• развернёт .wiki/ по паттерну Karpathy LLM Wiki (делегируется в setup-wiki)
• развернёт .tasks/ с канонической доской задач (делегируется в setup-tasks)
• запишет CLAUDE.md со скилл-триггерами (use project wiki, use task management system, check across all projects, we're on Windows)
• зафиксирует версии использованных скиллов в .wiki/concepts/bootstrap-manifest.md, чтобы дрифт раскладки между проектами оставался отлаживаемым

Два режима, выбирается автоматически: init для пустой папки и upgrade для существующего проекта (скилл только дозаполняет пробелы и ничего не перезаписывает без явного подтверждения). В режиме upgrade CLAUDE.md сливается идемпотентно — только канонические триггер-строки, которых ещё нет в файле, дописываются после явного подтверждения, поэтому повторный запуск project-bootstrap после обновления шаблона подтягивает новые триггеры, не дублируя старые.

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

# 1. Правишь skills/<name>/SKILL.md (или ассеты)
# 2. Раскатываешь правки в живые скиллы:
bash scripts/install.sh <name>
# 3. Пересобираешь архив (опц., но удобно делать перед коммитом):
bash scripts/build.sh <name>

Собрать .skill архивы

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

Суверенитет / провенанс

Каталог суверенный: каждый скилл либо нашего авторства, либо адаптированная вендорская копия, которую поддерживаем сами. Никаких сырых вендорских плагинов как зависимостей — всё заимствованное вендорится в этот репо с явным маркером adapted-from во frontmatter.

скилл	провенанс
caveman, caveman-commit, caveman-compress, caveman-help, caveman-review	adapted-from: JuliusBrussee/caveman (MIT) — вендорная копия, пин апстрима TBD
find-skills	adapted-from: vercel-labs/skills (MIT) — вендорная копия, пин апстрима TBD
grilling	adapted-from: mattpocock/skills @ 84fdeffd (MIT) — семейство схлопнуто в один скил (pi прячет disable-model-invocation обёртки)
brainstorming	adapted-from: obra/superpowers @ 6.2.0 (MIT) — расходящаяся фаза, visual-companion выброшен
остальные skills/*	author: ours

Политика адаптации: клон переписывается под наши конвенции (доски .tasks/, спеки .wiki/concepts/, имена скиллов using-*), вендорский мусор не перетягивается, версионируется под нашим semver. Пины апстрима пересматривает владелец каталога при обновлении; автосинка нет.

skills/
├── skills/                 ← исходники (по папке на скилл)
├── dist/                   ← .skill архивы (коммитятся)
├── scripts/
│   ├── build.sh / build.ps1
│   └── install.sh
├── .wiki/                  ← дизайн-доки, заметки
├── .tasks/                 ← STATUS.md
├── CLAUDE.md
└── README.md

Подробнее про принципы и решения — в .wiki/concepts/repo-layout.md.