bg-superpowers

bg-superpowers

Requires obra/superpowers. bg-superpowers is a domain-specific complement, not a replacement.

Boardgame-design skills for Claude Code, Codex (CLI + App), and Cursor. Promotes recurring rules from CLAUDE.md files — xlsx-as-golden-reference, smart-only balance lobbies, report quality gates, evidence-first verification, versioned design docs — into invokable skills that auto-trigger at the right moments.

What's inside

Skill	When it fires
using-bg-superpowers	Auto-loads on SessionStart. Index + invocation gate for the rest.
rules-version-auditor	Editing xlsx, rules.md, or code constants that hold game numbers.
balance-report-critic	About to present any analysis or win-rate claim.
checklist-enforcer	A project checklist (REPORT_CHECKLIST, preflight) is being walked.
evidence-first-verifier	About to claim "fixed", "passing", "deployed", "above baseline".
versioned-design-doc-keeper	Writing to a vXpYY-named directory or file.
data-pipeline-builder	Building or modifying an xlsx → JSON → engine pipeline.
interactive-review-tool	Need a browser-based click-edit tool for design artifacts.
bot-battle-referee	Running balance or strategy bot evaluation.
anomaly-scanner	After a batch of playtest or simulation runs.
seasoned-war-gamer	Veteran-player critique of a mechanic, rule, or counter design.

Repo layout

Since v0.2.0, the repo is a multi-plugin marketplace. The plugin itself lives under plugins/bg-superpowers/; the repo root holds marketplace manifests (one for Claude Code, one for Codex) and shared tooling.

bg-superpowers/                          # repo root = marketplace
├── .claude-plugin/marketplace.json      # Claude Code marketplace
├── .agents/plugins/marketplace.json     # Codex marketplace
├── README.md  LICENSE  scripts/
└── plugins/bg-superpowers/              # the actual plugin
    ├── .claude-plugin/plugin.json
    ├── .codex-plugin/plugin.json
    ├── .cursor-plugin/plugin.json
    ├── skills/<name>/SKILL.md × 11
    ├── hooks/{hooks.json, hooks-cursor.json, session-start, run-hook.cmd}
    └── CLAUDE.md

Installation

Claude Code

claude plugin marketplace add taojiastanford/bg-superpowers
claude plugin install bg-superpowers@bg-superpowers-marketplace

User-scope install — available in every new Claude Code session, every directory. Verify with claude plugin list.

Update later:

claude plugin update bg-superpowers
# restart the session for the update to take effect

Codex CLI

First install Codex CLI itself if you haven't:

sudo npm i -g @openai/codex   # requires Node >= 16; sudo if your npm prefix is root-owned
# or (when Homebrew's Codex cask is healthy):  brew install --cask codex

Sign in once (opens a browser):

codex            # then exit after the sign-in flow completes

Register the bg-superpowers marketplace:

codex plugin marketplace add taojiastanford/bg-superpowers

That writes a [marketplaces.bg-superpowers-marketplace] entry into ~/.codex/config.toml and clones the repo into ~/.codex/.tmp/marketplaces/bg-superpowers-marketplace/.

Then enable the plugin. Codex's CLI has no plugin install subcommand — pick one:

• Interactive (recommended): run codex, type /plugins, find bg-superpowers in the picker, toggle it on. Exit.

• Manual: add this block to ~/.codex/config.toml:

  [plugins."bg-superpowers@bg-superpowers-marketplace"]
  enabled = true
  

Confirm with codex plugin marketplace add --help (sanity check the CLI is current) or simply cat ~/.codex/config.toml | grep bg-superpowers.

Codex App

Codex App and Codex CLI share ~/.codex/config.toml. Once you've done the CLI steps above, the App automatically lists bg-superpowers in its Plugins panel with the same enable state. No separate install.

If your Codex App build exposes a "Custom marketplace" or "Developer mode" UI, you can add taojiastanford/bg-superpowers there directly without using the CLI.

Cursor

In Cursor Agent chat:

/add-plugin https://github.com/taojiastanford/bg-superpowers

Or use the plugin marketplace UI and paste the GitHub URL.

v0.2 ships the Cursor manifest but Cursor parity has not been heavily tested.

OpenCode

Not supported in v0.2 — see CLAUDE.md TODO list.

Local development install (no GitHub round-trip)

For Claude Code, point the marketplace at the local repo:

claude plugin marketplace add /Users/taojia/.../boardgames/bg_superpowers
claude plugin install bg-superpowers

How the skills auto-trigger