Agent skill

oma Bootstrap

by first-fluke in first-fluke/oh-my-agent

Installs or checks the oma CLI and its runtimes (bun, uv, serena) in a fresh workspace so that oma-* skills can run their commands.

MITAuto-check passedAgent Workflows

Install oma Bootstrap

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install first-fluke/oh-my-agent oma-bootstrap --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/first-fluke/oh-my-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor-plugin/skills/oma-bootstrap .claude/skills/oma-bootstrap && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
oma-bootstrap
GitHub stars
1.3k
Token cost
~719 tokens
SKILL.md length
338 words
Files
1
Skills in repo
57
Repo updated
First seen
Licence
MIT

At a glance

Installs or checks the oma CLI and its runtimes (bun, uv, serena) in a fresh workspace so that oma-* skills can run their commands.

  • Works in 5 steps: Check: command -v oma && oma --version.… → Provision the runtimes with the official… → Install the CLI as a persistent global… → …
  • A skill tells the agent to run an oma command and the shell says oma: command not found
  • SKILL.md covers When to run, Steps and Rules
  • Calls uv, curl and bash

What it does

Marketplace installs of the oma skills ship only the instruction text, not the binaries, so a new workspace may report that `oma` or `serena` cannot be found. This skill covers that gap. The agent checks `command -v oma` and `oma --version`, and stops if both work. Otherwise it runs the project's installer in non-interactive mode with `OMA_INSTALL_NO_RUN=1`, which adds bun, uv, serena-agent and cue when they are missing, then installs the CLI globally with `bun install --global oh-my-agent`.

It then runs `oma install --yes` to create a `.agents/` folder with the default preset, leaving existing files alone, and finishes with `oma doctor` to confirm serena is on the path and the project is registered. The agent should ask before wiring a repository that is not yours or where `.agents/` has local changes, should never reimplement an oma command by hand, and must not run the installer headless without that variable because its setup waits on the terminal.

When your agent uses it

  • A skill tells the agent to run an oma command and the shell says oma: command not found
  • The first task in a fresh Cursor workspace needs the oma tooling
  • A skill needs `.agents/` project state and the folder does not exist yet

Example prompts

  • “oma: command not found came up when the skill ran oma doctor, please set it up.”
  • “Bootstrap oma in this new workspace and verify it with oma doctor.”
  • “Check whether serena and bun are installed for the oma skills before we start.”

Requirements

  • Network access to download the installer from GitHub
  • `curl` or `wget`
  • Permission to install bun, uv and serena-agent on the machine

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Check: command -v oma && oma --version. If both succeed, stop here.
  2. Provision the runtimes with the official installer in non-interactive
  3. Install the CLI as a persistent global binary (skills call bare oma)
  4. Wire the project non-interactively. This creates .agents/ with the
  5. Verify: oma doctor. It reports whether serena is on PATH and whether

What it can do on your machine

Read from SKILL.md and the folder at commit 0e87272. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • curl
    • bash
    • bun
    • wget

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, curl and wget, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

oma Bootstrap loads about 719 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 338 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~719

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from first-fluke/oh-my-agent at commit 0e87272, republished under its MIT licence (© first-fluke). 338 words, ~719 tokens.

Download SKILL.mdSave it as .claude/skills/oma-bootstrap/SKILL.md (or your agent's skills folder).
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

The oma-* skills in this plugin describe what to do. Several of them delegate the mechanics to the oma CLI (oma agent spawn, oma market run, oma recap, oma hook run, oma doctor), and code search expects the Serena MCP binary. Marketplace installs ship the skill text, not the binaries, so a fresh workspace may have neither.

When to run

  • A skill instruction contains an oma ... command and command -v oma is empty.
  • The shell reports oma: command not found or serena: command not found.
  • The workspace has no .agents/ directory and a skill needs project state (.agents/state/, .agents/results/, oma-config.yaml).

Skip this skill when oma --version already prints a version.

Steps

Run from the repository root. Every step is idempotent; rerunning is safe.

  1. Check: command -v oma && oma --version. If both succeed, stop here.

  2. Provision the runtimes with the official installer in non-interactive mode. It installs bun, uv, serena-agent, and cue when missing, and OMA_INSTALL_NO_RUN=1 skips the interactive setup it would otherwise launch at the end:

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

    Without curl, use wget -qO- in its place. Each dependency is best-effort: the installer warns and continues when one fails.

  3. Install the CLI as a persistent global binary (skills call bare oma):

    bash
    bun install --global oh-my-agent
  4. Wire the project non-interactively. This creates .agents/ with the default preset and leaves existing files untouched:

    bash
    oma install --yes
  5. Verify: oma doctor. It reports whether serena is on PATH and whether the project is registered. Report any warning before continuing with the original task.

Show full SKILL.md (92 more words)Show less

Rules

  • Ask before oma install --yes when the repository is not yours or when .agents/ already exists with local changes.
  • Do not fall back to re-implementing an oma command by hand. If the CLI cannot be installed, say so and complete only the parts of the task that do not need it.
  • Do not run the installer without OMA_INSTALL_NO_RUN=1 in a headless Bot: the interactive setup reads from /dev/tty and hangs.
  • If serena is still missing after step 2, run uv tool install -p 3.13 serena-agent@latest --prerelease=allow once, then uv tool update-shell.

© first-fluke, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .cursor-plugin/skills/oma-bootstrap of first-fluke/oh-my-agent.

Open the folder on GitHubat commit 0e87272

Compare with similar skills

oma Bootstrap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

oma Bootstrap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
oma Bootstrap this skillfirst-fluke/oh-my-agent1.3k—~719Automated safety check: PassMIT
Skillsharerunkids/skillshare2.7k—~2.2kAutomated safety check: PassMIT
PicoClaw Agentsipeed/picoclaw30k—~7.2kAutomated safety check: NotesMIT
AgentSkillsHub Skill Finderzhuyansen/agent-skills-hub407—~1kAutomated safety check: PassMIT
Sandboxed.sh Library ManagementTh0rgal/sandboxed.sh515—~931Automated safety check: PassNone
UModel Skill Runneralibaba/UnifiedModel412—~1kAutomated safety check: PassCustom licence

Similar skills

  • Skillshare

    runkids/skillshare

    Manage skills, agents, extras, hooks, plugins, and MCP connection settings with the Skillshare CLI.

    2.7k GitHub stars~2.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • PicoClaw Agent

    sipeed/picoclaw

    Answers questions about running and changing PicoClaw, from onboarding and model selection to MCP server setup, skill loading and scheduled jobs.

    30k GitHub stars~7.2k tokensUpdated 12 days ago
    Agent WorkflowsAuto-check: notes
  • AgentSkillsHub Skill Finder

    zhuyansen/agent-skills-hub

    Searches a locally cached, security-graded catalog of agent skills and MCP servers, and returns install commands after checking each one's grade.

    407 GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Reads and updates the Sandboxed.sh Library, a git-backed store of skills, agents, commands, tools, rules and MCP servers, through its library tools.

    515 GitHub stars~931 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • UModel Skill Runner

    alibaba/UnifiedModel

    Loads one entity-linked Skill through UModel, follows its inline SKILL.md and applies attached knowledge items under their apply policies.

    412 GitHub stars~1k tokensUpdated 13 days ago
    Agent WorkflowsAuto-check passed
  • Mistral Vibe CLI Reference

    mistralai/mistral-vibe

    Official

    Reference for Mistral Vibe, the CLI agent it runs inside: config files, env vars, agents, skills, tools, hooks and MCP servers, so the agent can explain and troubleshoot its own setup.

    5.1k GitHub stars~14k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

More from first-fluke/oh-my-agent

All 57 skills in this repo
  • OMA Multi-Agent Orchestration

    first-fluke/oh-my-agent

    Decomposes a complex feature into tasks, dispatches parallel specialist agents with durable state, and supervises verification, QA review and retries.

    1.3k GitHub stars~4.1k tokensUpdated yesterday
    Auto-check passed
  • OMA Multi-Agent Orchestrator

    first-fluke/oh-my-agent

    Splits a complex feature into prioritized tasks, spawns specialist CLI subagents in parallel, tracks them through shared memory and verifies each result.

    1.3k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Architecture Decisions and ADRs

    first-fluke/oh-my-agent

    Evaluates system boundaries and tradeoffs and writes architecture recommendations, option comparisons or ADRs, with a Mermaid diagram when structure changes.

    1.3k GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • OMA Backend Agent

    first-fluke/oh-my-agent

    Backend specialist for APIs, database work, authentication and migrations that follows clean architecture with router, service and repository layers.

    1.3k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Design-First Brainstorm

    first-fluke/oh-my-agent

    Explores intent, constraints and alternative approaches before any planning, working through questions one at a time and saving an approved design for later steps.

    1.3k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • OMA Brainstorm

    first-fluke/oh-my-agent

    Explores goals, constraints and alternative designs one question at a time and saves an approved design document before any planning or coding starts.

    1.3k GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about oma Bootstrap

What does oma Bootstrap do?

Installs or checks the oma CLI and its runtimes (bun, uv, serena) in a fresh workspace so that oma-* skills can run their commands. Marketplace installs of the oma skills ship only the instruction text, not the binaries, so a new workspace may report that `oma` or `serena` cannot be found. This skill covers that gap.

When should I use oma Bootstrap?

oma Bootstrap fits situations like: A skill tells the agent to run an oma command and the shell says oma: command not found; the first task in a fresh Cursor workspace needs the oma tooling; A skill needs `.agents/` project state and the folder does not exist yet.

How do I install oma Bootstrap in Claude Code?

Run `npx skills add first-fluke/oh-my-agent --skill oma-bootstrap -a claude-code`. Or copy the skill folder (.cursor-plugin/skills/oma-bootstrap in first-fluke/oh-my-agent) into .claude/skills/oma-bootstrap in your project. Claude Code loads it when a task matches its description.

How do I install oma Bootstrap in Codex?

Run `npx skills add first-fluke/oh-my-agent --skill oma-bootstrap -a codex`. Or copy the skill folder (.cursor-plugin/skills/oma-bootstrap in first-fluke/oh-my-agent) into .agents/skills/oma-bootstrap in your project. Codex loads it when a task matches its description.

Can I use oma Bootstrap in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add first-fluke/oh-my-agent --skill oma-bootstrap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/oma-bootstrap, .gemini/skills/oma-bootstrap, .github/skills/oma-bootstrap and .opencode/skills/oma-bootstrap in your project.

What does oma Bootstrap need to run?

Going by SKILL.md and its folder, oma Bootstrap needs the command-line tools its instructions call (uv, curl, bash, bun and wget). Our summary lists: Network access to download the installer from GitHub; `curl` or `wget`; Permission to install bun, uv and serena-agent on the machine.

Does oma Bootstrap access the network?

SKILL.md contains no URLs. Its commands use uv, curl and wget, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is oma Bootstrap safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does oma Bootstrap use?

oma Bootstrap is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does oma Bootstrap use?

About 719 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to oma Bootstrap?

Skills that share tags, products or a category with oma Bootstrap: Skillshare (runkids/skillshare, 2.7k stars), PicoClaw Agent (sipeed/picoclaw, 30k stars), AgentSkillsHub Skill Finder (zhuyansen/agent-skills-hub, 407 stars) and Sandboxed.sh Library Management (Th0rgal/sandboxed.sh, 515 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains oma Bootstrap?

first-fluke (a GitHub organization) maintains it in first-fluke/oh-my-agent, which has 1,335 GitHub stars. The repository holds 57 skills in this directory. The repository was last updated on October 6, 2026.

Source: first-fluke/oh-my-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.