4c57d201a4
The source headers, LICENSE files, and license metadata had drifted apart. Align the entire project to MIT: - Convert every source-file header to the MIT text across all comment styles (Go, TS, TSX, JS, MJS, SQL, CSS, GraphQL, shell), including SPDX-License-Identifier tags - Set the root and cookie-banner LICENSE files to the MIT text with a "MIT License" title line - Switch the package.json license fields, Docker image label, and cookie-banner README to MIT - Update docs and the genmodels header generator accordingly - Normalize copyright lines to a single format (Copyright (c) <year(s)> Probo Inc <hello@probo.com>.): unify the hello@getprobo.com and hello@probo.inc emails to hello@probo.com and the comma-separated years to a hyphenated range Genuine third-party references are intentionally left untouched: the Lucide icon attributions (Lucide is ISC) and the trivy dependency license allowlist. Signed-off-by: Sacha Al Himdani <sacha@probo.com>
6.0 KiB
Multi-agent compatibility
@probo/skills targets Claude Code, Codex, OpenCode, and
other MCP-capable agents (including Cursor). The portable core is Probo
MCP plus Agent Skills–compatible SKILL.md files.
What works where
| Component | Claude Code | Codex | OpenCode | Cursor |
|---|---|---|---|---|
| Probo MCP (OAuth) | ✅ Plugin .mcp.json |
✅ .codex-plugin + .mcp.json |
✅ Manual MCP config | ✅ IDE MCP settings |
Skills (SKILL.md) |
✅ skills/ |
✅ skills/ via .codex-plugin |
✅ .opencode/skills/ or .claude/skills/ |
✅ Copy/symlink to .cursor/skills/ |
| Commands | ✅ commands/ → /probo:… |
⚠️ Use skills instead | ⚠️ Native skill tool |
❌ Use skill or rules |
| Plugin manifest | .claude-plugin/ |
.codex-plugin/ |
Discovery paths (no manifest) | No native manifest |
| Marketplace catalog | .claude-plugin/marketplace.json (repo root or package) |
.agents/plugins/marketplace.json (repo root or package) |
— | — |
Probo MCP (all agents)
Set the instance URL:
export PROBO_BASE_URL="https://your-probo-instance.example.com"
Endpoint: ${PROBO_BASE_URL}/mcp/v1 (HTTP, OAuth 2.0). Do not configure a
static bearer token — OAuth discovery uses
/.well-known/oauth-protected-resource.
Claude Code
From the monorepo or GitHub (repo-root catalog at
.claude-plugin/marketplace.json):
claude plugin marketplace add getprobo/probo
# or, from a local clone:
claude plugin marketplace add .
claude plugin install probo@probo
claude mcp login probo # or /mcp in session
/probo:access-review Q3 GitHub review
From the package directory (catalog resolves @probo/skills from npm):
claude plugin marketplace add ./packages/skills/.claude-plugin
claude plugin install probo@probo
claude mcp login probo
Or install the plugin directory directly:
claude --plugin-dir ./packages/skills
Codex
From the monorepo or GitHub (repo-root catalog at
.agents/plugins/marketplace.json):
codex plugin marketplace add getprobo/probo
# or, from a local clone:
codex plugin marketplace add .
codex plugin install probo@probo
codex mcp login probo
From the package directory (catalog at
packages/skills/.agents/plugins/marketplace.json):
codex plugin marketplace add ./packages/skills
codex plugin install probo@probo
codex mcp login probo
Or install the plugin directory directly:
codex plugin install ./packages/skills
codex mcp login probo
Skills load from ./skills/ via .codex-plugin/plugin.json. The repo-root
marketplace source.path is ./packages/skills; the package-level
catalog uses ./ (plugin package root).
OpenCode
OpenCode discovers skills at .opencode/skills/, .claude/skills/, and
~/.config/opencode/skills/. Options:
Option A — symlink from this package:
mkdir -p .opencode/skills
ln -s ../../packages/skills/skills/access-review .opencode/skills/access-review
ln -s ../../packages/skills/skills/open-source-compliance .opencode/skills/open-source-compliance
Option B — Claude Code bridge: install
opencode-claude-code-bridge
to import Claude plugins and MCP configs into OpenCode.
Configure Probo MCP in opencode.json or global OpenCode MCP settings, then
authenticate. Invoke via the native skill tool (access-review).
Cursor
- Add Probo MCP in Cursor settings (HTTP URL:
${PROBO_BASE_URL}/mcp/v1, OAuth). - Copy or symlink skills into
.cursor/skills/:
mkdir -p .cursor/skills
cp -r packages/skills/skills/access-review .cursor/skills/
Reference the skill in chat or add a Cursor rule pointing at the skill.
Portable vs agent-specific paths
| Path | Portable? |
|---|---|
skills/<name>/SKILL.md |
✅ Agent Skills standard |
skills/<name>/references/*.md |
✅ Relative to skill directory |
.mcp.json with ${PROBO_BASE_URL} |
✅ Standard env var |
${CLAUDE_PLUGIN_ROOT} |
❌ Claude Code only — avoid in skill bodies |
commands/*.md |
Claude Code slash commands only |
Skill bodies use relative references/ paths so they work once the skill
directory is discovered, regardless of which agent loads it.
npm package layout
@probo/skills/
.claude-plugin/plugin.json # Claude Code manifest
.claude-plugin/marketplace.json # Claude marketplace (npm)
.codex-plugin/plugin.json # Codex manifest
.agents/plugins/marketplace.json # Codex marketplace (package-local)
.mcp.json # Shared MCP wiring
skills/ # Shared skills (all agents)
commands/ # Claude Code commands only
Repo root (monorepo / getprobo/probo Git installs):
.claude-plugin/marketplace.json # Claude marketplace → packages/skills
.agents/plugins/marketplace.json # Codex marketplace → packages/skills