Agent skill

Bernstein Run

by sipyourdrink-ltd in sipyourdrink-ltd/bernstein

Run a verified multi-agent goal with Bernstein. An agent skill from sipyourdrink-ltd/bernstein.

Apache-2.0Auto-check passedAgent Workflows

Install Bernstein Run

skills CLI
$ npx skills add sipyourdrink-ltd/bernstein --skill bernstein-run -a claude-code

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

GitHub CLI
$ gh skill install sipyourdrink-ltd/bernstein bernstein-run --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/sipyourdrink-ltd/bernstein.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bernstein-run .claude/skills/bernstein-run && 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
bernstein-run
GitHub stars
1.2k
Token cost
~722 tokens
SKILL.md length
318 words
Files
2 (incl. references)
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

Run a verified multi-agent goal with Bernstein. An agent skill from sipyourdrink-ltd/bernstein.

  • Works in 3 steps: Submit → Monitor → Verify
  • A task is too large for a single agent session: Bernstein decomposes the goal into tasks
  • SKILL.md covers Prerequisites, Workflow, Verifying this skill's own… and Notes
  • Calls pip and uv

What it does

Bernstein Run is an agent skill from sipyourdrink-ltd/bernstein. Run a verified multi-agent goal with Bernstein. Use when a task is too large for a single agent session: Bernstein decomposes the goal into tasks, spawns CLI coding agents in parallel git worktrees, verifies their output, and merges results. Also use to check run status, costs, and to verify a finished run against its lineage and audit chain.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/worked-examples.md`).

It sits in Agent Workflows, covering Git worktrees and Multi-agent orchestration. The repository describes itself as: The open‑source AI Agents Governance & Orchestration framework: write the rules declaratively, Bernstein enforces them and produces the verifiable, replayable record. Free…. The licence is Apache-2.0.

When your agent uses it

  • A task is too large for a single agent session: Bernstein decomposes the goal into tasks
  • Spawns CLI coding agents in parallel git worktrees
  • Verifies their output
  • Check run status

Example prompts

  • “/bernstein-run”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Submit
  2. Monitor
  3. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit cc0c7fc. 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:

    • pip
    • uv

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

  • Network

    No URLs in SKILL.md. Its commands use pip and uv, 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

Bernstein Run loads about 722 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 90 tokens; SKILL.md has 318 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~90
When it runs · the whole SKILL.md, loaded when a task matches
~722
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

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 sipyourdrink-ltd/bernstein at commit cc0c7fc, republished under its Apache-2.0 licence (© sipyourdrink-ltd). 318 words, ~722 tokens.

Download SKILL.mdSave it as .claude/skills/bernstein-run/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
bernstein-run
description
Run a verified multi-agent goal with Bernstein. Use when a task is too large for a single agent session: Bernstein decomposes the goal into tasks, spawns CLI coding agents in parallel git worktrees, verifies their output, and merges results. Also use to check run status, costs, and to verify a finished run against its lineage and audit chain.

Run a verified multi-agent goal

Bernstein is the open-source governance layer for AI agents, with a deterministic multi-agent scheduler. This skill wraps the three-step operator loop: submit a goal, monitor progress, and verify the finished run against its Merkle-chained lineage journal and HMAC audit chain.

Prerequisites

  • bernstein on PATH (pip install bernstein or uv tool install bernstein).
  • Run commands from the project root (the directory holding .sdd/ after the first run).
  • First-time setup: bernstein init scaffolds config and templates.

Workflow

1. Submit
bash
bernstein run -g "<goal>"
  • The goal is a plain-English description of what to build or fix.
  • Bernstein plans tasks, assigns roles (backend, frontend, qa, security, devops), and spawns agents in isolated git worktrees.
  • Preview without spending: bernstein run --dry-run -g "<goal>".
2. Monitor
bash
bernstein status
bernstein cost
  • status shows task summary and agent health.
  • cost shows the spend so far against configured budgets.
3. Verify
bash
bernstein lineage verify <run_id>
bernstein audit verify
  • lineage verify recomputes the run's Merkle hash chain and every HMAC tag; exit 0 means the chain is intact and non-empty.
  • audit verify checks the HMAC audit chain and Merkle tree across the whole workspace; run it before trusting or shipping the result.

Report the run as complete only when both verifications exit 0.

Verifying this skill's own install

Installs of this skill are receipt-backed. To confirm bernstein is on PATH and the bundled skill asset resolves in this session:

bash
bernstein skills package show

To prove the skill content the session is driving matches what was installed:

bash
bernstein skills package verify --dest <path-to-this-skill-directory>

Exit 0 means the installed tree's content address matches a receipt anchored in the lineage spine and audit chain. These two commands are the self-check contract the multi-host conformance sweep replays per agent host (bernstein skills package conformance).

Notes

  • Never mark a goal done from agent output alone; the lineage and audit verifications are the completion evidence.
  • If bernstein is not installed, say so and point at the prerequisites above; do not attempt to reimplement orchestration inline.
  • See references/worked-examples.md for end-to-end transcripts and per-host invocation notes.

© sipyourdrink-ltd, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/bernstein-run of sipyourdrink-ltd/bernstein.

  • SKILL.md
  • references/worked-examples.md

Open the folder on GitHubat commit cc0c7fc

Compare with similar skills

Bernstein Run 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.

Bernstein Run compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bernstein Run this skillsipyourdrink-ltd/bernstein1.2k—~722Automated safety check: PassApache-2.0
Orca CLIstablyai/orca89k2 repos~593Automated safety check: PassMIT
ClawTeam Multi-Agent Swarmwin4r/ClawTeam-OpenClaw1.5k1 repos~2.9kAutomated safety check: PassMIT
Agent of Empires Session Manageragent-of-empires/agent-of-empires3.3k—~2.5kAutomated safety check: PassMIT
Agent of Empires Session Manageragent-of-empires/agent-of-empires3.3k—~2.1kAutomated safety check: PassMIT
Clawteamwin4r/ClawTeam-OpenClaw1.5k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    89k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed
  • ClawTeam Multi-Agent Swarm

    win4r/ClawTeam-OpenClaw

    Launches a swarm of specialist Hermes agents in git-worktree-isolated tmux windows with a kanban board and file-based inboxes, using built-in templates like hedge-fund and code-review.

    1.5k GitHub starsUsed in 1 repo~2.9k tokens
    Agent WorkflowsAuto-check passed
  • Agent of Empires Session Manager

    agent-of-empires/agent-of-empires

    Launches, monitors and organizes AI coding agent sessions such as Claude Code or Codex inside tmux, tracking status, capturing output and managing git worktrees for parallel branches.

    3.3k GitHub stars~2.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agent of Empires Session Manager

    agent-of-empires/agent-of-empires

    Starts, monitors and organizes coding agent sessions that run in tmux through the aoe command, including groups, profiles and worktree-based parallel work.

    3.3k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Clawteam

    win4r/ClawTeam-OpenClaw

    Multi-agent swarm orchestration. An agent skill from win4r/ClawTeam-OpenClaw.

    1.5k GitHub stars~3.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Huashu Agent Swarm

    alchaincyf/huashu-skills

    多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

    1.7k GitHub stars~576 tokensUpdated 17 days ago
    Agent WorkflowsAuto-check passed

More from sipyourdrink-ltd/bernstein

All 9 skills in this repo
  • Bernstein Plan

    sipyourdrink-ltd/bernstein

    Create and manage multi-step execution plans in Bernstein. An agent skill from sipyourdrink-ltd/bernstein.

    1.2k GitHub stars~649 tokensUpdated today
    Auto-check passed
  • Bernstein Agents

    sipyourdrink-ltd/bernstein

    Manage Bernstein agents - list active agents, inspect their output, kill stalled agents, or stream live logs.

    1.2k GitHub stars~408 tokensUpdated today
    Auto-check passed
  • Bernstein Alerts

    sipyourdrink-ltd/bernstein

    Show active alerts from Bernstein - failed tasks, stalled agents, budget warnings, blocked tasks needing human intervention.

    1.2k GitHub stars~334 tokensUpdated today
    Auto-check passed
  • Bernstein Approve

    sipyourdrink-ltd/bernstein

    Review and approve/reject pending tasks or plans in Bernstein.

    1.2k GitHub stars~410 tokensUpdated today
    Auto-check passed
  • Bernstein Cost

    sipyourdrink-ltd/bernstein

    Show detailed cost breakdown and budget status for the Bernstein orchestrator.

    1.2k GitHub stars~332 tokensUpdated today
    Auto-check passed
  • Bernstein Create Task

    sipyourdrink-ltd/bernstein

    Create a new task in the Bernstein orchestrator. An agent skill from sipyourdrink-ltd/bernstein.

    1.2k GitHub stars~378 tokensUpdated today
    Auto-check passed

Categories

Questions about Bernstein Run

What does Bernstein Run do?

Run a verified multi-agent goal with Bernstein. An agent skill from sipyourdrink-ltd/bernstein. Bernstein Run is an agent skill from sipyourdrink-ltd/bernstein. Run a verified multi-agent goal with Bernstein.

When should I use Bernstein Run?

Bernstein Run fits situations like: A task is too large for a single agent session: Bernstein decomposes the goal into tasks; spawns CLI coding agents in parallel git worktrees; verifies their output; check run status.

How do I install Bernstein Run in Claude Code?

Run `npx skills add sipyourdrink-ltd/bernstein --skill bernstein-run -a claude-code`. Or copy the skill folder (skills/bernstein-run in sipyourdrink-ltd/bernstein) into .claude/skills/bernstein-run in your project. Claude Code loads it when a task matches its description.

How do I install Bernstein Run in Codex?

Run `npx skills add sipyourdrink-ltd/bernstein --skill bernstein-run -a codex`. Or copy the skill folder (skills/bernstein-run in sipyourdrink-ltd/bernstein) into .agents/skills/bernstein-run in your project. Codex loads it when a task matches its description.

Can I use Bernstein Run 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 sipyourdrink-ltd/bernstein --skill bernstein-run -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bernstein-run, .gemini/skills/bernstein-run, .github/skills/bernstein-run and .opencode/skills/bernstein-run in your project.

What does Bernstein Run need to run?

Going by SKILL.md and its folder, Bernstein Run needs the command-line tools its instructions call (pip and uv). Our summary lists: Python 3.

Does Bernstein Run access the network?

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

Is Bernstein Run 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 Bernstein Run use?

Bernstein Run is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bernstein Run use?

About 722 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. Its references folder adds about 603 tokens, read only when the agent opens those files.

What are the alternatives to Bernstein Run?

Skills that share tags, products or a category with Bernstein Run: Orca CLI (stablyai/orca, 89k stars), ClawTeam Multi-Agent Swarm (win4r/ClawTeam-OpenClaw, 1.5k stars), Agent of Empires Session Manager (agent-of-empires/agent-of-empires, 3.3k stars) and Agent of Empires Session Manager (agent-of-empires/agent-of-empires, 3.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bernstein Run?

sipyourdrink-ltd (a GitHub organization) maintains it in sipyourdrink-ltd/bernstein, which has 1,201 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 9, 2026.

Source: sipyourdrink-ltd/bernstein on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.