К основному содержанию
скилл CX Codex

oma-bootstrap — скилл для Claude Code: настройка и установка

Скилл oma-bootstrap проверяет, готов ли oma к задаче: CLI, нужные провайдеры и состояние проекта. Запускается перед скиллом или рабочим процессом, которому нужна команда oma.

MIT ★ 1 472 обновлён 2026-11-05

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Открыть на GitHub

Что делает oma-bootstrap

Скилл выясняет, какие этапы настройки нужны исходной задаче: проверяет oma через command -v и oma --version, отдельно проверяет нужные бинарные файлы провайдеров и смотрит состояние .agents/. Если CLI или зависимости отсутствуют, использует установщик OMA и затем проверяет результат. Загрузка сама по себе не считается подтверждением работы инструмента.

Для проекта без .agents/ скилл запускает oma install только при необходимости и с разрешённой настройкой проекта. Существующую установку он сначала диагностирует через oma doctor --json, чтобы не затереть локальные изменения. На Linux и macOS установка CLI может обновить PATH и поставить глобальные инструменты; для Windows используется PowerShell-установщик. Интерактивный запуск отключён, чтобы установка не зависла в headless-среде.

Какие задачи решает

  • найти причину ошибки oma: command not found
  • проверить CLI и нужные бинарные файлы провайдеров
  • подготовить состояние OMA в проекте
  • диагностировать настройку через oma doctor --json

Примеры запросов агенту

  • Подготовь oma и нужные провайдеры для этой задачи.
  • Проверь, почему команда oma не находится, и восстанови CLI.
  • Проверь состояние OMA в проекте и исправь только то, что нужно для этой задачи.

Как установить oma-bootstrap

1Через маркетплейс плагинов

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

Команда ставит плагин oma целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add first-fluke/oh-my-agent --skill oma-bootstrap -a claude-code

3Вручную: положить файлы

~/.claude/skills/oma-bootstrap/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/oma-bootstrap/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об oma-bootstrap

Как установить oma-bootstrap в Claude Code?

Выполните /plugin marketplace add first-fluke/oh-my-agent? Нет. Используйте команды без пробелов внутри кода: /plugin marketplace add first-fluke/oh-my-agent, затем /plugin install oma@oh-my-agent.

Что делает oma-bootstrap?

Проверяет CLI oma, нужные провайдеры и состояние проекта перед задачей, которая зависит от OMA. При настройке существующего проекта сначала запускает диагностику, а не переустанавливает его поверх локальных изменений.

Как oma-bootstrap устанавливает OMA на Windows?

Для native Windows используется PowerShell-установщик с OMA_INSTALL_NO_RUN=1. Linux и macOS используют отдельный bootstrap-скрипт.

Исходный текст

SKILL.md · MIT
---
name: oma-bootstrap
description: Install or verify the oma CLI and its runtimes (bun, uv, serena) before any oma-* skill, agent, or workflow runs an `oma` command. Use when `oma` is missing from PATH, when a skill says to run `oma ...` and the shell reports "command not found", or on the first task in a fresh Cursor or Grok Bot workspace.
---

# OMA bootstrap

## Scheduling

### Goal
Prepare the CLI, required provider tools and project state for the requested
OMA task. Marketplace installation supplies instructions, not runtime binaries.

### Intent signature
- An OMA task reports `oma: command not found` or a missing provider binary.
- A fresh Cursor or Grok Bot workspace lacks required project state.

### When to use
An invoked skill needs an `oma` command, a configured provider, or project OMA
state that is not ready. Check these requirements independently: a working CLI
does not establish that Serena or the project is ready.

### When NOT to use
For instruction-only work that needs no CLI, provider or project state, use the
requested skill directly. Do not provision tools just because the plugin loaded.

### Expected inputs
The invoked skill, its required tools and the task's actual repository or working
directory. Do not use the plugin cache or the Bot's HOME as the project root.

### Expected outputs
Evidence that each required phase is ready, or the specific dependency blocking
the original task. Do not equate a successful download with a working runtime.

### Dependencies
The official platform bootstrap script and `oma doctor --json`. Linux/macOS
commands below apply to hosted Bot computers; native Windows environments use
the PowerShell installer with `OMA_INSTALL_NO_RUN=1`.

## Structural Flow

### Transitions
- CLI available: skip CLI provisioning, then inspect required providers and state.
- Required provider missing: provision that dependency even if the CLI works.
- Project state absent: initialize only when the requested task needs it and
  project setup is authorized. Existing task authorization remains sufficient.
- Existing project: diagnose and reuse it; do not automatically reinstall over
  customized definitions or unrelated work.

### Failure and recovery
| Failure | Recovery |
|---|---|
| Installer succeeds but `oma --version` fails | Inspect `command -v oma` and PATH. Do not create another global install that shadows an existing npm or Homebrew binary. |
| Required Serena binary is still missing | If `uv` is available, run `uv tool install -p 3.13 serena-agent@latest --prerelease=allow` once, then `uv tool update-shell`. Report failure if it remains unavailable. |
| Existing project has configuration or registration issues | Inspect `oma doctor --json`; apply only the indicated repair covered by the task's authorization and preserve local changes. |
| Dependency or setup cannot proceed | Continue independent instruction-only work and report the blocked command. Do not substitute an invented implementation of `oma`. |

### Exit
Resume the original task when its required CLI, provider and project phases are
ready. Keep unresolved phases explicit; plugin import alone does not verify them.

## Logical Operations

### Canonical command path
1. Determine which phases the invoked skill actually requires. In its task
   directory, inspect `command -v oma` and, when present, `oma --version`.
   Check required provider binaries separately and inspect existing `.agents/`
   state. Do not stop after the CLI check.
2. If the CLI or required bootstrap dependencies are missing on Linux/macOS,
   run the official installer without launching its interactive setup:

   ```bash
   curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh \
     | OMA_INSTALL_NO_RUN=1 bash
   export PATH="$PATH:$HOME/.bun/bin:$HOME/.local/bin"
   ```

   Without `curl`, use `wget -qO-`. The installer already installs the global
   CLI when absent and preserves an existing binary; do not follow it with an
   unconditional `bun install --global`. Optional dependencies can fail while
   the installer continues, so verify each required tool after it returns.
   Append the fallback PATH entries to preserve the priority of a working
   Homebrew or npm CLI during a provider-only repair.
3. Recheck `command -v oma && oma --version` and required provider binaries.
   Resolve any missing dependency using the recovery table before invoking it.
4. If project state is needed, inspect the project's existing installation.
   For an absent `.agents/` tree and authorized project setup, run:

   ```bash
   env -u OMA_YES CI=1 oma install
   ```

   CI mode skips prompts without the affirmative side effects of `--yes`, such
   as an automatic GitHub star. Installation writes managed skills, workflows,
   hooks, agents, rules and vendor settings; it does not preserve every existing
   file. For an existing installation, diagnose first instead of rerunning this
   command over local changes.
5. Run `oma doctor --json` when provider or project setup was required. Report
   relevant warnings and complete only the repairs needed for the original task.

### Resource scope and effects
Runtime bootstrap can install global tools and update PATH. Project setup writes
the target repository's OMA definitions and vendor settings and may update
selected providers' HOME configuration. This skill does not authorize publication,
account changes or messages to others.

### Guardrails
- Keep `OMA_INSTALL_NO_RUN=1` in headless bootstrap commands: interactive setup
  reads from `/dev/tty` and can hang.
- Preserve existing installations and local edits. If project setup falls outside
  the authorized task, request that missing authorization without stopping
  independent work.
- Do not install the project into the plugin checkout or the Bot's HOME.

## References
- [Linux/macOS bootstrap](../../../cli/install.sh) (dependency provisioning).
- [Windows bootstrap](../../../cli/install.ps1) (native Windows environments).

© First Fluke · MIT · first-fluke/oh-my-agent

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
bootstrap-v6-install twbs Скилл bootstrap-v6-install для Claude Code и Cursor подключает Bootstrap 6 через CDN или пакетный менеджер. Скрипт настраивает Sass, JavaScript и пути для локальной разработки. CX Codex +1 677установок migrate-bootstrap Microsoft Скилл migrate-bootstrap переводит классический Power Pages сайт с Bootstrap 3 на Bootstrap 5: скачивает, запускает движок pac pages bootstrap-migrate, исправляет оставшиеся изменения иерархии и CSS, загружает обратно. CX Codex +1 ★ 1 167звёзд репо bootstrap-npm twbs Скилл bootstrap-npm для Claude Code и Cursor собирает стартовый проект на Bootstrap 6 через npm и командную строку без бандлера. Запускается при настройке Bootstrap в проекте с npm или компиляции Sass в CSS. CX Codex +1 639установок dspy-bootstrap-fewshot OmidZamani Скилл dspy-bootstrap-fewshot для Claude Code и ещё пяти агентных сред: генерирует few-shot демонстрации для DSPy-программ через teacher-модель. Работает с 10–50 размеченными примерами, когда подбирать демо вручную надоело. CX Codex +1 ★ 125звёзд репо bootstrap Mindrally Задаёт агенту правила работы с Bootstrap: сетка, компоненты, утилиты и валидация форм без собственного CSS. CX Codex +1 1 200установок dx-harness pproenca Скилл dx-harness для Claude Code, Cursor и других IDE, который находит и устраняет трение в dev-loop — медленную подготовку, повторяющиеся ручные шаги, отсутствующие скрипты bootstrap и reset. CX Codex +1 141установок

Из того же набора69

Весь набор →
backend Задаёт стандарты чистой архитектуры backend API с разделением на роутер, сервис и репозиторий. Без логики в контроллерах. CX Codex +1 ★ 1 472звёзд репо market Правило market задаёт порядок исследования рынка через движок last30days: от проверки запроса до сохранения отчёта. Запускается на задачах о трендах, конкурентах и поиске рыночных возможностей. CX Codex +1 ★ 1 472звёзд репо refactor-engineer Субагент refactor-engineer, который переделывает код, сохраняя его функциональность. Помогает упростить сложные участки, подстраховывая каждый шаг тестами. CX Codex ★ 1 472звёзд репо pm-planner Субагент pm-planner роли Product Manager для Claude Code и Codex. Разбирает требования, формирует API-контракты и декомпозирует фичи на параллельные задачи. CX Codex ★ 1 472звёзд репо research-explorer Субагент research-explorer, который ищет ответы сразу в трёх источниках: документация и код, сигналы рынка, академические работы. Собирает выводы с указанием источников и уровня надёжности. CX Codex ★ 1 472звёзд репо database Правило database задаёт стандарты проектирования схем, нормализации, индексации и миграций для SQL, NoSQL и векторных баз. Срабатывает при работе с файлами .sql и .prisma. CX Codex +1 ★ 1 472звёзд репо docs-curator Субагент docs-curator, который следит за дрейфом документации и обновляет MD-файлы, когда код меняется. Ловит неработающие ссылки, предлагает патчи и держит docs/**/*.md в актуальном состоянии. CX Codex ★ 1 472звёзд репо i18n-guide Правило i18n-guide задаёт язык ответов агента и определяет, какие строки переводить, а какие оставлять на английском. Пригодится в проектах с несколькими локалями и агентскими workflow. CX Codex +1 ★ 1 472звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой