This skill should be used when you need AI debate with multiple perspectives, analyzing trade-offs, evaluating pros and cons, deep code analysis, or multi-model reasoning. Ideal for subjective decisions, architectural trade-offs, and complex problems requiring synthesis of different viewpoints. Complements opus-subagent for structured multi-step workflows.
/plugin marketplace add cmtkdot/xanbzs-toolkit/plugin install cmtkdot-xanbzs-toolkit@cmtkdot/xanbzs-toolkitThis skill inherits all available tools. When active, it can use any tool Claude has access to.
readme.mdreferences/api-reference.mdreferences/prompts.mdreferences/tool-configs.mdscripts/__init__.pyscripts/analyze.pyscripts/assist.pyscripts/check.pyscripts/claude_client.pyscripts/debate.pyscripts/debug.pyscripts/plan.pyscripts/sync_docs.pyscripts/think.pyworkflows/ai-debate.mdworkflows/code-review.mdworkflows/deep-code-analysis.mdStructured multi-model workflows for AI debates, deep analysis, and complex reasoning. Uses Claude Opus via OpenAI SDK wrapper.
| Situation | Use |
|---|---|
| Quick code review | opus-subagent |
| Debate with multiple perspectives | This skill (ai-debate) |
| Simple debugging | opus-subagent |
| Deep analysis with token budget | This skill (code-review/analyze) |
| Second opinion | Either |
| Multi-model synthesis | This skill |
| Setting | Value |
|---|---|
| Base URL | http://localhost:8000/v1 |
| API Key | my-super-secret-password-123 |
| Default Model | claude-opus-4-5 |
debate)review)analyze)think)debug)Multi-model debate using prompt chaining for stronger performance. Each step gets Claude's full attention.
cd .claude/skills/ai-opus-debate
uv run python3 -m scripts.debate --topic "JWT vs Session auth for mobile" --rounds 3
Prompt 1: Security Advocate
You are a Security Advocate. Argue for the most secure option.
<topic>{{TOPIC}}</topic>
Output your argument in <security_perspective> tags.
Prompt 2: Pragmatic Engineer (receives previous output)
Review the security perspective, then argue for practicality.
<security_perspective>{{SECURITY_OUTPUT}}</security_perspective>
<topic>{{TOPIC}}</topic>
Output your argument in <engineering_perspective> tags.
Prompt 3: UX Advocate (receives all previous)
Review both perspectives, then argue for user experience.
<security_perspective>{{SECURITY_OUTPUT}}</security_perspective>
<engineering_perspective>{{ENGINEERING_OUTPUT}}</engineering_perspective>
Output in <ux_perspective> tags.
Prompt 4: Synthesis (receives all perspectives)
Synthesize all perspectives into a final recommendation.
<security_perspective>{{SECURITY_OUTPUT}}</security_perspective>
<engineering_perspective>{{ENGINEERING_OUTPUT}}</engineering_perspective>
<ux_perspective>{{UX_OUTPUT}}</ux_perspective>
Grade each argument (A-F), identify the strongest points, and provide a clear recommendation.
Add a verification step after synthesis:
Prompt 5: Review
Review this recommendation for logical consistency and completeness.
<recommendation>{{SYNTHESIS}}</recommendation>
<original_topic>{{TOPIC}}</original_topic>
Identify any gaps, contradictions, or unconsidered trade-offs.
Prompt 6: Refine
Refine the recommendation based on this feedback.
<recommendation>{{SYNTHESIS}}</recommendation>
<feedback>{{REVIEW_OUTPUT}}</feedback>
Output the final, improved recommendation.
See workflows/ai-debate.md for full details.
Token-efficient structured code review.
# Using Python script
cd .claude/skills/ai-opus-debate
uv run python3 -m scripts.check --mode precommit --input "$(git diff HEAD~1)"
| Task | MCP Tool | Parameters |
|---|---|---|
| Semantic search | claude-context/search_code | query: "authentication middleware" |
| Database schema | postgres/list_tables | table_names: "users,sessions" |
| Symbol refs | plugin_serena_serena/find_referencing_symbols | symbol_name_path: "AuthMiddleware" |
See workflows/code-review.md for full details.
Comprehensive code analysis (architecture, security, performance).
cd .claude/skills/ai-opus-debate
uv run python3 -m scripts.analyze --files src/*.py --type security
| Task | MCP Tool | Parameters |
|---|---|---|
| Semantic code search | claude-context/search_code | query: "your search" |
| Database schema | postgres/list_tables | table_names: "table1,table2" |
| Symbol references | plugin_serena_serena/find_referencing_symbols | symbol_name_path: "Symbol" |
| Get symbol body | plugin_serena_serena/find_symbol | name_path_pattern: "Symbol", include_body: true |
| Web research | exa/web_search_exa | query: "search query" |
Tool Priority:
claude-context/search_code - Semantic discovery (preferred)plugin_serena_serena/* - Symbol navigation (specific code)postgres/* - Database context (only if DB involved)All scripts in scripts/ directory:
| Script | Purpose |
|---|---|
debate.py | Run AI debates |
analyze.py | Deep code analysis |
check.py | Pre-commit validation |
think.py | Deep reasoning |
debug.py | Systematic debugging |
plan.py | Strategic planning |
assist.py | Coding assistance |
cd .claude/skills/ai-opus-debate
# Install deps (once)
uv pip install openai
# Run scripts
uv run python3 -m scripts.debate --topic "Topic" --rounds 3
uv run python3 -m scripts.analyze --files src/*.py --type security
uv run python3 -m scripts.check --mode precommit --input "diff"
export CLAUDE_API_BASE_URL="http://localhost:8000/v1"
export PROXY_API_KEY="my-super-secret-password-123"
export CLAUDE_DEFAULT_MODEL="claude-opus-4-5"
SKILL.md - This referenceworkflows/ - Detailed workflow guides
ai-debate.md - Multi-model debatecode-review.md - Structured reviewdeep-code-analysis.md - Analysis workflowreferences/ - API and tool docsscripts/ - Python CLI scriptsThis skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.