Agent skill

Bernstein Plan

by sipyourdrink-ltd in sipyourdrink-ltd/bernstein

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

Apache-2.0Auto-check passedAgent Workflows

Install Bernstein Plan

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

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

GitHub CLI
$ gh skill install sipyourdrink-ltd/bernstein bernstein-plan --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/packages/cursor-plugin/skills/bernstein-plan .claude/skills/bernstein-plan && 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-plan
GitHub stars
1.4k
Token cost
~649 tokens
SKILL.md length
208 words
Files
2 (incl. scripts)
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 4 steps: Analyze the user's request and decompose… → Write a plan YAML file using this… → Save the plan to plans/{plan-name}.yaml… → …
  • The user wants to plan a complex feature
  • SKILL.md covers When to Use, Instructions and Tips
  • Runs Shell scripts from its folder

What it does

Bernstein Plan is an agent skill from sipyourdrink-ltd/bernstein. Create and manage multi-step execution plans in Bernstein. Plans decompose complex goals into stages with dependencies. Use when the user wants to plan a complex feature, break down a large task, or review an execution plan before agents start working.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/plan.sh`).

It sits in Agent Workflows. 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

  • The user wants to plan a complex feature
  • Break down a large task
  • Review an execution plan before agents start working

Example prompts

  • “/bernstein-plan”

Requirements

  • A Bash shell

Workflow steps

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

  1. Analyze the user's request and decompose it into stages and tasks.
  2. Write a plan YAML file using this structure
  3. Save the plan to plans/{plan-name}.yaml in the project root.
  4. Tell the user to execute it: bernstein run plans/{plan-name}.yaml

What it can do on your machine

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

    Ships 1 file in scripts/ (Shell), which the agent can run.

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

  • Network

    No URLs in SKILL.md.

    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 Plan loads about 649 tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 208 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from sipyourdrink-ltd/bernstein at commit aee2ea2, republished under its Apache-2.0 licence (© sipyourdrink-ltd). 208 words, ~649 tokens.

Download SKILL.mdSave it as .claude/skills/bernstein-plan/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
bernstein-plan
description
Create and manage multi-step execution plans in Bernstein. Plans decompose complex goals into stages with dependencies. Use when the user wants to plan a complex feature, break down a large task, or review an execution plan before agents start working.

Bernstein Plan Mode

Create structured execution plans that get human approval before agents start.

When to Use

  • User describes a complex feature: "implement user authentication with OAuth"
  • User wants to break down a large task into stages
  • User says "plan this out" or "create a plan for..."
  • User wants to review what agents will do before they start

Instructions

Creating a plan
  1. Analyze the user's request and decompose it into stages and tasks.
  2. Write a plan YAML file using this structure:
yaml
name: "{descriptive plan name}"
description: "{what this plan achieves}"
stages:
  - name: foundation
    steps:
      - goal: "Create database models for user and session"
        role: backend
        scope: small
        complexity: low
      - goal: "Add migration scripts"
        role: backend
        scope: tiny

  - name: implementation
    depends_on: [foundation]
    steps:
      - goal: "Implement OAuth2 flow with Google provider"
        role: backend
        scope: medium
        complexity: medium
      - goal: "Create login/signup UI components"
        role: frontend
        scope: medium

  - name: verification
    depends_on: [implementation]
    steps:
      - goal: "Write integration tests for auth flow"
        role: qa
        scope: medium
      - goal: "Security review of token handling"
        role: security
        scope: small
  1. Save the plan to plans/{plan-name}.yaml in the project root.
  2. Tell the user to execute it: bernstein run plans/{plan-name}.yaml
Or submit via API
  1. Run scripts/plan.sh submit plans/{plan-name}.yaml to submit for approval.
  2. The plan enters pending state - use /bernstein-approve to review and approve.
  3. Once approved, planned tasks promote to open and agents start picking them up.
Reviewing plans
  1. Run scripts/plan.sh list to see all plans and their status.
  2. Show the plan with stages, dependencies, and estimated cost/time.

Tips

  • Keep stages to 2-5 tasks each
  • Use depends_on to enforce ordering (foundation before implementation)
  • Assign appropriate roles: backend, frontend, qa, security, devops, docs
  • Mark risky tasks with complexity: high - they'll get more capable models
  • Foundation stages should be tiny or small scope

© 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 (scripts) in packages/cursor-plugin/skills/bernstein-plan of sipyourdrink-ltd/bernstein.

  • SKILL.md
  • scripts/plan.sh

Open the folder on GitHubat commit aee2ea2

Compare with similar skills

Bernstein Plan 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 Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bernstein Plan this skillsipyourdrink-ltd/bernstein1.4k—~649Automated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k35 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79589 repos~8.2kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 35 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    297k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

More from sipyourdrink-ltd/bernstein

All 9 skills in this repo
  • Bernstein Run

    sipyourdrink-ltd/bernstein

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

    1.4k GitHub stars~722 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.4k 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.4k GitHub stars~334 tokensUpdated today
    Auto-check passed
  • Bernstein Approve

    sipyourdrink-ltd/bernstein

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

    1.4k 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.4k 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.4k GitHub stars~378 tokensUpdated today
    Auto-check passed

Categories

Questions about Bernstein Plan

What does Bernstein Plan do?

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

When should I use Bernstein Plan?

Bernstein Plan fits situations like: the user wants to plan a complex feature; break down a large task; review an execution plan before agents start working.

How do I install Bernstein Plan in Claude Code?

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

How do I install Bernstein Plan in Codex?

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

Can I use Bernstein Plan 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-plan -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-plan, .gemini/skills/bernstein-plan, .github/skills/bernstein-plan and .opencode/skills/bernstein-plan in your project.

What does Bernstein Plan need to run?

Going by SKILL.md and its folder, Bernstein Plan needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Bernstein Plan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bernstein Plan 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Bernstein Plan use?

Bernstein Plan 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 Plan use?

About 649 tokens (SKILL.md is roughly 2.6k 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 Bernstein Plan?

Skills that share tags, products or a category with Bernstein Plan: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bernstein Plan?

sipyourdrink-ltd (a GitHub organization) maintains it in sipyourdrink-ltd/bernstein, which has 1,447 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.