OrchestKit Docs MCP

io.github.yonatangross由 GitHub 帳號 yonatangross 發布v10.10.5更新於 Nov 8, 2026

Read-only MCP server for the OrchestKit docs: full-text search + Markdown fetch. No auth.

已驗證Streamable HTTP可網頁執行知識與記憶開發者工具

概覽

AI 產生的概覽

唯讀的 MCP 伺服器,讓助理搜尋 OrchestKit 文件並以 Markdown 取得頁面,無需驗證。

可以做什麼
  • 用查詢字串搜尋 OrchestKit 文件,回傳附標題與連結的排序頁面清單
  • 依頁面路徑取得單一文件頁面,並以 Markdown 形式讀取全文
  • 依先搜尋再閱讀的流程回答關於 OrchestKit 技能、代理、鉤子與宿主設定的問題
適用情境
當你使用 OrchestKit 這個 Claude Code 外掛,希望助理依據官方文件而非猜測來回答安裝、宿主支援或技能相關問題時適用。在安裝或設定此外掛前核對文件所述行為時也有用。
執行需求
未宣告任何驗證、環境變數或標頭。可透過遠端 streamable HTTP 端點存取,也可用 Docker 映像以 stdio 在本機執行;使用遠端端點需要網路存取。
安裝前請注意
此伺服器被描述為唯讀,不應變更任何內容。README 介紹的是範圍更大的 OrchestKit 外掛,其鉤子會寫入本機遙測日誌,並可能將提示文字傳送給 Anthropic 或執行 gh 指令;這些行為屬於外掛,而非此文件伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 OrchestKit Docs MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.yonatangross%2Forchestkit/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "orchestkit-docs": {
      "type": "http",
      "url": "https://orchestkit.dev/api/mcp"
    }
  }
}

README

Start here

OrchestKit is a free, open source Claude Code plugin: skills, agents and hooks for review, testing, security and memory.

bash
claude plugin marketplace add yonatangross/orchestkit && claude plugin install ork@orchestkit

Docs · What's new in v10 · yonyon.ai


Explore the Docs → · OrchestKit Community →
Skill browser, demo gallery, setup wizard


Contents

Quick Start

Pick the host you actually use. Claude Code is the full plugin (skills + agents + hooks). Cursor gets the same ork plugin minus Claude hook scripts. skills.sh is skills only — start with the 12 below, not the whole catalog.

Host support matrix

Measured 2026-09-08 on pi 0.85, Codex CLI and cursor-agent. Details, commands and the lane model: OrchestKit on pi, Codex and Cursor. Antigravity measured 2026-09-18 on agy 1.2.6; full evidence in docs/audits/agy-host-support-2026-09-18.md.

SurfaceClaude CodeCursorCodexpiDevinAntigravity
Skills (SKILL.md)allall, via the ork plugin6 (ork-codex pack)all via pi install, 78 auto-listed76 of 107, GH-4146all via workspace .agents/skills (skills.sh); ork:<name> via agy plugin install
Agentsallall4 role templatesnonenot reported by info36 via agy plugin install (validated); none via .agents/skills
Hooksallnonenonenonenonenone of ork's; agy hooks.json is a different schema
Rulesrepo convention14, plugin rules keyAGENTS.mdnoneAGENTS.md, always onAGENTS.md, per-directory
Commands/ork:<skill>36 wrappers$ork-<skill>/skill:<name>/ork:<skill>/<skill-name>; ork:<skill> via plugin install
MCP config.mcp.json.cursor/mcp.jsonplugin mcp.json.pi/mcp.jsonmcp.json / .mcp.json~/.gemini/config/mcp_config.json or plugin mcp_config.json; repo .mcp.json not read
Statusshippedshippedshippedshippedskills only, GH-4146skills only, measured agy 1.2.6

Claude Code

bash
/plugin marketplace add yonatangross/orchestkit/plugin install ork

Then /ork:setup. The wizard scans the repo, recommends skills, and writes MCP config.

CLI equivalent: claude plugin marketplace add yonatangross/orchestkit && claude plugin install ork@orchestkit.

Channels: ork is the stable channel, pinned to the latest release. ork-alpha is the same plugin tracking main, in the same marketplace (claude plugin install ork-alpha@orchestkit); use it only if you want changes before they are released.

Cursor

Settings → Plugins / marketplaces → add yonatangross/orchestkit → enable ork → open a new chat. Same plugin Claude Code installs, not a five-skill fork. See Install → Cursor.

skills.sh (Cursor, Codex, OpenCode, …)

Starter 12 from measured installs plus the ork skills we retain (full why table under Install):

bash
npx skills add yonatangross/orchestkit -s devops-deployment -s responsive-patterns -s architecture-decision-record -s ui-components -s rag-retrieval -s agent-orchestration -s brainstorm -s expect -s auto -s review-pr -s fix-issue -s commit

Full catalog: npx skills add yonatangross/orchestkit (hundreds of SKILL.md files; do not treat that as unique users). Live install totals stay on the skills.sh badge above.


Why OrchestKit?

Every Claude Code session starts from zero. You explain your stack, patterns, preferences—again and again.

OrchestKit gives Claude persistent knowledge of production patterns that work automatically:

WithoutWith OrchestKit
"Use FastAPI with async SQLAlchemy 2.0...""Create an API endpoint" → Done right
"Remember cursor pagination, not offset..."Agents know your patterns
"Don't commit to main branch..."Hooks block bad commits
"Run tests before committing..."/ork:commit runs tests for you

What You Get

One unified plugin, everything included.

ComponentDetails
115 SkillsRAG patterns, FastAPI, React 19, testing, security, database design, ML integration — loaded on-demand, zero overhead
36 AgentsSpecialized personas (backend-architect, frontend-dev, security-auditor) — route tasks to the right expert
163 HooksPre-commit checks, git protection, quality gates, browser safety — ship with confidence

All available in a single /plugin install ork. Skills load on-demand. Hooks work automatically.

Browse everything in the Docs →


Key Commands

bash
/ork:auto         # Front door: describe a goal, it routes to the right skill/ork:setup        # Personalized onboarding wizard/ork:implement    # Full-stack implementation with parallel agents/ork:expect       # Diff-aware AI browser testing/ork:review-pr    # PR review with parallel agents/ork:verify       # Multi-agent validation/ork:commit       # Conventional commit with pre-checks/ork:explore      # Analyze unfamiliar codebase/ork:remember     # Save to persistent memory/ork:doctor       # Health check

Configuration

/ork:setup detects your stack, recommends MCP servers, and writes the configuration for you.

Recommended MCP Servers

ServerPurposeRequired?
Context7Up-to-date library docsPrerequisite (22 of 36 agents grant its tools)
MemoryKnowledge graph persistenceRecommended
Sequential ThinkingStructured reasoning for subagentsRecommended
TavilyWeb search and extractionOptional

Set "alwaysLoad": true on the first three in your .mcp.json. It skips the per-skill tool probe and shaves ~150ms off cold starts.

Context7 is a prerequisite, and ork does not ship it. 22 agents grant mcp__context7__* in their frontmatter, but .mcp.json is user-owned and project-scoped, so the grant refers to a server you add. Skip it and those agents answer from training data with no error raised. The recommended entry is the hosted HTTP server, which costs no local process:

json
"context7": {  "type": "http",  "url": "https://mcp.context7.com/mcp"}

Free tier: 1,000 requests, public repos, no account. Context7 Pro ($10 per seat per month) raises that to 5,000 per seat and parses private repos; add "headers": { "Authorization": "Bearer ${CONTEXT7_API_KEY}" } and export the ctx7sk- key. Add the header only once the variable is exported: with it unset the unexpanded literal is sent as the token and every query fails, and it does not fall back to the anonymous free tier, so the keyless entry above is strictly better than a header with no key behind it. The legacy stdio transport (npx -y @upstash/[email protected]) is the fallback when the hosted endpoint is unreachable, but it spawns one child process per Claude Code session, so the fan-out scales with how many sessions you keep open.

Customizing skills

Skills install as files on your disk, but don't hand-edit the installed copy — it gets overwritten on update and silently diverges from the canonical playbook. The supported ways to extend (user-level skills, project skills, upstream PRs, or disabling a bundled skill) are in docs/extending-skills.md.


What OrchestKit observes

OrchestKit is a quality-gate plugin, so its hooks are the product rather than an add-on. This section states plainly what they see, where it goes, and how to turn each piece off.

Scope: broad and intentional. OrchestKit registers 163 hooks across 32 lifecycle events, including SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, and Stop. They are not gated to a particular framework or project type, because the gates they enforce (secret-write blocking, protected-file guards, git safety, file-size limits, agent status protocol) apply to any codebase. If you only want gates on some projects, enable the plugin per-project rather than globally.

Where data goes: a local file on your own disk.

WhatDestinationNotes
Lifecycle events (session end, PR merged, goal converged, chain phase)~/.local/state/orchestkit/events.jsonlWritten unconditionally, rotated at 10 MB. ORK_EVENTS_LOG redirects the path (used by the test suite)
Hook metrics: event name, tool name, payload size, durationsame local fileSize-capped metrics only
Hook telemetry log: event, tool name, session id, branch, timestamp, and tool inputs and outputstelemetry/events.jsonl in the plugin data folder (or .claude/telemetry/ in the project)Secrets redacted, every string cut to 500 characters. Rotated at 10 MB at session end; rotated files deleted after 7 days
Prompt textNot recorded in either logHooks read it to make an allow/deny decision, then discard it
Remote syncOffNo endpoint is compiled in; see below

There is deliberately no global kill switch for the local write, because the gates depend on that state (the git-safety and chain-staleness hooks read their own prior events). To stop it entirely, disable the plugin. Individual noisy hooks have their own opt-outs: ORK_DISABLE_DEBT_TRACKER, ORK_DISABLE_WORKTREE_VERIFIER, ORK_DISABLE_COORDINATION_METRICS, ORK_NO_NOTIFY, ORK_NO_STALE_SWEEP, and ORCHESTKIT_SKIP_SLOW_HOOKS among others.

Network access from the hooks themselves is opt-in and unset by default. The only remote host compiled into the shipped hook bundles is api.typesafe.ai, used solely by the two opt-in TypeSafe settings below (grep -o 'https\?://[A-Za-z0-9.-]*' plugins/ork/hooks/dist/*.mjs also lists github.com, which appears only in printed links). By default some hooks run CLIs you already have, which use your own credentials and network:

  • claude -p --model haiku on the first prompt of a session, to title and color it. It sends the git branch name and the first 600 characters of that prompt to Anthropic through your own Claude Code login, with no tools, MCP servers or hooks in the child. ORK_SESSION_IDENTITY=0 turns it off.
  • gh issue view <n> when a subagent starts on a branch named like issue/<n>-... or fix/<n>-..., to add the issue title and body as context.
  • gh pr view and gh pr list when a Bash command runs gh pr merge with --delete-branch, to warn before deleting a branch that open PRs are based on.

Any other outbound call happens only if you configure a destination yourself, via one of:

  • ORCHESTKIT_HOOK_URL + ORCHESTKIT_HOOK_TOKEN (or the plugin's webhookUrl and hookToken options), which enable hooks/bin/telemetry-sync.mjs. It POSTs your local JSONL to your own endpoint. A SessionEnd hook runs it in the background; without a URL and token it exits at once and sends nothing. The same two settings enable the webhook forwarder, which streams hook events, HMAC signed, to that endpoint.
  • telemetry.sinks entries in ~/.claude/settings.local.json or in the plugin data folder's settings.local.json (user scope only, never read from a project), each an https: URL you choose.
  • ORK_HQ_TELEMETRY_URL, which points the telemetry HTTP sink at your own collector.
  • ORK_HQ_TELEMETRY_USE_HQ_API=1 together with HQ_API_URL, the same sink aimed at a self-hosted HQ API.
  • ORK_SESSION_CATEGORY_PROVIDER=jev (or shadow) together with the TypeSafe key variable ORK_TYPESAFE_API_KEY, a second classifier for the session work category. The session-identity hook already asks a local claude -p --model haiku process for a title and a category; with both variables set it also asks TypeSafe's Jev model (api.typesafe.ai, model pinned to jev-1.13.0) one typed Choice over the same eight categories and the same criteria text. This is the one exception to the "no hardcoded host" note above, and it is dormant unless both variables are set. What leaves your machine: the git branch name and the first 600 characters of the session's first prompt, sent to a third-party processor under its own data policy. What changes in jev mode: when Jev answers at confidence 0.8 or above, its category decides the session color (held out on 150 sessions, that band is 93.5% correct); below 0.8, or on any error, haiku's category decides as before. The title and emoji always come from haiku. In shadow mode nothing you see changes; Jev is only logged beside haiku. To turn it on locally, in the shell that launches claude: export ORK_TYPESAFE_API_KEY="$(<your secret manager> ...)" and export ORK_SESSION_CATEGORY_PROVIDER=jev. Both outcomes are logged once per session in the hook log, as category jev: haiku=<cat> jev=<cat> agree=<bool> confidence=<n> decided_by=jev|haiku threshold=0.8 latency_ms=<n>, and as session-identity.shadow.json with the same fields (labels, decision, timing; never prompt text) next to the raw answer session-identity.jev.json in the session data directory. Cost of opting in: the first prompt of a session waits for the call to settle, 1.1 to 1.7 s measured from a fresh hook process (the eval's 320 ms was a warm connection), 3 s at most before it gives up.
  • ORK_ROUTE_JEV=shadow (or steer) together with ORK_TYPESAFE_API_KEY, the Jev routing seam for /ork:auto (#4233). Off by default. When set, every build-shaped prompt (the same test the once-per-session executor reminder uses: an imperative build or fix verb, 40 characters or more, no explicit /plugin:skill) is sent to the same TypeSafe endpoint and model as one typed Choice over nineteen route classes plus four side judgments (needs a worktree, needs a browser, mutation risk, needs the operator). What leaves your machine: the first 1,500 characters of the prompt after a redactor has replaced secrets, emails, Israeli phone numbers, nine digit ids, op:// references and the names of directories under clients/ with [SECRET], [EMAIL], [PHONE] and [CLIENT], plus the repository basename. The serialized request is scanned again before it leaves; anything that survives redaction refuses the call. In shadow mode nothing you see changes; the verdict is logged. In steer mode, at confidence ORK_ROUTE_JEV_FLOOR (default 0.5) or above, the one-line executor reminder names the executor the class maps to (route: dev_fix -> /ork:fix-issue (conf 0.83)); the model still reads the /ork:auto table and says whether it agrees. Fallbacks are fail open: no key, timeout, non-2xx, malformed answer, below the floor, or the daily token budget (ORK_ROUTE_JEV_DAILY_TOKENS, default 2,000,000) spent all mean the existing path runs untouched; a 402 or 429 switches the seam off for 24 hours. One log line per prompt, route jev: intent=<class> conf=<n> top3=<a:p,b:p,c:p> worktree=<n> browser=<n> mutation=<n> operator=<n> floor=<n> decided_by=jev|table|off|budget|egress latency_ms=<n> input_tokens=<n> redacted=<n>, and one record per prompt in jev-route.jsonl next to session-identity.jev.json (labels, timings and a sha256 of the redacted text; never prompt text). Offline replay: node scripts/eval/route-check.mjs --jev and node scripts/eval/jev-route-score.mjs. The vendor's agent skill is a peer plugin installed from its own marketplace, never a copied directory: claude plugin marketplace add typesafe-ai/skills then claude plugin install typesafe@typesafe-ai; /ork:doctor reports the installed version against the marketplace and prints the update commands.

The sink returns early when the URL or the token is missing, and telemetry-sync.mjs prints No ORCHESTKIT_HOOK_URL or TOKEN configured. Nothing to sync. then exits 0. There is no analytics ping, no crash reporter, and no feature-flag fetch.

What OrchestKit never reads. No OS keychain lookups, no ~/.aws/credentials, no SSH private keys, no browser cookie or login stores, no clipboard. The one place secret-shaped paths appear in the source is plugins/ork/hooks/dist/pretool.mjs, where id_rsa, .pem, .env, and credentials.json form a blocklist that stops Claude writing to them. That code denies access; it does not read those files.

Third-party MCP servers are recommendations, not bundled dependencies. The plugin ships no .mcp.json and declares no mcpServers. The table under Configuration is advisory, and /ork:setup asks before writing anything.


Install

bash
/plugin install ork

No tiering. No version confusion. Just one powerful plugin.

Not on Claude Code? Pull a starter 12 into any agent (Cursor, Codex, OpenCode, …) via skills.sh — do not install the whole firehose on day one. Picked from measured skills.sh installs on our listing plus the ork skills we actually retain:

skillwhy
devops-deploymentmost-installed cloud skill on our listing
responsive-patternsmost-installed design skill on our listing
architecture-decision-recordwriting-bucket install leader
ui-componentsdesign install co-leader
rag-retrievalSE install leader
agent-orchestrationagent-workflow install leader
brainstormour most-retained ork skill
expectbrowser verification we run day to day
autofront-door router we actually invoke
review-prship-loop review we use
fix-issuedebug loop we use
commitship-loop commit (has a with/without receipt)
bash
npx skills add yonatangross/orchestkit -s devops-deployment -s responsive-patterns -s architecture-decision-record -s ui-components -s rag-retrieval -s agent-orchestration -s brainstorm -s expect -s auto -s review-pr -s fix-issue -s commit

All skills: npx skills add yonatangross/orchestkit. Live install totals stay on the skills.sh badge above, not hard-coded here.

Cursor

Cursor loads Agent Plugins and Cursor plugins. This repo already ships the Agent Plugins manifest at plugins/ork/plugin.json. Add the GitHub repo as a Cursor marketplace (Settings → yonatangross/orchestkit), enable ork, then open a new chat. That is the same plugin Claude Code installs, not a five-skill fork.

It also ships 14 rules under the plugin's rules key, generated from src/rules/ and src/shared/rules/. They are agent-fetched, so a rule costs context only when its description matches the task.

Claude hook scripts are not registered for Cursor: they depend on ${CLAUDE_PLUGIN_ROOT} (orchestkit#293, closed). Cursor enforcement for HQ repos stays in the consuming project's .cursor/hooks.json.

"Include third-party Plugins" can leak SKILL.md from ~/.claude/plugins. That is not an install. Proof is the ork plugin id plus the full skill catalog.

Codex

Codex uses its own plugin format, skill picker, and standalone role configuration. Add OrchestKit's Codex marketplace, then install the small portable workflow pack:

bash
codex plugin marketplace add yonatangross/orchestkit --ref main --sparse .agents/plugins --sparse plugins/ork-codexcodex plugin add ork-codex@orchestkit-codex

Restart Codex after installation. Invoke a workflow explicitly with $ork-brainstorm, $ork-explore, $ork-implement, $ork-assess, $ork-verify, or $ork-review-pr; their narrow descriptions also let Codex select the relevant workflow automatically.

The plugin intentionally ships roles as templates because Codex loads custom roles from ~/.codex/agents/, not from a plugin manifest. From an OrchestKit checkout, run this one-time, non-overwriting install:

bash
plugins/ork-codex/scripts/install-codex-roles.sh ~/.codex/agents

It installs ork_explorer, ork_implementer, ork_reviewer, and ork_verifier; restart Codex before spawning them.

Unattended runs: the ork-mech profile

For mechanical work (renames, bumps, codemods, sweeps that end in a diff), install the shipped profile and run codex exec against it:

bash
plugins/ork-codex/scripts/install-codex-profile.sh ~/.codexcodex exec --profile ork-mech "<task>" </dev/null

The profile is a FILE, not a snippet you paste into config.toml. Measured on codex-cli 0.153.4: --profile <name> layers $CODEX_HOME/<name>.config.toml over the base config, and a legacy [profiles.<name>] table left inside config.toml makes the same flag a hard config-load error. The installer refuses to run next to that table, and refuses to overwrite a profile you already have.

What it sets, as codex exec prints it in its own header:

approval: neversandbox: workspace-write [workdir, /tmp, $TMPDIR] (network access enabled)reasoning effort: high

It deliberately does not pin a model (pass -m) and does not use --dangerously-bypass-approvals-and-sandbox, which drops the sandbox entirely. Two contracts a TOML file cannot express, so they stay on the command line:

  • </dev/null. codex exec reads stdin even when a prompt argument is given. An inherited open pipe blocks the run with Reading additional input from stdin... and no timeout.

  • --add-dir inside a git worktree. The writable roots are [workdir, /tmp, $TMPDIR]. A linked worktree's git common dir sits outside the workdir, so the first commit dies on index.lock. Add it:

    bash
    codex exec --profile ork-mech \  --add-dir "$(git rev-parse --path-format=absolute --git-common-dir)" \  "<task>" </dev/null
Keeping the install current

ref main in the marketplace source is a cached snapshot, not a tracker. On the 2026-09-08 audit machine codex plugin list showed 10.0.0-beta.5 while main was three releases ahead. After an OrchestKit release, update and check:

bash
codex plugin updatecodex plugin list | grep ork-codex          # installed versionjq -r .version plugins/ork-codex/.codex-plugin/plugin.json   # what main ships
Documentation lookup (context7)

The plugin ships a context7 MCP server in its own manifest (mcpServers in .codex-plugin/plugin.json, defined in mcp.json), so installing the plugin registers it. Confirm with codex mcp get context7. It is scoped to the only two tools context7 exposes, resolve-library-id and query-docs, and it uses the hosted HTTP transport rather than an npx stdio child, so it costs no extra process per Codex session.

Export a key before starting Codex. The plugin references the variable name and never stores the value, so no token is written to ~/.codex/config.toml:

bash
export CONTEXT7_API_KEY_CODEX="<your-context7-api-key>"

Put that in your shell profile so every Codex session inherits it. Get the key from your own context7 account and keep the value out of the repository. If you store it in a secret manager, substitute your own vault and item names (with the 1Password CLI the reference is op://<vault>/<item>/credential), and cache the resolved value instead of re-reading the vault in every shell: each raw read is a separate unlock prompt.

Two behaviors worth knowing:

  • A server you already define yourself under [mcp_servers.context7] in ~/.codex/config.toml wins, and the plugin's definition is ignored entirely (including its tool scoping). That is intentional: your own configuration is never overridden. Remove your entry if you want the plugin's.
  • Without a valid key the server still connects and still lists its tools. Only a real call fails, with Invalid API key. A successful connection is therefore not proof of authentication.

pi

pi (0.85) reads the same SKILL.md format, and the repo now carries a pi manifest, so the package installs directly:

bash
pi install git:github.com/yonatangross/orchestkit

That registers every skill. Add -l to write .pi/settings.json in the project instead of your user settings. Pointing pi at a checkout still works and needs no install (pi --skill ./plugins/ork/skills).

The 29 skills marked disable-model-invocation stay reachable only as /skill:<name>. Two measured caveats: --no-builtin-tools hides every skill (pi lists skills only when a file-reading tool is enabled), and pi -p blocks on an open stdin, so headless runs need </dev/null.

MCP servers for pi come from .pi/mcp.json, then .mcp.json, then ~/.config/mcp/mcp.json. Copy the shipped template to get the recommended servers with a read-only includeTools allowlist per server:

bash
cp .pi/mcp.json.example .pi/mcp.json

Full detail and the tracking epic: OrchestKit on pi, Codex and Cursor.

Devin

bash
devin plugins install yonatangross/orchestkit

Devin checks a plugin root for a manifest in this order: .devin-plugin/plugin.json, then .claude-plugin/plugin.json, then root plugin.json (plugins reference). The repo root only had the last one, the Agent Plugins manifest, which fixes skills at a root skills/ directory this repo does not have, so a bare install used to list 0 of 107 skills, 0 hooks, and only the AGENTS.md rule (GH-4146). A root level .devin-plugin/plugin.json now maps skills to ./plugins/ork/skills, the same built tree Claude Code and Cursor already read.

devin plugins info ork lists 76 of 107 skills after that change (measured on Devin CLI 3000.10.27). The other 31, auto, verify, help, brainstorm, and similar router or workflow skills, declare a triggers: frontmatter key shaped as an object (keywords, examples, anti-triggers). Devin's own triggers field expects a flat [user, model] list, and the shape mismatch drops the whole skill instead of warning. Renaming that key touches three other readers (scripts/eval/eval-coverage.sh, tests/skills/triggering/test-trigger-keywords.sh, and the SKILL_ONLY allowlist in tests/plugins/test-command-frontmatter-passthrough.sh), so it stays tracked on GH-4146 instead of folded into this fix. Installing the subpath directly, devin plugins install yonatangross/orchestkit#plugins/ork, reaches the same 76 skills plus the plugin's 36 custom subagents, which neither path surfaces through devin plugins info. That subpath is what this repo's own .claude-plugin/marketplace.json already points Claude Code at.

OrchestKit's plugin hooks work under Claude Code only today; none of the 163 fire under Devin. Two reasons. Location: OrchestKit ships hooks at plugins/ork/hooks/hooks.json, while Devin's own plugin format reads a bare hooks.json at the plugin root instead. Shape and tool names: OrchestKit's file matches Claude Code tool names such as Bash and Write|Edit and expands ${CLAUDE_PLUGIN_ROOT} in command args, both Claude Code specific. Devin's own hooks.v1.json format matches its own tool names instead, exec, write, edit and friends (see lifecycle hooks), inside the same {matcher, hooks:[{type, command}]} event map shape. devin plugins info confirms Hooks (none) even once skills resolve. PreToolUse and PostToolUse read the closest to what OrchestKit's own pretool and posttool hooks already do, and are the first candidates for a future Devin hook manifest once the tool name mapping is written deliberately instead of guessed.

Pin a release instead of tracking main: release-please tags every release as v10.0.0-beta.N. The single argument devin plugins install <source> command has no ref pinning syntax of its own; pin through a requiredPlugins entry (in this repo's own .devin/config.json, or a personal, org, or enterprise manifest) instead:

json
{  "requiredPlugins": [    { "source": "github", "repo": "yonatangross/orchestkit", "ref": "v10.0.0-beta.30" }  ]}

Antigravity

bash
npx skills add yonatangross/orchestkit -s devops-deployment -s responsive-patterns -s architecture-decision-record -s ui-components -s rag-retrieval -s agent-orchestration -s brainstorm -s expect -s auto -s review-pr -s fix-issue -s commit

Antigravity (agy, Google's agentic CLI) reads Agent Skills from a workspace .agents/skills directory, so the shared skills.sh line above is the install path and Antigravity is already in that installer's universal target list (measured on agy 1.2.6; full evidence in docs/audits/agy-host-support-2026-09-18.md). Verify from the repo root with agy -p "/skills" --add-dir "$PWD": print mode only registers a workspace from an absolute --add-dir, while the interactive TUI takes the launch directory as the workspace and needs no flag.

Two honest gaps. npx skills add -g lands in ~/.agents/skills, which agy does not read; user scope lives at ~/.gemini/config/skills (or ~/.gemini/skills). And none of ork's 163 hooks port: agy's hooks.json uses its own event names and payload shape, and agy plugin validate plugins/ork reports hooks skipped because ork keeps them at hooks/hooks.json, not the plugin-root hooks.json agy looks for.

A fuller install exists but needs a local checkout: agy plugin validate <checkout>/plugins/ork reports skills: 108 processed, agents: 36 processed, and agy plugin install <checkout>/plugins/ork copies them into ~/.gemini/config/plugins/ork/ namespaced ork:<name>, which matches the /ork:<skill> spelling. Plugin-bundled mcp_config.json also works (marker-verified end to end), but a repo-level .mcp.json is never read.


FAQ

Plugin not found?
bash
/plugin list/plugin uninstall ork && /plugin install ork
Hooks not firing?

Run /ork:doctor to diagnose.

Claude Code version?

Requires ≥2.1.277 (supported floor; Opus 5 as the default Opus, Opus 5.5 from 2.1.280, xhigh effort, dynamic workflows, sandbox.network.strictAllowlist, native binary, hardened Bash(rm:*)/Bash(find:*) rules). Check with claude --version.

Raising this floor is a breaking change and ships as a major release. See STABILITY.md for the full contract, and shared/cc-support.json for the authoritative window.

Superpowers vs OrchestKit?

Complementary, not a rival listing. Superpowers (official Anthropic marketplace) is process: how the agent works a task. OrchestKit is production patterns plus lifecycle hooks. Honest split: docs · yonyon.ai.


Development

bash
npm run build      # Build plugins from src/npm test           # Run all tests

Edit src/ and manifests/, never plugins/ (generated).

See CONTRIBUTING.md for details.


What's New

v10.10.2 · 2026-11-07

  • docs: load PostHog only after consent (#5098)
  • docs: stamp and check the CLAUDE.md agents count line (#5102)
  • skills: one emulate port table, checked against upstream (#5100)
  • skills: fit review-pr, verify, auto descriptions and fix skill-fitness floor (#5096)
  • skills: skill quality round 3, fit descriptions and deterministic checklist (#5099)
  • …and 2 more (see CHANGELOG.md)

v10.10.1 · 2026-11-06

  • ci: let install-deps outlast a slow apt mirror (#5091)
  • docs-site: remove dead memory hooks and correct the hook count (#5085)
  • release: cap entries per dist tree request (#5088)
  • release: refuse an invalid dist entry cap
  • memory: remove the false scored-promotion story and dead hooks (#5089)

v10.10.0 · 2026-11-06

  • docs-site: upload source maps to PostHog at build time (#5082)
  • hooks: count every frontmatter hook handler (#5079)
  • release: drop stable description counts and give the scan fetch its own budget (#5081)

v10.9.1 · 2026-11-05

  • ci: pin ruff, and clear SIM102 in circuit-breaker (#5080)
  • docs-site: serve missing /lab pages as static HTML, not the app shell (#5075)
  • stamp the README hook counts from one source (#5076), closes #5067

v10.9.0 · 2026-11-05

  • release: sync plugins/ork to the orchestkit-plugin dist repo (#5070)

v10.8.6 · 2026-11-05

  • skills: Haiku 5.5 100K cost tiers and the AWS provider line (#5064)

v10.8.5 · 2026-11-04

  • plugin: pass validate --strict, add icon, disclose outbound calls (#5057)

v10.8.4 · 2026-11-04

  • hooks: cc-version-check keeps its flag unset on an env-only pass (#5061)
  • release: retry the CHANGELOG refresh push and fail loudly (#5059), closes #5054

See CHANGELOG.md for the full release history.


Community

Join the Building with AI community for AI dev tips, OrchestKit support, and connecting with other builders:

RoomWho it's forLink
Building with AIThe umbrella community. One join, every room below.Join
BuildersFor people already buildingJoin
OrchestKitFor OrchestKit usersJoin
AI for BusinessFor people leading AI adoptionJoin

Names and audiences match what yonyon.ai renders, so the two surfaces cannot drift. Every link resolves through yonyon.ai/go/*, so a rotated invite never needs a README change and no raw invite is published here.


OrchestKit family

  • Tower: a macOS menu bar app for people who run several AI coding subscriptions: usage per account, room left, when to switch. Also an MCP server (tower mcp).

Who builds this

OrchestKit is built and maintained by Yonatan Gross — Yonyon AI, an AI consulting practice. It is the toolkit extracted from real client work, not a side project: the patterns here are the ones that survived shipping.

It stays MIT and free. Nothing is gated, and none of the below changes that.

Working out where AI actually fits in your business? The AI readiness audit is a free assessment that maps your workflows and returns a prioritized report — the same diagnostic that opens a consulting engagement.

Want the toolkit running properly in your team? Setup, configuration, and a working agent loop tailored to your stack is something I do as a fixed-scope engagement. Start a discussion or reach out through the community.

Security policy and reporting: SECURITY.md.


Docs · Issues · Discussions · Community

MIT License · @yonatangross

來源:README.md,提交 caa5346

工具

2

orchestkit_docs_get

Fetch one OrchestKit documentation page as Markdown. Use after orchestkit_docs_search to read a page in full. Input: the page path (e.g. '/docs/getting-started/installation'). Returns the page Markdown.

輸入參數path必填

版本歷史

99
  1. v10.10.2Nov 7, 2026
  2. v10.9.0Nov 5, 2026
  3. v10.8.5Nov 4, 2026
  4. v10.8.2Nov 4, 2026
  5. v10.7.4Nov 4, 2026
  6. v10.7.3Nov 3, 2026
  7. v10.7.1Nov 3, 2026
  8. v10.6.0Nov 3, 2026
  9. v10.5.1Nov 1, 2026
  10. v10.4.3Nov 1, 2026
  11. v10.4.2Oct 31, 2026
  12. v10.4.1Oct 29, 2026
  13. v10.3.0Oct 26, 2026
  14. v10.2.2Oct 26, 2026
  15. v10.2.1Oct 26, 2026
  16. v10.2.0Oct 25, 2026
  17. v10.1.1Oct 25, 2026
  18. v10.1.0Oct 24, 2026
  19. v10.0.2Oct 23, 2026
  20. v10.0.1Oct 23, 2026
  21. v10.0.0Oct 22, 2026
  22. v10.0.0-beta.187Oct 22, 2026
  23. v10.0.0-beta.186Oct 22, 2026
  24. v10.0.0-beta.185Oct 21, 2026
  25. v10.0.0-beta.183Oct 19, 2026
  26. v10.0.0-beta.182Oct 17, 2026
  27. v10.0.0-beta.179Oct 17, 2026
  28. v10.0.0-beta.177Oct 16, 2026
  29. v10.0.0-beta.176Oct 16, 2026
  30. v10.0.0-beta.175Oct 15, 2026
  31. v10.0.0-beta.174Oct 15, 2026
  32. v10.0.0-beta.172Oct 13, 2026
  33. v10.0.0-beta.171Oct 11, 2026
  34. v10.0.0-beta.170Oct 10, 2026
  35. v10.0.0-beta.168Oct 10, 2026
  36. v10.0.0-beta.166Oct 9, 2026
  37. v10.0.0-beta.165Oct 8, 2026
  38. v10.0.0-beta.164Oct 7, 2026
  39. v10.0.0-beta.163Oct 7, 2026
  40. v10.0.0-beta.162Oct 7, 2026
  41. v10.0.0-beta.161Oct 6, 2026
  42. v10.0.0-beta.158Oct 6, 2026
  43. v10.0.0-beta.157Oct 5, 2026
  44. v10.0.0-beta.155Oct 5, 2026
  45. v10.0.0-beta.154Oct 4, 2026
  46. v10.0.0-beta.153Oct 4, 2026
  47. v10.0.0-beta.151Oct 4, 2026
  48. v10.0.0-beta.147Oct 3, 2026
  49. v10.0.0-beta.146Oct 2, 2026
  50. v10.0.0-beta.144Oct 2, 2026
  51. v10.0.0-beta.142Oct 2, 2026
  52. v10.0.0-beta.140Oct 1, 2026
  53. v10.0.0-beta.138Oct 1, 2026
  54. v10.0.0-beta.137Oct 1, 2026
  55. v10.0.0-beta.136Sep 30, 2026
  56. v10.0.0-beta.135Sep 29, 2026
  57. v10.0.0-beta.132Sep 29, 2026
  58. v10.0.0-beta.131Sep 29, 2026
  59. v10.0.0-beta.130Sep 28, 2026
  60. v10.0.0-beta.126Sep 28, 2026
  61. v10.0.0-beta.121Sep 28, 2026
  62. v10.0.0-beta.119Sep 27, 2026
  63. v10.0.0-beta.118Sep 27, 2026
  64. v10.0.0-beta.117Sep 27, 2026
  65. v10.0.0-beta.114Sep 26, 2026
  66. v10.0.0-beta.111Sep 26, 2026
  67. v10.0.0-beta.104Sep 26, 2026
  68. v10.0.0-beta.101Sep 26, 2026
  69. v10.0.0-beta.95Sep 25, 2026
  70. v10.0.0-beta.92Sep 25, 2026
  71. v10.0.0-beta.90Sep 25, 2026
  72. v10.0.0-beta.89Sep 24, 2026
  73. v10.0.0-beta.87Sep 24, 2026
  74. v10.0.0-beta.84Sep 23, 2026
  75. v10.0.0-beta.82Sep 23, 2026
  76. v10.0.0-beta.80Sep 23, 2026
  77. v10.0.0-beta.79Sep 23, 2026
  78. v10.0.0-beta.78Sep 22, 2026
  79. v10.0.0-beta.77Sep 22, 2026
  80. v10.0.0-beta.75Sep 22, 2026
  81. v10.0.0-beta.74Sep 22, 2026
  82. v10.0.0-beta.73Sep 21, 2026
  83. v10.0.0-beta.71Sep 21, 2026
  84. v10.0.0-beta.70Sep 21, 2026
  85. v10.0.0-beta.69Sep 20, 2026
  86. v10.0.0-beta.67Sep 20, 2026
  87. v10.0.0-beta.63Sep 20, 2026
  88. v10.0.0-beta.60Sep 19, 2026
  89. v10.0.0-beta.57Sep 19, 2026
  90. v10.0.0-beta.55Sep 19, 2026
  91. v10.0.0-beta.53Sep 18, 2026
  92. v10.0.0-beta.51Sep 18, 2026
  93. v10.0.0-beta.49Sep 18, 2026
  94. v10.0.0-beta.48Sep 18, 2026
  95. v10.0.0-beta.47Sep 17, 2026
  96. v10.0.0-beta.44Sep 17, 2026
  97. v10.0.0-beta.43Sep 16, 2026
  98. v10.0.0-beta.41Sep 16, 2026
  99. v10.0.0-beta.38Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分