/multi-ai-consultant

name: multi-ai-consultant
description: Consult external AIs (Gemini 2.5 Pro, OpenAI Codex, Claude) for second opinions. Use for debugging failures, architectural decisions, security validation, or need fresh perspective with synthesis.
license: MIT
allowed-tools: [Bash, Read, Task, Write]
metadata:
  version: 1.0.0
  author: Claude Skills Maintainers
  last-verified: 2025-11-07
  production-tested: true
  keywords:
    - ai consultation
    - second opinion
    - gemini
    - openai
    - codex
    - debugging
    - architecture
    - multi-ai
    - synthesis
    - fresh perspective
    - stuck
    - web research
    - thinking mode
    - repo-aware

Multi-AI Consultant

Consult external AIs for second opinions when Claude Code is stuck or making critical decisions.

---

What This Skill Does

This skill enables **future Claude Code sessions** to consult other AIs when:

• Stuck on a bug after one failed attempt
• Making architectural decisions
• Security concerns need validation
• Fresh perspective needed

**Key innovation**: Uses existing CLI tools (`gemini`, `codex`) instead of building MCP servers - much simpler and more maintainable.

---

When to Use This Skill

Automatic Triggers (No User Action Needed)

Claude Code should **automatically suggest** using this skill when:

1. **After 1 failed debugging attempt**

• Tried one approach to fix a bug
• Still not working or different error
• → Suggest: "Should I consult [Gemini|Fresh Claude] for a second opinion?"

2. **Before architectural decisions**

• Significant design choices (state management, routing, data flow)
• Framework selection
• Database schema design
• → Auto-consult (mention to user): "Consulting Gemini for architectural validation..."

3. **Security changes**

• Authentication logic
• Authorization rules
• Cryptography
• Input validation
• → Auto-consult: "Consulting Gemini to verify security approach..."

4. **When uncertain**

• Multiple valid approaches
• Trade-offs not clear
• Conflicting advice in documentation
• → Suggest: "Would you like me to consult another AI for additional perspective?"

Manual Invocation (User Commands)

User can explicitly request consultation with:

• `/consult-gemini [question]` - Gemini 2.5 Pro with thinking, search, grounding
• `/consult-codex [question]` - OpenAI GPT-4 via Codex CLI (repo-aware)
• `/consult-claude [question]` - Fresh Claude subagent (free, fast)
• `/consult-ai [question]` - Router that asks which AI to use

---

The Three AIs

| AI | Tool | When to Use | Special Features | Cost | |----|------|-------------|------------------|------| | **Gemini 2.5 Pro** | `gemini` CLI | Web research, latest docs, thinking | Google Search, extended reasoning, grounding | ~$0.10-0.50 | | **OpenAI GPT-4** | `codex` CLI | Repo-aware analysis, code review | Auto-scans directory, OpenAI reasoning | ~$0.05-0.30 | | **Fresh Claude** | Task tool | Quick second opinion, budget-friendly | Same capabilities, fresh perspective | Free |

**For detailed AI comparison**: Load `references/ai-strengths.md` when choosing which AI to consult for specific use cases.

---

How It Works

Architecture

Claude Code encounters bug/decision
        ↓
Suggests consultation (or user requests)
        ↓
User approves
        ↓
Execute appropriate slash command
        ↓
CLI command calls external AI
        ↓
Parse response
        ↓
Synthesize: Claude's analysis + External AI's analysis
        ↓
Present 5-part comparison
        ↓
Ask permission to implement

The 5-Part Synthesis Format

Every consultation must follow this format (prevents parroting):

1. **🤖 My Analysis** - Claude's original reasoning and attempts 2. **💎/🔷/🔄 Other AI's Analysis** - External AI's complete response 3. **🔍 Key Differences** - Agreement, divergence, what each AI caught/missed 4. **⚡ Synthesis** - Combined perspective, root cause, trade-offs 5. **✅ Recommended Action** - Specific next steps with file paths/line numbers

**End with**: "Should I proceed with this approach?"

---

Setup

**For complete installation guide**: Load `references/setup-guide.md` when installing CLIs, configuring API keys, or setting up templates.

**Quick setup**: 1. **Install CLIs**: `bun add -g @google/generative-ai-cli` (Gemini), `bun add -g codex` (Codex, optional) 2. **Set API keys**: `export GEMINI_API_KEY="..."`, `export OPENAI_API_KEY="..."` 3. **Install skill**: Symlink to `~/.claude/skills/multi-ai-consultant` 4. **Copy templates**: `GEMINI.md`, `codex.md`, `.geminiignore` to project root 5. **Verify**: `gemini -p "test"`, `codex exec - --yolo`

Get API keys:

• Gemini: https://aistudio.google.com/apikey
• OpenAI: https://platform.openai.com/api-keys

---

Usage

**For detailed examples**: Load `references/usage-examples.md` when learning consultation workflows or seeing real-world scenarios.

**Quick examples**:

• **Bug**: After 1 failed attempt → `/consult-gemini` for web-researched solution
• **Architecture**: Design decision → `/consult-gemini` for latest best practices
• **Code review**: Refactoring validation → `/consult-codex` for repo-aware consistency check
• **Quick opinion**: Sanity check → `/consult-claude` for free fresh perspective

**5 detailed examples available**: 1. JWT authentication bug (saved ~30 min, found platform-specific issue) 2. State management choice (informed decision with 2025 patterns) 3. Refactoring review (found 3 consistency issues) 4. Security validation (found 2 critical issues via OWASP 2025) 5. Multi-AI workflow (high-stakes database choice)

---

Slash Commands

**For complete command reference**: Load `references/commands-reference.md` when needing detailed syntax, options, or cost tracking information.

**Quick command overview**:

/consult-gemini [question]

• **Use**: Web research, latest docs, extended thinking
• **Features**: Google Search, grounding, thinking mode
• **Cost**: ~$0.10-0.50
• **Example*