🗿 Caveman Skill Set

17 agent skills: инженерная дисциплина, охота за фактами, безопасная работа и чистое мышление. One skill set, any harness. Based on the open Agent Skills format.

🇷🇺 Русская версия: этот файл · 🇬🇧 English: README.en.md.

Что это

Каждый скилл — папка skills/<имя>/SKILL.md по открытому стандарту Agent Skills (Anthropic → open standard, agentskills.io). Агент при старте видит только name + description (прогрессивное раскрытие), полный текст грузит, когда задача подходит. Поэтому 17 скиллов занимают в контексте копейки, а пользы — как целая книга.

Скиллы работают в любом skills-совместимом харнесе:

Скиллы — двуязычные: description на русском + строка EN: ... (в metadata languages: ru,en), тело на русском, а его полный английский перевод — в references/EN.md каждого скилла (указатель есть в начале SKILL.md). Поэтому скиллы включаются и русскими словами («бро», «ресёрч», «не работает»), и английскими. Каждый скилл помечен version, история — в RELEASES.md, версия поднимается через ./bump.sh minor.

Быстрый старт

# 1. Клонировать и установить во все харнесы
git clone https://github.com/aidvizhhub/caveman-dvizh-skills.git
cd caveman-dvizh-skills
./install.sh all

# 2. Или только в один харнес
./install.sh opencode      # claude | opencode | codex | gemini | agents

# 3. Проверить, что встало
./install.sh status

# 4. Убрать
./install.sh uninstall all

Однострочно, без клона (сам скачает репо в кэш и установит):

bash <(curl -fsSL https://raw.githubusercontent.com/aidvizhhub/caveman-dvizh-skills/main/install.sh) --remote opencode

Или через CLI-менеджер скиллов npx skills (75+ харнесов, без клона):

npx skills add aidvizhhub/caveman-dvizh-skills --list   # показать 17 скиллов
npx skills add aidvizhhub/caveman-dvizh-skills -g -a claude-code -y

После установки просто скажи агенту «пользуйся скиллом caveman-loop» или опиши задачу словами из триггеров — скилл сам подхватится.

Совместимость: тул кауфми (camoufox-research)

Скиллы caveman-research и caveman-diagnose обращаются к «кауфми» — нашему MCP-серверу разведки camoufox-research (48 тулов: веб-поиск, чтение страниц, батчи, скриншоты). Это внешний тул, в набор скиллов он НЕ входит. Без него агент честно скажет «кауфми лёг» — это значит «нет подключённого инструмента», а не беда:

# Установка кауфми (один раз, нужен python3)
git clone https://github.com/aidvizhhub/camoufox-research.git && cd camoufox-research
python3 -m venv ~/.venvs/camoufox-research
~/.venvs/camoufox-research/bin/pip install .
~/.venvs/camoufox-research/bin/python -m camoufox fetch   # скачать браузер (один раз)

# Проверка подключения: opencode mcp list → camoufox: connected

Остальные 15 скиллов работают без кауфми — им нужен только шелл.

Каталог скиллов

Примеры использования

«бро, у меня завис процесс и не убивается»        → включается caveman-kill
«разберись, почему ffmpeg падает на этом файле»   → caveman-diagnose + caveman-desktop
«предложи, куда дальше по проекту»                → caveman-advise
«сделай задачу по-канону»                          → caveman-loop (весь ритуал)

Свой скилл за 5 минут

1. Создай папку skills/my-skill/ с файлом SKILL.md.
2. Frontmatter: name (совпадает с папкой, [a-z0-9]+(-[a-z0-9]+)*), description (что делает + когда использовать, до 1024 символов), license.
3. Тело — пошаговые инструкции, примеры, грабли. Держи до 500 строк, детали — в references/.
4. Запусти ./validate.sh — проверка по стандарту.
5. Полный стандарт: agentskills.io/specification.

Релизы

История версий — в RELEASES.md (формат Keep a Changelog, версии SemVer). Версия каждого скилла — в его metadata (version). Поднять версию и записать релиз одним вызовом:

./bump.sh minor -m "что нового"   # major | minor | patch, по умолчанию patch

Проверка и CI

• ./validate.sh — локальная проверка всех скиллов: строгий YAML frontmatter, имя=папка, длина description, EN-перевод, паритет RU/EN (заголовки и код-блоки должны совпадать 1:1), сверка индекса SKILLS.yaml с frontmatter, отсутствие трейсов конкретной машины.
• tests/golden_triggers.py — золотые тесты триггеров (вызываются из validate.sh): у каждого скилла есть непустой список триггеров, каждый триггер существует в тексте скилла, нет дублей; двусмысленности («один триггер на два скилла») и ложные вызовы — предупреждения.
• SKILLS.yaml — машиночитаемый индекс всех скиллов (name/version/path/description/languages) для CLI и маркетплейсов; пересобирается через ./update-index.sh (и сам после bump.sh), расхождение ловит validate.sh.
• .github/workflows/ci.yml — на каждый push: валидация → тест установки (чистый контейнер: 17 скиллов встают и убираются) → gitleaks.

Вклад

Камень растёт вместе с племенем. Правила простые:

• Правила вклада — CONTRIBUTING.md: один скилл = одно дело, триггеры в описании, RU+EN зеркало, тест до отправки.
• Кодекс поведения — CODE_OF_CONDUCT.md.
• Нашёл уязвимость? — SECURITY.md, по-тихому, через приватный отчёт.
• Обращения и пул-реквесты — по шаблонам в .github/ (заполняются сами).

Лицензия

MIT © 2026 aidvizhhub. Вольный камень — бери и встраивай.