second-opinion-help git:20260708.e42b71fB

Immutable. This exact content is served forever at /api/v1/blob/ff38cdc129b92cac.

---
name: "second-opinion-help"
description: "Overview of Second Opinion commands"
---
<!-- GENERATED by claude-power-pack - scripts/codex-skill-sync.py; edit .claude/commands/second-opinion/help.md instead -->

## Codex harness adaptations

Generated from a Claude Code command. Where the procedure references these Claude-only surfaces, adapt as follows:

- MCP tools: use the MCP servers configured in `~/.codex/config.toml`, or fall back to the referenced repo scripts and CLI entry points.

# Second Opinion Commands

Commands for AI-powered code review using multiple LLM models.

## Available Commands

| Command | Description |
|---------|-------------|
| `/second-opinion-start` | Quick review with sensible defaults (file + model + depth) |
| `/second-opinion-models` | Interactive model and depth selection with menus |
| `/second-opinion-help` | This help overview |

## Quick Usage

```bash
# Interactive model selection
/second-opinion-models

# Review specific code
/second-opinion-models "review my auth middleware"
```

## Available Models

| Key | Model | Provider | Best For |
|-----|-------|----------|----------|
| `gemini-3-pro` | Gemini 3.1 Pro | Google | Comprehensive analysis |
| `gemini-2.5-pro` | Gemini 2.5 Pro | Google | Stable, proven |
| `claude-sonnet` | Claude Sonnet 4.6 | Anthropic | Fast, excellent for code review |
| `claude-haiku` | Claude Haiku 4.5 | Anthropic | Fastest Claude, cost-effective |
| `claude-opus` | Claude Opus 4.6 | Anthropic | Most capable Claude |
| `codex` | GPT-5.3 Codex | OpenAI | Default coding model |
| `codex-mini` | GPT-5.2 Codex | OpenAI | Cost-effective coding |
| `o4-mini` | o4-mini | OpenAI | Fast reasoning |
| `o3` | o3 | OpenAI | Advanced reasoning |
| `gpt-5.2` | GPT-5.2 | OpenAI | Latest GPT |
| `gpt-4o` | GPT-4o | OpenAI | Fast multimodal |

## Direct MCP Tool Usage

You can also invoke the MCP tools directly without commands:

- `get_code_second_opinion` - Single-model review (Gemini default)
- `get_multi_model_second_opinion` - Multi-model parallel review
- `list_available_models` - Check which models are configured
- `create_session` / `consult` - Multi-turn conversations

## Requirements

- The external Second Opinion server running: clone and start `cooneycw/mcp-second-opinion`.
- This project's root `.mcp.json` pointing at it: the `second-opinion` entry is a streamable-http server at `http://127.0.0.1:8080/mcp` (localhost) or a Tailscale URL (remote host).
- At least one API key configured on the server side (GEMINI_API_KEY, OPENAI_API_KEY, or ANTHROPIC_API_KEY). All three recommended for cross-provider comparison.

## Troubleshooting

**Error `-32602: Invalid request parameters`** usually means the server isn't running or the root `.mcp.json` is not pointing at it, not that parameters are wrong.

**Fix:** Make sure the external server is up and `.mcp.json` targets it:

1. Start the external server from the `cooneycw/mcp-second-opinion` checkout (see that repo's README).
2. Confirm this project's root `.mcp.json` registers `second-opinion` as a streamable-http server at the right URL (`http://127.0.0.1:8080/mcp` for localhost, or your Tailscale URL for a remote host).
3. Reload MCP servers in Claude Code (or restart the session) so the updated `.mcp.json` is picked up.