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.
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.
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.
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
Download the latest bundle ZIP or the individual SKILL.md files you use from the Skill Library.
Open Claude → Settings → Customize → Skills.
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.
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:
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].