latex-paper-skills: Skill for Codex

Collaborating with Gemini (Codex)

Use Gemini CLI as a breadth-exploration collaborator for paper-from-zero, or as a generic code collaborator in fallback mode.

This skill provides a lightweight bridge script that returns structured JSON and supports multi-turn sessions via SESSION_ID.

Shared rules: This skill inherits all shared rules from ../_shared/collaboration-base.md (core rules, candidates-only constraint, fallback code-collaboration mode, safety guardrails, and collaboration state capsule format). Only Gemini-specific additions are listed below.

When to Use

• paper-from-zero needs to expand the candidate literature pool.
• topic-brief initial draft exists but adjacent research areas are uncovered.
• contribution-map needs 3-5 alternative framing candidates.
• evidence-matrix has coverage gaps that need broader search directions.
• Fallback: generic code collaboration tasks (analysis, patch, review).

When NOT to Use

• Claim-level logical analysis or reviewer objection stress tests (use Claude).
• Final routing judgment between review/empirical (use Claude).
• Generating ref.bib entries or verified citations.
• Tasks requiring depth reasoning rather than breadth scanning.

Gemini-Specific Rules

• Optional: pass --sandbox to run Gemini in sandbox mode.
• Auth/home notes:
  • The bridge defaults GEMINI_CLI_HOME to a writable repo-local directory (<repo>/.gemini_cli_home/) to avoid Gemini CLI hanging in some runners.
  • If your local gemini is already logged in, reuse that login with --use-user-home.
  • If you have GEMINI_API_KEY set but want to use OAuth creds, add --prefer-oauth to unset API-key env vars for this run.

Quick Start (shell-safe)

If your prompt contains Markdown backticks, use a heredoc; see references/shell-quoting.md.

PROMPT="$(cat <<'EOF'
Review src/auth.py around login() and propose fixes.
OUTPUT: Unified Diff Patch ONLY.
EOF
)"
python3 .codex/skills/collaborating-with-gemini/scripts/gemini_bridge.py --cd "." --PROMPT "$PROMPT"