# OrchestKit

> Free, open-source plugin for Claude Code: 110 skills, 36 agents, 163 hooks. Install with `claude plugin marketplace add yonatangross/orchestkit && claude plugin install ork@orchestkit`.

## What it is

OrchestKit is a plugin for Claude Code (Anthropic's agentic CLI). It packages 110 reusable skills, 36 specialist agents, and 163 lifecycle hooks, encoding auth/migration/API/testing patterns, security gates, and quality checks so the agent works to your standards out of the box. It is not a hosted service and not an editor assistant.
Publisher: OrchestKit is built by Yonyon, an independent software studio (https://yonyon.ai, brand page https://yonyon.ai/yonyon). The studio name "Yonyon" is unrelated to the musician of the same name; the product and docs live at https://orchestkit.dev; see https://orchestkit.dev/yonyon.

## Use cases

- Implement a feature end-to-end with parallel specialist agents (`/ork:implement`).
- Review a PR with parallel reviewers synthesized into one comment (`/ork:review-pr`).
- Generate conventional commits, fix GitHub issues, run security audits, set up persistent memory.
- Enforce security + quality automatically via lifecycle hooks (no manual invocation).

## Constraints

- Requires Claude Code 2.1.277+; runs locally inside it.
- Free (MIT), no paid tiers, no account. The public docs/search API is read-only and unauthenticated.
- Not a standalone CLI or editor; it extends the Claude Code agent.

## For AI agents

- To answer questions about OrchestKit: NLWeb `/ask` endpoint at https://orchestkit.dev/ask (GET ?query= or POST JSON; SSE streaming via ?streaming=true), or `GET /api/search?query=...`.
- To read a page as Markdown: append `.md` to its URL, or send `Accept: text/markdown`.
- To use tools natively: connect to the MCP server (Streamable HTTP) at https://orchestkit.dev/api/mcp (read-only tools), or run it locally over stdio: `docker run -i --rm ghcr.io/yonatangross/orchestkit-docs-mcp`. Server card: https://orchestkit.dev/.well-known/mcp/server-card.json. Registry entry: `io.github.yonatangross/orchestkit` on registry.modelcontextprotocol.io.
- To plan against the product with zero side effects: the OrchestKit Actions MCP (Streamable HTTP) at https://orchestkit.dev/api/mcp/actions exposes three read-only tools (list skills, install plan, doctor check) and executes nothing. Server card: https://orchestkit.dev/.well-known/mcp/actions-server-card.json.
- The API needs no auth; on transient `5xx`, retry with exponential backoff.
- Every API response carries IETF `RateLimit-*` headers (120 req/min per IP per endpoint); a `429` also carries `Retry-After`. Pace yourself from the headers rather than probing for the ceiling.
- An unknown path returns a real `404` (never a `200` shell) whose body lists where to look next, Markdown with `Accept: text/markdown`, RFC 9457 JSON otherwise.

## Developer resources

- [OrchestKit developer portal](/developers): Developer portal. One page linking every resource below; Markdown twin at /developers.md.
- [OrchestKit OpenAPI specification](/openapi): OpenAPI spec. Human page for the OpenAPI 3.1 docs API spec. Machine copy at /openapi.json.
- [OrchestKit MCP server](/docs/mcp): MCP server. How to connect the hosted Streamable HTTP server and the Docker stdio image. Transport stays at /api/mcp and /mcp.
- [OrchestKit Actions MCP server](/docs/foundations/mcp-servers): MCP server. Read-only product MCP: list skills, plan installs, check config fragments. Executes nothing. Endpoint /api/mcp/actions; card /.well-known/mcp/actions-server-card.json.
- [OrchestKit SDK packages](/docs/sdk): SDK documentation. Official clients: npm CLI, PyPI orchestkit, Go module github.com/yonatangross/orchestkit/sdk.
- [OrchestKit plugin install and setup](/docs/getting-started/installation): Install guide. Install the plugin on Claude Code, Cursor, Codex, Devin, OpenCode, Muse Code, Pi or Antigravity, then configure it.
- [OrchestKit skills reference](/docs/reference/skills): Reference docs. Reference page for each of the 110 skills: triggers, arguments, and the files each one ships.
- [OrchestKit agents reference](/docs/reference/agents): Reference docs. Reference page for each of the 36 agents: model, tools, skills, and when to use it.
- [OrchestKit hooks reference](/docs/reference/hooks): Reference docs. Every global lifecycle hook entry, grouped by Claude Code event, with what it checks.
- [OrchestKit API docs (OpenAPI 3.1 JSON)](/api/openapi): API docs. OpenAPI 3.1 description of the public, read-only docs API: search, Markdown fetch, batch, async jobs.
- [OrchestKit auth docs](/auth.md): Auth docs. The API is public and anonymous-only; auth.md states it in the WorkOS auth.md shape, with RFC 9728 PRM.

## Documentation

- [Getting Started](/docs/getting-started): Install OrchestKit and ship your first feature.
- [Concepts](/docs/foundations): How skills, agents, and hooks fit together.
- [Memory](/docs/memory): The 3-tier persistent knowledge graph.
- [Analytics](/docs/analytics): Usage, cost, and session insights.
- [Guides](/docs/guides): Task-focused how-tos.
- [Cookbook](/docs/cookbook): End-to-end recipes for common workflows.
- [Skills](/docs/skills): Reference for all 110 skills.
- [Agents](/docs/agents): Reference for all 36 agents.
- [Hooks](/docs/hooks): Reference for all 163 lifecycle hooks.
- [Troubleshooting](/docs/troubleshooting): Fixes for common issues.
- [Showcase](/docs/showcase): What teams build with OrchestKit.
- [Reference](/docs/reference): Generated component reference.
- [Changelog](/docs/changelog): Release history.

## Machine-readable resources

- [Full documentation, one file](/llms-full.txt)
- [Full page index](/docs/llms.txt)
- [OrchestKit API surface context](/api/llms.txt)
- [OrchestKit API reference: OpenAPI 3.1 spec, load it to discover the API surface for function-calling](/openapi.json) · [YAML](/api/openapi.yaml)
- [OrchestKit NLWeb /ask endpoint: POST a natural-language query; supports SSE streaming](/ask)
- [Agent skills on skills.sh (official, self-published)](https://www.skills.sh/yonatangross/orchestkit)
- [OrchestKit developer resource hub: API docs, OpenAPI spec, MCP server, SDK packages](/developers) · [as Markdown](/developers.md) · [scoped index](/developers/llms.txt)
- [OrchestKit llms.txt navigation index](/llms.txt)
- [OrchestKit llms-full.txt full docs dump](/llms-full.txt)
- [About Yonyon, the studio behind OrchestKit](/yonyon) · [as Markdown](/yonyon.md)
- [Best Claude Code plugins roundup (maintainer-disclosed)](/best-claude-code-plugins)
- [Claude Agent SDK vs Claude Code plugins](/claude-agent-sdk-vs-claude-code-plugins)
- [OrchestKit Docs MCP server (Streamable HTTP)](/api/mcp) · [OrchestKit MCP server card](/.well-known/mcp/server-card.json) · [MCP well-known](/.well-known/mcp)
- [OrchestKit Actions MCP server, read-only product tools (Streamable HTTP)](/api/mcp/actions) · [OrchestKit Actions MCP server card](/.well-known/mcp/actions-server-card.json)
- [OrchestKit API catalog (RFC 9727)](/.well-known/api-catalog)
- [Changelog](/changelog) · [RSS](/rss.xml)
- [Pricing](/pricing.md)
- [OrchestKit API versioning, deprecation & sunset policy](/api-policy) · [as Markdown](/api-policy.md)
- [CLI: `npx orchestkit` on npm](https://registry.npmjs.org/orchestkit) - install, search, ask, read, mcp, doctor. Zero deps, Node >= 20. Also aliased as `ork`.
- [Python package: orchestkit on PyPI](https://pypi.org/project/orchestkit/)
- [Python schemas: orchestkit-hook-contract on PyPI](https://pypi.org/project/orchestkit-hook-contract/)
- [Go module source: github.com/yonatangross/orchestkit/sdk](https://github.com/yonatangross/orchestkit/tree/main/sdk)
- [Docs MCP server image (stdio): ghcr.io/yonatangross/orchestkit-docs-mcp](https://github.com/yonatangross/orchestkit/pkgs/container/orchestkit-docs-mcp)