К основному содержанию
скилл CX Codex

configure · yonatangross — скилл для Claude Code: мастер настройки OrchestKit

Интерактивный мастер для настройки OrchestKit: подключение MCP-серверов, права хуков, горячие клавиши, пресеты. Запускается при первой установке плагина и по команде /orchestkit:configure.

MIT 196 установок ★ 305 обновлён 2026-11-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add yonatangross/orchestkit --skill configure -a claude-code
Открыть на GitHub

Что делает configure

Скилл предлагает выбрать один из пяти пресетов — от Complete (все скиллы, агенты и хуки) до Hooks-only (только хуки безопасности и продуктивности). После выбора пресета можно отключить отдельные категории скиллов (AI/ML, Backend, Frontend, Testing, Security, DevOps, Planning, Workflow), убрать ненужных агентов из 36 доступных и настроить хуки — три защитных (git-branch-protection, file-guard, redact-secrets) всегда включены, остальные переключаются.

Результат записывается в ~/.claude/plugins/orchestkit/config.json. Нужен Claude Code 2.1.277 или новее. После сохранения конфига скилл советует выполнить /reload-plugins, чтобы изменения вступили в силу. Мастер проходит максимум 11 шагов с одним вопросом на шаг.

Какие задачи решает

  • выбрать пресет OrchestKit под задачи проекта
  • включить или отключить категории скиллов и агентов
  • настроить права хуков безопасности и продуктивности
  • записать конфиг плагина после первой установки
  • обновить настройки OrchestKit без ручного редактирования JSON

Примеры запросов агенту

  • Запусти мастер настройки OrchestKit
  • Настрой пресет mcp memory
  • /orchestkit:configure

Как установить configure

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill configure -a claude-code

2Вручную: положить файлы

~/.claude/skills/configure/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/configure/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о configure

Как установить configure в Claude Code?

Выполни npx skills add yonatangross/orchestkit --skill configure -a claude-code, скилл окажется в ~/.claude/skills/configure/SKILL.md.

Что делает configure?

Проводит через интерактивный мастер настройки OrchestKit: выбор пресета, категорий скиллов, агентов и прав хуков. Результат сохраняется в config.json.

Какие пресеты доступны в configure?

Complete (всё), Standard (скиллы без агентов), Lite (28 базовых скиллов), Hooks-only (только хуки) и Monorepo (Complete с детекцией монорепо).

Исходный текст

SKILL.md · MIT
---
name: configure
license: MIT
compatibility: "Claude Code 2.1.277+."
description: "Interactive wizard for OrchestKit settings: MCP servers, hook permissions, keybindings, presets. Use when customizing plugin behavior."
argument-hint: "[preset-name]"
context: inherit
user-invocable: false
allowed-tools: "Bash Read Grep Glob Edit Write AskUserQuestion"
effort: low
model: haiku
metadata:
  category: workflow-automation
  version: "1.0.1"
  author: "OrchestKit"
  complexity: "low"
  tags: "configuration, setup, wizard, customization"
paths: [".claude/**", "**/.claude/**"]
---

# OrchestKit Configuration

Interactive setup for customizing your OrchestKit installation.

## Quick Start

```bash
configure
configure mcp memory
```

## Argument Resolution

```python
PRESET = "$ARGUMENTS[0]"   # Optional preset name or subcommand, e.g., "mcp"
TARGET = "$ARGUMENTS[1]"   # Optional target, e.g., "memory"
# If no arguments, run interactive wizard.
# $ARGUMENTS is the full string (CC 2.1.59 indexed access)
```

Done means `~/.claude/plugins/orchestkit/config.json` is written, the user saw the Step 11 preview, and `/reload-plugins` was advised.
Budget: at most one AskUserQuestion per step and 11 steps; stop and report at the finish line or the first cap, whichever comes first.

## Step 1: Choose Preset

Use AskUserQuestion:

| Preset | Skills | Agents | Hooks | Description |
|--------|--------|--------|-------|-------------|
| **Complete** | all | all | all | Everything |
| **Standard** | all | 0 | all | Skills, no agents |
| **Lite** | 28 | 0 | all | Essential only (testing, security, planning) |
| **Hooks-only** | 0 | 0 | all | Safety, productivity and team coordination hooks |
| **Monorepo** | all | all | all | Complete + monorepo detection |

Live counts: run `claude plugin details ork` (107 skills, 36 agents on 2026-09-25).

## Step 2: Customize Skill Categories

Categories available:
- AI/ML (28 skills)
- Backend (16 skills)
- Frontend (9 skills)
- Testing (14 skills)
- Security (7 skills)
- DevOps (5 skills)
- Planning (7 skills)
- Workflow (5 skills)

## Step 3: Customize Agents

**Product Agents (2):**
- market-intelligence
- product-strategist

**Technical Agents (17):**
- backend-system-architect
- frontend-ui-developer
- database-engineer
- llm-integrator
- workflow-architect
- data-pipeline-engineer
- test-generator
- code-quality-reviewer
- security-auditor
- security-layer-auditor
- debug-investigator
- system-design-reviewer
- python-performance-engineer
- frontend-performance-engineer
- monitoring-engineer
- event-driven-architect
- infrastructure-architect

**Operations Agents (6):**
- ci-cd-engineer
- deployment-manager
- git-operations-engineer
- release-engineer
- ai-safety-auditor
- multimodal-specialist

**Research Agents (4):**
- web-research-analyst
- market-intelligence
- design-system-architect
- demo-producer

## Step 4: Configure Hooks

**Safety (Always On):**
- operator `permissions.deny` rules (written by `/ork:setup`, enforced by Claude Code)
- network egress guard (DENY tier, inside the Bash dispatcher)
- secret handler (PostToolUse output scan; logs only by default, `ORK_SECRET_HOOK=REDACT` to redact)

**Toggleable Hooks:**
- Productivity (auto-approve, logging)
- Quality Gates (coverage, patterns)
- Team Coordination (locks, conflicts)
- Notifications (desktop, sound)

> **CC 2.1.49 Managed Settings:** OrchestKit ships plugin `settings.json` with default hook permissions. These are *managed defaults* — users can override them in project or user settings. Enterprise admins can lock managed settings via managed profiles.

> **CC 2.1.111 — prune overbroad Bash permissions:** Since 2.1.111, read-only Bash commands with glob patterns (`ls:*`, `head:*`, `grep:*`, `wc:*`, `find:*`, etc.) no longer trigger permission prompts by default. If your `.claude/settings.local.json` has explicit `Bash(ls:*)` / `Bash(grep:*)` style allows added to silence old prompts, they are now redundant. The built-in `/less-permission-prompts` skill scans your transcripts and proposes a prune diff — run it once per project and once per user profile, then commit the accepted subset. The committed OrchestKit `src/settings/ork.settings.json` is already minimal (allow = `Read`, `Glob`, `Grep`, a small set of MCP entries) and doesn't need changes.

> **CC 2.1.129 — `Bash(mkdir *)` / `Bash(touch *)` allow rules now work for in-project paths:** previously silently rejected for project-relative paths; now honored as documented. Workaround entries enumerating explicit subpaths (`Bash(mkdir:./src/*)`, etc.) can be collapsed back to the canonical glob form. See `references/cc-version-settings.md` § CC 2.1.129.

> **CC 2.1.157 — plugin auto-load + workflow-trigger control:** Plugins in `.claude/skills` auto-load (no marketplace required); `claude plugin init <name>` scaffolds one there. The "Workflow keyword trigger" toggle in `/config` — and pressing backspace right after the keyword — stops a bare "workflow"/"ultracode" from launching a dynamic workflow. `claude agents` honors the `agent` field in `settings.json`, with `--agent <name>` to override.

> **CC 2.1.160 — write prompts for startup files & build configs:** Expect approval prompts before Claude writes shell startup files (`.zshenv`/`.zlogin`/`.bash_login`, `~/.config/git/`) or — in `acceptEdits` mode — build-tool configs that grant code execution (`.npmrc`, `bunfig.toml`, `.bazelrc`, `.pre-commit-config.yaml`, `.devcontainer/`). These are security defaults; approve them deliberately, don't pre-allow.

> **CC 2.1.141 — `ANTHROPIC_WORKSPACE_ID` for workload identity federation:** When authenticating headless/CI agents (e.g. `ci-sentinel`, `bare-eval`) through Anthropic's WIF flow, set `ANTHROPIC_WORKSPACE_ID` to scope the minted token to one workspace when the federation rule covers more than one. Without it, a multi-workspace rule mints an unscoped token.

> **CC 2.1.142 — `MCP_TOOL_TIMEOUT` for remote MCP:** the per-request timeout now actually applies to remote **HTTP/SSE** MCP servers (previously capped at 60s regardless of the configured value). Raise it (e.g. `MCP_TOOL_TIMEOUT=180000`) for long-poll tools — NotebookLM `studio_status`, knowledge-base ingest, index rebuilds — that legitimately run past 60s, so they don't silently time out and self-skip.

> **CC 2.1.169 — safe-mode + policy-enforcement fixes:** `--safe-mode` (or `CLAUDE_CODE_SAFE_MODE=1`) starts CC with ALL customizations disabled — CLAUDE.md, plugins, skills, hooks, MCP servers — the fastest way to bisect "is ork (or any plugin) causing this?" before filing a bug. Enterprise managed MCP policies (`allowedMcpServers`/`deniedMcpServers`) are now enforced on reconnect, IDE-typed configs, `--mcp-config` servers in the first post-install session, and before remote settings load — if your org sets them, previously-working unlisted servers may now be (correctly) blocked. Untrusted project settings can no longer set OTEL client-certificate paths without trust confirmation. Self-hosted runners get a `post-session` lifecycle hook (after session end, before workspace deletion) for snapshotting uncommitted work or exporting logs, plus a configurable SIGTERM→SIGKILL window (default 5s).

> **CC 2.1.166 — `fallbackModel` setting (up to 3 models):** the `fallbackModel` setting now accepts up to three models, tried in order when the primary is overloaded or unavailable, and `--fallback-model` now also applies to **interactive** sessions (not just headless). Set it for long `ork:implement` / `ork:brainstorm` runs so an overloaded primary degrades to the next model instead of stalling the run. Extends the 2.1.152 fallback note in `references/cc-version-settings.md`.

> **CC 2.1.181 — `/config key=value` for one-off settings:** set any single setting straight from the prompt — `/config thinking=false`, `/config model=opus` — without opening the `/config` menu or hand-editing a settings file. Works in interactive, `-p`, and Remote Control. This is the fast path for a **one-off, ad-hoc** setting change. It does **not** replace durable automation: a "whenever X, do Y" behavior still requires a **hook in `settings.json`** (the harness executes hooks; `/config` only writes a setting value). Use `/config key=value` to flip a setting now; use this skill's hook flow when the change must fire automatically every session. See `references/cc-version-settings.md` § CC 2.1.181.

## Step 5: Configure MCPs (Optional)

All 4 MCPs ship **enabled by default**. Tavily requires an API key.

| MCP | Purpose | Default | Requires |
|-----|---------|---------|----------|
| context7 | Library documentation | enabled | Nothing |
| memory | Cross-session persistence | enabled | Nothing |
| sequential-thinking | Structured reasoning for subagents | enabled | Nothing |
| tavily | Web search + extraction | enabled | API key (free tier: app.tavily.com) |

> **Why enabled?** OrchestKit ships 30+ Sonnet/Haiku subagents. Opus 5.5, Sonnet 5 and Haiku 5.5 think natively (adaptive thinking is on by default), so sequential-thinking is most useful for a subagent pinned to an older model such as Haiku 4.5, which needs an explicit `budget_tokens`. Where `haiku` still resolves to Haiku 4.5 (CC below 2.1.293, Bedrock, Vertex, Foundry, Claude Platform on AWS), that means every `model: haiku` subagent. Tavily is used by specific agents (see `mcpServers` in agent frontmatter). CC's MCPSearch auto-defers schemas when overhead exceeds 10% of context, so token cost is managed automatically.

> **Background agents:** MCP tools are NOT available in background subagents (hard CC platform limitation). Agents that need MCP tools must run in the foreground.

**Already have these MCPs installed globally?** If Tavily or memory are already in your `~/.claude/mcp.json`, skip enabling them here to avoid duplicate entries. OrchestKit agents will use whichever instance Claude Code resolves first.

**Opt out of claude.ai MCP servers (CC 2.1.63+):** Claude Code may load MCP servers from claude.ai by default. To disable this and only use locally-configured MCPs:

```bash
export ENABLE_CLAUDEAI_MCP_SERVERS=false
```

Add to your shell profile (`~/.zshrc` or `~/.bashrc`) to persist across sessions. This only affects MCP servers sourced from claude.ai — locally-configured MCPs in `.mcp.json` and `~/.claude/mcp.json` are unaffected.

## Steps 6-9: CC Version-Specific Settings

Load details: `Read("references/cc-version-settings.md")` for full configuration options.

Covers CC 2.1.7 (MCP deferral threshold, effective context window), CC 2.1.20 (task deletion, PR enrichment, agent permissions, monorepo detection, team distribution), CC 2.1.23 (spinner verbs customization), and CC 2.1.79 (turn duration display).

### CC 2.1.119: `prUrlTemplate` (M122)

For enterprise GitLab / GitHub Enterprise / Bitbucket installations with non-standard URL shapes, set `prUrlTemplate` in `~/.claude/settings.json` (or project-level) to override URL construction in `review-pr` / `create-pr` / `fix-issue`:

```json
{
  "prUrlTemplate": "https://gitlab.acme.com/{owner}/{repo}/-/merge_requests/{n}"
}
```

Tokens: `{host}`, `{owner}`, `{repo}`, `{n}`. See `src/skills/chain-patterns/references/pr-from-platform.md` for the full host-family table and skill-side branching pattern.

## Step 10: Webhook & Telemetry Configuration

Configure streaming of session events to HQ or your own API. There is one channel: the HMAC-signed `http-sink` (batched, retry with backoff, circuit breaker). It activates when `webhookUrl` is set in `.claude/orchestration/config.json` AND `ORCHESTKIT_HOOK_TOKEN` is exported in the launching shell. The per-event native HTTP hook generator (channel 1) was deleted in #3867; nothing writes `type: "http"` entries into `settings.local.json`.

```python
AskUserQuestion(questions=[{
  "question": "Set up session telemetry?",
  "header": "Telemetry",
  "options": [
    {"label": "Stream to a webhook", "description": "Analytics events and SessionEnd summaries POST to your endpoint via the HMAC-signed http-sink"},
    {"label": "Skip", "description": "No telemetry, hooks run locally only"}
  ],
  "multiSelect": false
}])
```

### If "Stream to a webhook"

1. Ask for the webhook URL in plain text. AskUserQuestion needs at least 2 options (CC schema `minItems: 2`) and cannot capture a free-form URL, so prompt directly:

   > What is your webhook endpoint URL? Reply with the full URL (e.g., `https://api.example.com/hooks`).

2. Save webhookUrl to orchestration config:
```bash
# File: .claude/orchestration/config.json
saveConfig({ webhookUrl: "<webhook-url>" })
```

3. Remind the user to set the auth token:
```
Set ORCHESTKIT_HOOK_TOKEN in your environment (never in config files):
  export ORCHESTKIT_HOOK_TOKEN=your-secret
```

Load `Read("references/http-hooks.md")` for the channel history and the CC URL-validation constraint.

## Step 11: Preview & Save

> **Tip (CC 2.1.69+):** After saving configuration changes, run `/reload-plugins` to activate them without restarting your session.
>
> **Tip (CC 2.1.152+):** If you edited or added **skills** in a skill directory (personal `~/.claude/skills/` or project `.claude/skills/` — not plugin-packaged ones), run `/reload-skills` to re-scan and pick them up in the same session. A `SessionStart` hook can do the same by returning `reloadSkills: true`.

Save to: `~/.claude/plugins/orchestkit/config.json`

```json
{
  "version": "1.0.0",
  "preset": "complete",
  "skills": { "ai_ml": true, "backend": true, ... },
  "agents": { "product": true, "technical": true },
  "hooks": { "safety": true, "productivity": true, ... },
  "mcps": { "context7": false, ... }
}
```

## Operator-Scope Settings

Some controls cannot ship in the plugin at all. A plugin's bundled `settings.json` supplies only `agent` and `subagentStatusLine`; everything else is silently stripped, so `sandbox`, `permissions.deny` and friends are real only in the operator's own `~/.claude/settings.json`. ork once declared a full `sandbox` block anyway (deleted in a93ccb735, #3357). It was inert for its whole life.

`ork:doctor` Check 16 detects the absence. The paste-ready JSON lives here:

```bash
Read("references/operator-scope-settings.md")
```

That reference stages the rollout per #3424 rather than handing over one all-or-nothing block:

| Stage | Contents | Adopt when |
|-------|----------|------------|
| **1 LOOSE** | `sandbox.enabled`, the 19-host exfil denylist, credential file and env denies, `excludedCommands` carve-outs for `op *` / `docker *` / `ssh *` (wildcard form — bare names match only the arg-less command), no network allowlist | first, on a working machine |
| **2 STRICT** | adds `network.allowedDomains` with `strictAllowlist: true` | only after stage 1 has held for several days |

**Start with stage 1.** Stage 2 denies every unlisted host with no prompt and will break `api.github.com`, localhost dev URLs, and telemetry ingest first. The reference spells out the expected breakage order and the per-line rollback.

This skill never writes an operator settings file. Enabling the sandbox is the operator's decision, and the rollback is deleting one key.

## VSCode: Remote Control (CC 2.1.79+)

VSCode users can run `/remote-control` to bridge their terminal session to `claude.ai/code`. This lets you continue the same session from a browser or phone — useful for monitoring long-running configurations or agent tasks away from your desk.

## Related Skills
- `ork:doctor`: Diagnose configuration issues
## References

Load on demand with `Read("references/<file>")`:
| File | Content |
|------|---------|
| `references/presets.md` | Preset definitions |
| `references/mcp-config.md` | MCP configuration |
| `references/http-hooks.md` | CC 2.1.63+ observability hooks (Langfuse, Datadog, custom endpoints) |
| `references/operator-scope-settings.md` | Staged `sandbox` + `permissions.deny` JSON for `~/.claude/settings.json` (#3424) |
| `references/cc-version-settings.md` | CC 2.1.7, 2.1.20, 2.1.23, 2.1.79 version-specific settings |

© OrchestKit · MIT · yonatangross/orchestkit

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — configure от других авторов.

configure официальный anthropics Скилл configure для Claude Code сохраняет токен Telegram-бота и проверяет политику доступа. Настраивает канал и контролирует подключения. CX Codex +1 3 861установок configure официальный anthropics Скилл configure для Claude Code проверяет подключение iMessage и настраивает список разрешённых контактов — фиксирует недоступность чата и ограничивает доступ к переписке. CX Codex +1 3 861установок configure официальный anthropics Скилл configure настраивает подключение Claude Code к Discord, сохраняет токен бота и помогает выстроить белый список доступа. CX Codex +1 3 861установок configure bitwize-music-studio Скилл configure для Claude Code интерактивно создаёт и редактирует ~/.bitwize-music/config.yaml для музыкальных плагинов bitwize-music. CX Codex +1 247установок configure Rich627 Скилл configure настраивает подключение WhatsApp-канала к агенту через связку устройств Baileys или официальный Cloud API прямо в терминале. CX Codex +1 ★ 127звёзд репо configure-ecc affaan-m Скилл configure-ecc для Claude Code, Codex, Cursor и других платформ запускает мастер настройки ECC прямо в редакторе. CX Codex +1 6 500установок cli-setup cheaper-inference Скилл cli-setup для Claude Code управляет настройкой CLI Omniroute: запускает первичную настройку, меняет конфигурацию и переменные среды. Также он проверяет обновления и настраивает автозапуск. CX Codex +1 1 600установок setup-api-key calesthio Скилл setup-api-key автоматически проверяет, настроен ли ключ ElevenLabs, и проводит пользователя через получение и сохранение нового ключа, если его нет или он не работает. CX Codex +1 1 200установок absolute-init dhruvjainin Скилл absolute-init для Claude Code настраивает absolute под проект и предпочтения разработчика. Запускается по запросу «настрой absolute» или при первом использовании absolute в репозитории. CX Codex +1 160установок task-observer Eoghan Henn and contributors Скилл task-observer для Claude Code и ещё пяти платформ фиксирует паттерны и правки прямо во время работы. Превращает накопленный журнал наблюдений в обновления инструкций или новые навыки. CX Codex +1 19 300установок qwenchance thananon Скилл qwenchance помогает на длинных многоэтапных задачах: ловит повторяющиеся шаги, останавливает бесконечный перебор вариантов и следит за лимитом контекста. Срабатывает, когда модель зависает в кругах или контекст вот-вот кончится. CX Codex +1 2 600установок

Из того же набора86

Весь набор →
create-pr Скилл create-pr создаёт pull request в GitHub после прогона тестов, линтера, типов и проверки безопасности. Срабатывает по явному вызову, обычная команда gh pr create остаётся командой. CX Codex +1 209установок audit-full Скилл audit-full проверяет весь код проекта за один проход: ищет проблемы безопасности, архитектуры и зависимостей, сортируя находки по серьёзности. Запускается перед релизом или проверкой безопасности. CX Codex +1 208установок implement Скилл implement собирает новую фичу параллельно: бэкенд, фронтенд, тесты и проверка безопасности в отдельных воркдеревьях. CX Codex +1 206установок demo-producer Скилл demo-producer для Claude Code автоматизирует создание демонстрационных и промо-видео по коду, CLI и плагинам. Запускает связку из VHS и Remotion для подготовки роликов в разных форматах. CX Codex +1 196установок async-jobs Скилл async-jobs для Claude Code содержит правила и шаблоны для настройки очередей задач, повторов и воркфлоу в Celery, ARQ, Redis и Temporal. CX Codex +1 195установок product-frameworks Скилл product-frameworks для Claude Code даёт фреймворки для финансового анализа, приоритизации, метрик и исследований. С его помощью оформляют бизнес-кейсы, PRD и планы пользовательских исследований. CX Codex +1 194установок golden-dataset Скилл golden-dataset для Claude Code описывает жизненный цикл эталонных датасетов: курацию, девятифазное добавление, регрессионные тесты и интеграцию с Langfuse. CX Codex +1 193установок mcp-patterns Скилл mcp-patterns для Claude Code и Codex помогает проектировать серверы Model Context Protocol. Включается при настройке транспортов, авторизации через OAuth, кэшировании ресурсов и защите от инъекций. CX Codex +1 191установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой