install

Four flows.

download bundle

Every skill is a single SKILL.md file. Install the full set or just the ones you want. No API keys, no package manager, no build step.

01

Claude Code CLI

Need the CLI first? Install Claude Code , open a terminal at your project root, then drop the skills into .claude/skills/. Claude Code auto-discovers them on the next session.

curl -L https://opchain.dev/opchain-skills.zip -o opchain-skills.zip
unzip opchain-skills.zip -d .claude/skills/
claude
> /oc-discover

Verify it worked. In that session, type /oc-discover. If oc-app-architect starts an interview ("Who's the primary user? Sync or async? …"), you're set. If not, re-check that the files landed in .claude/skills/<name>/SKILL.md.

02

Claude.ai / Claude Desktop

  1. Download the full bundle ZIP or individual SKILL.md files from the Skill Library.
  2. Open Claude → Settings → Customize → Skills.
  3. Click Upload skill and pick the .md file.
  4. Start a new conversation and trigger by name ("I have an app idea" auto-invokes oc-app-architect) or by slash command (/oc-discover).
03

Team (check into git)

Commit the skills directory so every teammate uses the same prompt pipeline.

git add .claude/skills/
git commit -m "chore: add opchain skills"
git push
04

Codex / any MCP agent

Codex — and any MCP-aware agent (Claude Desktop, Cursor, Windsurf) — reaches opchain over the Model Context Protocol. Point your client at the hosted endpoint and you get the catalog, intent routing, the orchestrator protocol, and checkpoints — the same pipeline Claude Code auto-discovers.

Hosted MCP server — nothing to install:

# ~/.codex/config.toml
[mcp_servers.opchain]
url = "https://opchain.dev/mcp"

Or drop the skills in directly — Codex Agent Skills use the same SKILL.md format:

curl -L https://opchain.dev/opchain-skills.zip -o opchain-skills.zip
unzip opchain-skills.zip -d .codex/skills/
codex

Verify it worked. Run codex and ask "build me an app" — opchain's route tool (or an implicit skill match) hands you to oc-app-architect's discovery interview. With the MCP server, the /oc-* commands also appear as prompts in the slash menu.

upgrade

Update an existing install

Already running opchain in a project? Replace the skills in place. Your .checkpoints/ directory lives outside .claude/skills/, so every skill's session state — phase, step, next actions, decisions — is preserved across the swap. The new skills pick up the existing checkpoints on their next invocation.

Claude Code CLI

Run from your project root. This wipes the old skills directory and replaces it with the latest bundle.

# .checkpoints/ is a sibling of .claude/ — never touched by this swap
rm -rf .claude/skills/
curl -L https://opchain.dev/opchain-skills.zip -o opchain-skills.zip
unzip opchain-skills.zip -d .claude/skills/
rm opchain-skills.zip

Verify the new version is live. Check what the site is currently shipping with curl https://opchain.dev/api/health (the version field is the build SHA), then start a new Claude Code session and run /oc-ops — the orchestrator should report your existing checkpoints exactly where you left them.

Claude.ai / Claude Desktop

  1. Download the latest bundle ZIP or the individual SKILL.md files you use from the Skill Library.
  2. Open Claude → Settings → Customize → Skills.
  3. For each skill you've installed, click the existing entry and choose Replace (or delete and re-upload). Skills are matched by name, so the new file overrides the old one.
  4. Checkpoints in Claude.ai live in the project, not the skill, so they survive the upload.

Team (git-tracked install)

If you committed .claude/skills/ with the team flow, do the upgrade on a branch so the skill diff lands in review:

git checkout -b chore/upgrade-opchain
rm -rf .claude/skills/
curl -L https://opchain.dev/opchain-skills.zip -o opchain-skills.zip
unzip opchain-skills.zip -d .claude/skills/
rm opchain-skills.zip
git add .claude/skills/
git commit -m "chore: upgrade opchain skills"

Reviewers see exactly which skills changed, and .checkpoints/ is untouched because it's a separate top-level directory.

Check which version you're on

curl -sS https://opchain.dev/api/health | jq .version

Returns the build SHA currently published at opchain.dev. Re-run after upgrading and confirm a fresh Claude session sees the new skills under .claude/skills/<name>/SKILL.md.

Configuration

.claude/skills/
Where Claude Code looks for skills.
.checkpoints/
Skills write JSON session state here. Add to .gitignore.
orchestrator.md
Shared welcome protocol + pipeline map. Bundled with every skill.
.codex/skills/
Where Codex looks for drop-in skills — same SKILL.md format as Claude Code.
~/.codex/config.toml
Register the hosted MCP server under [mcp_servers.opchain].

What you get

Want a preview first? The demo walks you through six end-to-end opchain sessions, end to end.

what next

Your first 30 minutes

Skills are inert until you trigger one. Here are three starter paths — pick whichever matches the moment.

02

Joining an existing repo

Code already on disk · no opchain history

  1. Run /oc-rev-specoc-reverse-spec backfills a spec from the code
  2. Type /oc-ops for the orchestrator's read on what's open
  3. oc-code-auditor tells you the top-five concerns before your next commit
03

Shipping a fix in flight

Bug or feature already in progress

  1. oc-bug-check on the diff — type / lint / secrets / vulns
  2. oc-code-auditor for an Auditor/Fixer/Verifier pass
  3. oc-git-ops opens the PR with shape-aware title + body
  4. oc-deploy-ops blocks prod until every audit gate is green

Not sure what fits? Try the pipeline builder — four questions, custom recommendations, a starter CLAUDE.md. Or browse every skill and pick by hand.