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

setup-caliber — скилл для Claude Code: установка Caliber

Скилл setup-caliber доводит проект до рабочего Caliber: ставит CLI, включает синхронизацию конфигов агентов на коммите и создаёт недостающие файлы.

MIT ★ 1 319 обновлён 2026-09-24

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

Что делает setup-caliber

Скилл идёт по шагам и трогает только то, что ещё не настроено. Сначала проверяет, есть ли в системе caliber; если нет — ставит глобально через npm install -g @rely-ai/caliber. Не хватило прав на npm, и он переходит на npx, тогда каждый вызов становится дольше. Без Node.js 20 или новее установка обрывается на этом шаге.

Дальше вешается pre-commit-хук (caliber hooks --install): CLAUDE.md, правила Cursor и инструкции Copilot обновляются на каждом коммите. Затем скилл ищет каталоги .claude, .cursor, .agents, файлы AGENTS.md и .github/copilot-instructions.md. Если конфигов нет, они генерируются командой caliber init --auto-approve --agent <comma-separated-agents>. Оценку свежести даёт caliber score --json --quiet; ниже 80 скилл предложит caliber refresh.

Последний вопрос — для себя или для команды. В командном варианте появляется GitHub Action .github/workflows/caliber-sync.yml с синхронизацией по расписанию и на каждый PR, плюс секрет провайдера: ANTHROPIC_API_KEY, OPENAI_API_KEY либо VERTEX_PROJECT_ID и GOOGLE_APPLICATION_CREDENTIALS. Ключ кладут через gh secret set или вручную в настройках репозитория; без него workflow не отработает.

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

  • поставить Caliber и не споткнуться о версию Node.js
  • включить автосинхронизацию CLAUDE.md на каждом коммите
  • сгенерировать конфиги для Claude Code, Cursor и Copilot по найденным каталогам
  • проверить свежесть конфигов и обновить устаревшие
  • добавить в репозиторий синхронизацию конфигов по расписанию

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

  • Запусти /setup-caliber и поставь Caliber с pre-commit-хуком.
  • Прогони /setup-caliber ещё раз: npx не сработал, нужен глобальный caliber.
  • Вызови /setup-caliber для команды и добавь GitHub Action синхронизации конфигов.

Как установить setup-caliber

1Через Skills CLI (Vercel)

npx skills add caliber-ai-org/ai-setup --skill setup-caliber -a claude-code

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

~/.claude/skills/setup-caliber/SKILL.md

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

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

Вопросы о setup-caliber

Как установить setup-caliber в Claude Code?

Выполните npx skills add caliber-ai-org/ai-setup --skill setup-caliber -a claude-code; файл скилла окажется по пути ~/.claude/skills/setup-caliber/SKILL.md.

Что делает setup-caliber?

Проверяет наличие Caliber, вешает pre-commit-хук для синхронизации конфигов и генерирует файлы для агентов, если их в проекте нет.

Что нужно для работы скилла?

Node.js 20 или новее. Если его нет, скилл останавливается на первом шаге и просит поставить Node, а потом запустить /setup-caliber снова.

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

SKILL.md · MIT
---
name: setup-caliber
description: Sets up Caliber for automatic AI agent context sync. Installs pre-commit hooks so CLAUDE.md, Cursor rules, and Copilot instructions update automatically on every commit. Use when Caliber hooks are not yet installed or when the user asks about keeping agent configs in sync.
---

# Setup Caliber

Dynamic onboarding for Caliber — automatic AI agent context sync.
Run all diagnostic steps below on every invocation to determine what's already
set up and what still needs to be done.

## Instructions

Run these checks in order. For each step, check the current state first,
then only act if something is missing.

### Step 1: Check if Caliber is installed

```bash
command -v caliber >/dev/null 2>&1 && caliber --version || echo "NOT_INSTALLED"
```

- If a version prints → Caliber is installed globally. Set `CALIBER="caliber"` and move to Step 2.
- If NOT_INSTALLED → Install it globally (faster for daily use since the pre-commit hook runs on every commit):
  ```bash
  npm install -g @rely-ai/caliber
  ```
  Set `CALIBER="caliber"`.

  If npm fails (permissions, no sudo, etc.), fall back to npx:
  ```bash
  npx @rely-ai/caliber --version 2>/dev/null || echo "NO_NODE"
  ```
  - If npx works → Set `CALIBER="npx @rely-ai/caliber"`. This works but adds ~500ms per invocation.
  - If NO_NODE → Tell the user: "Caliber requires Node.js >= 20. Install Node first, then run /setup-caliber again." Stop here.

### Step 2: Check if pre-commit hook is installed

```bash
grep -q "caliber" .git/hooks/pre-commit 2>/dev/null && echo "HOOK_ACTIVE" || echo "NO_HOOK"
```

- If HOOK_ACTIVE → Tell the user: "Pre-commit hook is active — configs sync on every commit." Move to Step 3.
- If NO_HOOK → Tell the user: "I'll install the pre-commit hook so your agent configs sync automatically on every commit."
  ```bash
  $CALIBER hooks --install
  ```

### Step 3: Detect agents and check if configs exist

First, detect which coding agents are configured in this project:
```bash
AGENTS=""
[ -d .claude ] && AGENTS="claude"
[ -d .cursor ] && AGENTS="${AGENTS:+$AGENTS,}cursor"
[ -d .agents ] || [ -f AGENTS.md ] && AGENTS="${AGENTS:+$AGENTS,}codex"
[ -f .github/copilot-instructions.md ] && AGENTS="${AGENTS:+$AGENTS,}github-copilot"
echo "DETECTED_AGENTS=${AGENTS:-none}"
```

If no agents are detected, ask the user which coding agents they use (Claude Code, Cursor, Codex, GitHub Copilot).
Build the agent list from their answer as a comma-separated string (e.g. "claude,cursor").

Then check if agent configs exist:
```bash
echo "CLAUDE_MD=$([ -f CLAUDE.md ] && echo exists || echo missing)"
echo "CURSOR_RULES=$([ -d .cursor/rules ] && ls .cursor/rules/*.mdc 2>/dev/null | wc -l | tr -d ' ' || echo 0)"
echo "AGENTS_MD=$([ -f AGENTS.md ] && echo exists || echo missing)"
echo "COPILOT=$([ -f .github/copilot-instructions.md ] && echo exists || echo missing)"
```

- If configs exist for the detected agents → Tell the user which configs are present. Move to Step 4.
- If configs are missing → Tell the user: "No agent configs found. I'll generate them now."
  Use the detected or user-selected agent list:
  ```bash
  $CALIBER init --auto-approve --agent <comma-separated-agents>
  ```
  For example: `$CALIBER init --auto-approve --agent claude,cursor`
  This generates CLAUDE.md, Cursor rules, AGENTS.md, skills, and sync infrastructure for the specified agents.

### Step 4: Check if configs are fresh

```bash
$CALIBER score --json --quiet 2>/dev/null | head -1
```

- If score is 80+ → Tell the user: "Your configs are in good shape (score: X/100)."
- If score is below 80 → Tell the user: "Your configs could be improved (score: X/100). Want me to run a refresh?"
  If yes:
  ```bash
  $CALIBER refresh
  ```

### Step 5: Ask about team setup

Ask the user: "Are you setting up for yourself only, or for your team too?"

- If **solo** → Continue with solo setup:

  Check if session learning is enabled:
  ```bash
  $CALIBER learn status 2>/dev/null | head -3
  ```
  - If learning is already enabled → note it in the summary.
  - If not enabled → ask the user: "Caliber can learn from your coding sessions — when you correct a mistake or fix a pattern, it remembers for next time. Enable session learning?"
    If yes:
    ```bash
    $CALIBER learn install
    ```

  Then tell the user:
  "You're all set! Here's what happens next:
  - Every time you commit, Caliber syncs your agent configs automatically
  - Your CLAUDE.md, Cursor rules, and AGENTS.md stay current with your code
  - Run `$CALIBER skills` anytime to discover community skills for your stack"

  Then show the summary (see below) and stop.

- If **team** → Check if the GitHub Action already exists:
  ```bash
  [ -f .github/workflows/caliber-sync.yml ] && echo "ACTION_EXISTS" || echo "NO_ACTION"
  ```
  - If ACTION_EXISTS → Tell the user: "GitHub Action is already configured."
  - If NO_ACTION → Tell the user: "I'll create a GitHub Action that syncs configs nightly and on every PR."
    Write this file to `.github/workflows/caliber-sync.yml`:
    ```yaml
    name: Caliber Sync
    on:
      schedule:
        - cron: '0 3 * * 1-5'
      pull_request:
        types: [opened, synchronize]
      workflow_dispatch:
    jobs:
      sync:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v4
          - uses: caliber-ai-org/ai-setup@v1
            with:
              mode: sync
              auto-refresh: true
              comment: true
              github-token: ${{ secrets.GITHUB_TOKEN }}
            env:
              ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
    ```
    Now determine which LLM provider the team uses. Check the local Caliber config:
    ```bash
    $CALIBER config --show 2>/dev/null || echo "NO_CONFIG"
    ```

    Based on the provider, the GitHub Action needs the corresponding secret:
    - **anthropic** → `ANTHROPIC_API_KEY`
    - **openai** → `OPENAI_API_KEY`
    - **vertex** → `VERTEX_PROJECT_ID` and `GOOGLE_APPLICATION_CREDENTIALS` (service account JSON)

    Update the workflow env block to match the provider. For example, if using OpenAI:
    ```yaml
            env:
              OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
    ```

    Then check if the `gh` CLI is available to set the secret:
    ```bash
    command -v gh >/dev/null 2>&1 && echo "GH_AVAILABLE" || echo "NO_GH"
    ```

    - If GH_AVAILABLE → Ask the user for their API key and set it:
      ```bash
      gh secret set ANTHROPIC_API_KEY
      ```
      (This prompts for the value securely via stdin)
    - If NO_GH → Tell the user exactly what to do:
      "Go to your repo on GitHub → Settings → Secrets and variables → Actions → New repository secret.
       Name: ANTHROPIC_API_KEY (or OPENAI_API_KEY depending on provider)
       Value: your API key"

    Finally, offer to commit and push the workflow file:
    ```bash
    git add .github/workflows/caliber-sync.yml
    git commit -m "feat: add Caliber sync GitHub Action"
    git push
    ```

### Summary

After completing all steps, show the user what's configured:

```
Caliber Setup Complete:
✓ Caliber installed (vX.X.X)
✓ Pre-commit hook — configs sync on every commit
✓ Agent configs — CLAUDE.md, Cursor rules, AGENTS.md
✓ Config score: X/100
✓ GitHub Action — nightly sync + PR checks (team only)

From now on, every commit keeps all your agent configs in sync automatically.
```

## When to trigger

- When a developer first opens this project
- When the user asks about keeping agent configs up to date
- When the user asks "how do I set up Caliber" or "what is Caliber"
- When the user sees a message saying "Run /setup-caliber to get set up"

## When NOT to trigger

- The user is in the middle of time-sensitive work

© caliber-ai-org · MIT · caliber-ai-org/ai-setup

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
setup-formatting davila7 Команда setup-formatting для Claude Code настраивает форматирование кода в проекте под единый стиль. Пригодится при подключении Prettier, Black или rustfmt вместе с git-хуками. CX Codex +1 370установок precommit-setup athola Скилл precommit-setup настраивает трёхуровневую систему pre-commit хуков: линтинг, проверку типов и тесты перед каждым коммитом. CX Codex +1 1установок block-no-verify-hook cskwork Скилл block-no-verify-hook для Claude Code, Codex и Cursor добавляет PreToolUse-хук, который перехватывает Bash-вызовы с флагами --no-verify и --no-gpg-sign до их выполнения. CX Codex +1 6 500установок code-formatter-installer patricio0312rev Скилл code-formatter-installer ставит Prettier, ESLint, EditorConfig и git-хуки в проект и доводит настройку до CI, чтобы команда не спорила о форматировании. CX Codex +1 278установок health tw93 Скилл health для Claude Code проверяет настройки ИИ-агента и поддерживаемость проекта с помощью ИИ. Запускается по запросу проверить конфигурацию, правила, хуки или MCP. CX Codex +1 16 500установок karpathy-coder claude-code-skills Скилл karpathy-coder для Claude Code проверяет код по четырём принципам Карпати: явные допущения, простота, точечные изменения и проверяемые цели. Запускается при ревью диффа, оценке сложности и подготовке коммита. CX Codex +1 1 053установок

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

Весь набор →
llm-patterns Правило llm-patterns задаёт соглашения для LLM-провайдеров в коде проекта. Оно пригодится при работе с моделями, конфигурацией, потоками и ошибками CLI. CX Codex +1 ★ 1 319звёзд репо caliber-pre-commit Правило caliber-pre-commit на каждый коммит: проверяет хук Caliber и, если хука нет, синхронизирует конфиги агентов и добавляет их в индекс. CX Codex +1 ★ 1 319звёзд репо find-skills Скилл find-skills ищет готовые скиллы сообщества через реестр Caliber и подключает их прямо во время диалога с агентом. CX Codex +1 ★ 1 319звёзд репо save-learning Скилл save-learning сохраняет правила и предпочтения пользователя для следующих сессий проекта. Он пригодится, когда вы хотите, чтобы агент помнил договорённости между запусками. CX Codex +1 ★ 1 319звёзд репо adding-a-command Скилл adding-a-command создаёт новые CLI-команды на Commander.js в src/commands/, подключает их к src/cli.ts и настраивает сбор телеметрии. CX Codex +1 ★ 1 319звёзд репо llm-provider Скилл llm-provider для Claude Code помогает добавить в проект новый бэкенд LLM — от класса провайдера до регистрации в конфигурации и фабрике. CX Codex +1 ★ 1 319звёзд репо scoring-checks Скилл scoring-checks добавляет детерминированные проверки качества конфигурации AI-агента. Оценивает структуру, наличие файлов и соответствие стандартам — без случайности и внешних запросов. CX Codex +1 ★ 1 319звёзд репо caliber-testing Скилл caliber-testing для Claude Code генерирует тесты Vitest с изоляцией переменных среды, моками через vi.hoisted и размещением файлов в каталогах __tests__. CX Codex +1 ★ 1 319звёзд репо

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

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