vitya f0b1db6456 docs(wiki): skill-vs-plugin concept page; flag task-tracking bootstrap gap
- .wiki/concepts/skill-vs-plugin.md: when a bare SKILL.md suffices vs when
  a plugin is required (slash commands, hooks, sub-agents, MCP via
  marketplace). Concrete breakdown of `superpowers` showing why each of
  its non-skill artifacts needs the plugin format.
- .wiki/index.md, log.md: linked / logged.

Backlog: project-bootstrap Step 4 has the same defect as the wiki step
(now fixed in 1cae0a2) — it creates a single flat STATUS.md and never
mentions the per-task files that task-status-wiki actually expects. Added
to .tasks/STATUS.md backlog for a conscious follow-up.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-28 12:48:15 +03:00

claude-skills

Совместное хранилище и мастерская навыков для 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.

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

# 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/source/repo-layout.md.

Description
No description provided
Readme 11 MiB
Languages
Python 45.3%
PowerShell 32.7%
Shell 22%