Skip to content

appautomaton/latex-arxiv-SKILL / .codex/skills/collaborating-with-gemini

collaborating-with-gemini

Verified

Use the Gemini CLI to consult Gemini and delegate coding tasks for prototyping, debugging, and code review. Supports multi-turn sessions via SESSION_ID. Optimized for low-token, file/line-based handoff.

FileKindSize
SKILL.mdskill md4.5 KB
assets/prompt-template.mdmarkdown1.2 KB
references/shell-quoting.mdmarkdown1.2 KB
scripts/gemini_bridge.pyscript7.0 KB

references/shell-quoting.md

View on GitHub
# Shell quoting for `--PROMPT`

When invoking `gemini_bridge.py`, be careful: your *shell* parses the command line before Python runs.

## The pitfall: Markdown backticks

Markdown inline code uses backticks (`` `like/this` ``). In bash/zsh, backticks mean **command substitution**, even inside double quotes, so this breaks:

```bash
python3 .codex/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
  --cd "." \
  --PROMPT "Analyze `tmp/eth_dev_news_raw.json` and summarize."
```

Typical symptoms (from the shell, before Gemini runs):

- `zsh: permission denied: tmp/eth_dev_news_raw.json`
- `zsh: command not found: as_of`

## Recommended: heredoc (no expansion)

Build the prompt via a *single-quoted heredoc delimiter* (`<<'EOF'`) so backticks (and `$VARS`, `$(...)`, etc.) are not expanded by the shell:

```bash
PROMPT="$(cat <<'EOF'
Analyze `tmp/eth_dev_news_raw.json` and summarize.
Set `as_of` to `YYYY-MM-DD`.
EOF
)"

python3 .codex/skills/collaborating-with-gemini/scripts/gemini_bridge.py \
  --cd "." \
  --PROMPT "$PROMPT"
```

## Alternatives

- Escape backticks manually: use `\`` (easy to miss in long prompts).
- Avoid backticks entirely: write `Analyze the file tmp/eth_dev_news_raw.json` instead.

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall