Files

vitya 2b2dea897b docs(readme): document project-bootstrap usage

Both README.md and README.ru.md gain a new "Using skills in projects"
/ "Использование в проектах" subsection right after the install
quick-start. Briefly describes what `project-bootstrap` lays down
(git, .gitignore, README, .wiki/, .tasks/, CLAUDE.md, manifest,
superpowers-plugin check) and the init/upgrade dual mode.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-28 20:51:02 +03:00

4.4 KiB

Raw Blame History

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 caveman wiki-maintainer

Цель установки можно переопределить переменной 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 superpowers, use project wiki, use task management system, we're on Windows)
зафиксирует версии использованных скиллов в .wiki/concepts/bootstrap-manifest.md, чтобы дрифт раскладки между проектами оставался отлаживаемым
проверит, установлен ли официальный плагин superpowers@claude-plugins-official, и если нет — выведет команду установки (без плагина триггер use superpowers мёртвый)

Два режима, выбирается автоматически: init для пустой папки и upgrade для существующего проекта (скилл только дозаполняет пробелы и ничего не перезаписывает без явного подтверждения).

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

# 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

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

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

4.4 KiB Raw Blame History Unescape Escape