> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markapidown.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up agent support

> Install the skill, slash commands, and the MCP server for Claude Code, Cursor, Copilot, Codex CLI, Antigravity, OpenCode, and Windsurf.

Agent support turns a coding agent into an API-capable collaborator that can scan routes, enrich specs, build flows, and debug failures — all backed by reviewable markdown files in your repo.

<CardGroup cols={2}>
  <Card title="Skills" icon="book-open">
    A single markdown playbook that teaches agents the Reqbook spec format, file layout, and how to choose the right approach for each task. All agents get the skill.
  </Card>

  <Card title="Slash commands" icon="terminal">
    Two `/rqb` commands for Claude Code and Codex CLI: `/rqb` for creating, enriching, and building flows; `/rqb-debug` for diagnosing failures.
  </Card>

  <Card title="MCP server" icon="plug">
    Structured tools for MCP-compatible agents: exec, flow, author, surgical context, and more. Agents get typed results without parsing shell output.
  </Card>

  <Card title="Shared markdown source" icon="code-pull-request">
    Every agent change is a markdown file in `api-docs/`. Reviewable, diffable, committable. No hidden state.
  </Card>
</CardGroup>

***

## Install in one command

<Steps>
  <Step title="Install skill and slash commands">
    Run the installer from the root of your project. It auto-detects which agents are present and writes the correct files for each.

    ```bash theme={null}
    rqb skills install
    ```

    The command writes the skill and (for Claude Code / Codex CLI) slash commands to the directories each agent reads.
  </Step>

  <Step title="Verify">
    ```bash theme={null}
    rqb skills list
    ```

    Example output:

    ```
    claude-code detected .claude/skills/rqb/SKILL.md
                          .claude/commands/rqb.md
                          .claude/commands/rqb-debug.md
    cursor     detected   .cursor/rules/rqb.mdc
    copilot    detected   .github/instructions/rqb.instructions.md
    ```
  </Step>

  <Step title="Register the MCP server">
    The MCP server gives compatible agents structured access to spec execution, pipelines, context packs, and authoring — no terminal output parsing.

    ```bash theme={null}
    rqb install mcp
    ```

    To target one agent:

    ```bash theme={null}
    rqb install mcp --agent=codex-cli
    rqb install mcp --agent=cursor
    rqb install mcp --agent=copilot
    ```
  </Step>
</Steps>

<Tip>
  For token-sensitive agent runs, start with `rqb_context` using `mode: "surgical"`, `brief: true`, `max_fields: 6`, and an explicit `intent`. If an endpoint fails, call `rqb_diagnose` before reading backend source. Together they return the bounded contract, likely cause, inspect targets, and verify commands before the agent decides how much source inspection is necessary.
</Tip>

***

## Per-agent install

<CodeGroup>
  ```bash Claude Code theme={null}
  rqb skills install --agent=claude-code
  # Installs: 1 skill + 2 slash commands
  # Locations: .claude/skills/rqb/, .claude/commands/
  ```

  ```bash Codex CLI theme={null}
  rqb skills install --agent=codex-cli
  # Installs: 1 skill + 2 slash commands
  # Locations: .agents/skills/rqb/, ~/.codex/commands/
  ```

  ```bash Cursor theme={null}
  rqb skills install --agent=cursor
  # Installs: 1 skill as .mdc rule
  # Location: .cursor/rules/
  ```

  ```bash GitHub Copilot theme={null}
  rqb skills install --agent=copilot
  # Installs: 1 skill as .instructions.md
  # Location: .github/instructions/
  ```

  ```bash Antigravity theme={null}
  rqb skills install --agent=antigravity
  # Installs: 1 skill
  # Location: .agents/skills/
  ```

  ```bash OpenCode theme={null}
  rqb skills install --agent=opencode
  # Installs: 1 skill
  # Location: .opencode/skills/
  ```

  ```bash Windsurf theme={null}
  rqb skills install --agent=windsurf
  # Installs: 1 skill as a rule
  # Location: .windsurf/rules/
  ```
</CodeGroup>

### What each agent gets

| Agent          | Skills  | Slash commands | MCP |
| -------------- | ------- | -------------- | --- |
| Claude Code    | 1 skill | 2 commands     | ✓   |
| Codex CLI      | 1 skill | 2 commands     | ✓   |
| Cursor         | 1 skill |                | ✓   |
| GitHub Copilot | 1 skill |                | ✓   |
| Antigravity    | 1 skill |                | ✓   |
| OpenCode       | 1 skill |                | ✓   |
| Windsurf       | 1 skill |                | ✓   |

### MCP config locations

| Agent                     | Command                               | Config                                  |
| ------------------------- | ------------------------------------- | --------------------------------------- |
| Claude Code               | `rqb install mcp --agent=claude-code` | `.mcp.json`                             |
| Codex CLI / IDE           | `rqb install mcp --agent=codex-cli`   | `.codex/config.toml`                    |
| Cursor                    | `rqb install mcp --agent=cursor`      | `.cursor/mcp.json`                      |
| GitHub Copilot in VS Code | `rqb install mcp --agent=copilot`     | `.vscode/mcp.json`                      |
| OpenCode                  | `rqb install mcp --agent=opencode`    | `opencode.json`                         |
| Antigravity               | `rqb install mcp --agent=antigravity` | `~/.gemini/antigravity/mcp_config.json` |
| Windsurf / Cascade        | `rqb install mcp --agent=windsurf`    | `~/.codeium/windsurf/mcp_config.json`   |

***

## Keep skills current

After upgrading Reqbook, check whether installed skills match the current binary:

```bash theme={null}
rqb doctor
```

To update stale skills automatically:

```bash theme={null}
rqb doctor --fix
```

<Warning>
  Stale skills are the most common cause of agents missing new commands or writing files in unexpected ways. Run `rqb doctor --fix` after every Reqbook upgrade.
</Warning>